tdecollab 0.3.5 → 0.3.6

package/README.md

@@ -2,7 +2,7 @@
 
 Confluence, JIRA, GitLab을 하나의 CLI / TUI / MCP 서버로 통합 제공하는 도구.
 
-터미널에서 직접 사용하거나, AI 에이전트(Claude Desktop 등)와 연동하여 사용할 수 있습니다.
+터미널에서 직접 사용하거나, AI 에이전트(Claude Desktop 등)와 연동하여 사용할 수 있습니다. 또한 Obsidian 플러그인을 통해 마크다운 노트를 Confluence와 양방향으로 연동할 수 있습니다.
 
 ## 지원 서비스
 
@@ -12,31 +12,44 @@ Confluence, JIRA, GitLab을 하나의 CLI / TUI / MCP 서버로 통합 제공하
 | **JIRA** | 이슈 CRUD, JQL 검색, 상태 변경(트랜지션), 코멘트 관리, 프로젝트/보드 조회 |
 | **GitLab** | 프로젝트 조회, MR 관리, 파이프라인 조회, 브랜치 관리, 파일 조회 |
 
-## Obsidian 플러그인
+---
+
+## 1. Obsidian 플러그인
 
 현재 활성화된 마크다운 노트를 Confluence 페이지로 업로드하거나, 반대로 다운로드할 수 있는 Obsidian 플러그인을 제공합니다.
 
-### 설치 (BRAT)
+### 설치 방법 (BRAT)
 1. Obsidian에서 **BRAT** 플러그인을 먼저 설치 및 활성화합니다.
 2. `BRAT: Add a beta plugin for testing` 명령을 실행합니다.
 3. **`goodjoon/tdecollab_public`** 주소를 입력하여 설치합니다.
 4. 설정에서 **TDE Collab Confluence**를 활성화합니다.
 
-## 요구사항
+### 사용법
+- Obsidian의 명령어 팔레트(`Cmd/Ctrl + P`)를 열어 `TDE Collab`을 검색합니다.
+- **Upload to Confluence**: 현재 열려있는 마크다운 노트를 Confluence 페이지로 업로드합니다.
+- **Download from Confluence**: Confluence 페이지를 가져와 현재 마크다운 노트로 다운로드합니다.
+
+---
+
+## 2. CLI / TUI 및 MCP 서버
+
+터미널에서 직접 실행하거나 Claude Desktop 등의 MCP 클라이언트와 연동할 수 있는 Node.js 기반 도구입니다.
+
+### 요구사항
 
 - Node.js 20 이상
 
-## 설치
+### 설치 방법
 
 ```bash
-# 전역 설치
+# 전역 설치 (CLI/TUI 사용 시 권장)
 npm install -g tdecollab
 
 # 또는 npx로 즉시 실행 (설치 불필요)
 npx -y tdecollab --help
 ```
 
-## 설정
+### 환경변수 설정
 
 각 서비스 접속에 필요한 환경변수:
 
@@ -66,10 +79,11 @@ GITLAB_PRIVATE_TOKEN=your-private-token
 
 상위 우선순위에 이미 설정된 값은 하위 설정 파일 값으로 덮어쓰지 않습니다.
 
-## 사용법
+### 사용법
+
+#### TUI (Terminal UI) 모드
 
-### TUI (Terminal UI) 모드
-![[img_20260429004932.png]]
+![](tdecollab-docs/assets/Monosnap%20tdecollab%202026-05-03%2014-21-27.png)
 
 인자 없이 실행하면 인터랙티브 TUI가 시작됩니다 — 메뉴 탐색, 폼 입력, 실시간 결과 확인이 한 화면에서 가능합니다.
 
@@ -89,9 +103,9 @@ tdecollab
 
 마지막 사용값은 `.tdecollab.json`에, 명령 히스토리는 `~/.tdecollab_history.json`에 자동 저장됩니다.
 
-### CLI 명령어
+#### CLI 명령어
 
-#### Confluence
+##### Confluence
 
 ```bash
 # 스페이스 목록
@@ -105,7 +119,7 @@ tdecollab confluence page create --space <key> --title <title> --file <path_to_m
 tdecollab confluence page update <pageId> --file <path_to_md>
 ```
 
-#### JIRA / GitLab
+##### JIRA / GitLab
 
 ```bash
 tdecollab jira issue get PROJ-1234
@@ -115,16 +129,16 @@ tdecollab gitlab mr list <projectId> -s opened
 
 `tdecollab <service> --help` 또는 `tdecollab <service> <command> --help`로 모든 옵션을 확인할 수 있습니다.
 
-## MCP 서버 (Claude Desktop 연동)
+### MCP 서버 연동 (Claude Desktop)
 
 Claude Desktop에서 Confluence, JIRA, GitLab 도구를 사용할 수 있습니다.
 
-### 설정 파일 위치
+#### 설정 파일 위치
 
 - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
 - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
 
-### npx 사용 (권장 — 별도 설치 불필요)
+#### npx 사용 (권장 — 별도 설치 불필요)
 
 ```json
 {
@@ -146,7 +160,7 @@ Claude Desktop에서 Confluence, JIRA, GitLab 도구를 사용할 수 있습니
 }
 ```
 
-### 전역 설치 후 사용
+#### 전역 설치 후 사용
 
 ```bash
 npm install -g tdecollab
@@ -173,7 +187,7 @@ npm install -g tdecollab
 
 설정 후 Claude Desktop을 재시작하면 도구가 활성화됩니다.
 
-### 제공 MCP 도구
+#### 제공하는 MCP 도구
 
 | 서비스 | 도구 |
 |---|---|
@@ -183,6 +197,8 @@ npm install -g tdecollab
 
 자세한 도구별 파라미터는 Claude Desktop의 MCP 도구 검색 UI 또는 `tdecollab mcp` 실행 시 stderr 로그를 참조하세요.
 
+---
+
 ## 라이선스
 
-[MIT](LICENSE)
+[MIT](LICENSE)

package/dist/{chunk-5IY42AV6.js → chunk-6GCKWJJ7.js}

@@ -24,10 +24,10 @@ import {
   loadGitlabConfig,
   loadJiraConfig,
   tryBuildJiraIssueMap
-} from "./chunk-JUM5ZG64.js";
+} from "./chunk-SIKUIQKX.js";
 import {
   logger
-} from "./chunk-6RIA6AJ3.js";
+} from "./chunk-IFYMZLQI.js";
 
 // tools/mcp/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -138,7 +138,7 @@ function registerConfluenceTools(server) {
         if (page.body?.storage?.value) {
           let imageUrlMap;
           if (downloadImages) {
-            const { ImageDownloader } = await import("./image-downloader-AKNR5YKJ.js");
+            const { ImageDownloader } = await import("./image-downloader-VKPGS3TY.js");
             const downloader = new ImageDownloader(contentApi, {
               outputDir: imageDir || "./images",
               pageId: page.id,
@@ -1107,4 +1107,4 @@ async function runServer() {
 export {
   runServer
 };
-//# sourceMappingURL=chunk-5IY42AV6.js.map
+//# sourceMappingURL=chunk-6GCKWJJ7.js.map

package/dist/{chunk-6RIA6AJ3.js → chunk-IFYMZLQI.js}

@@ -1,10 +1,3 @@
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-
 // tools/common/logger.ts
 var Logger = class {
   level = "info";
@@ -75,7 +68,6 @@ var Logger = class {
 var logger = new Logger();
 
 export {
-  __require,
   logger
 };
-//# sourceMappingURL=chunk-6RIA6AJ3.js.map
+//# sourceMappingURL=chunk-IFYMZLQI.js.map

package/dist/{chunk-6RIA6AJ3.js.map → chunk-IFYMZLQI.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../tools/common/logger.ts"],"sourcesContent":["export type LogLevel = 'debug' | 'info' | 'warn' | 'error';\n\nclass Logger {\n    private level: LogLevel = 'info';\n\n    constructor() {\n        this.level = (process.env.LOG_LEVEL as LogLevel) || 'info';\n    }\n\n    // 로그 레벨 설정\n    setLevel(level: LogLevel) {\n        this.level = level;\n    }\n\n    // 로그 메시지 포맷팅 (타임스탬프, 레벨 포함)\n    private formatMessage(level: LogLevel, message: string, ...args: any[]): string {\n        const timestamp = new Date().toISOString();\n        let formattedMessage = `[${timestamp}] [${level.toUpperCase()}] ${message}`;\n\n        if (args.length > 0) {\n            formattedMessage += ' ' + args.map(arg => {\n                if (arg instanceof Error) {\n                    return arg.stack || arg.message;\n                }\n                return typeof arg === 'object' ? JSON.stringify(arg, null, 2) : String(arg);\n            }).join(' ');\n        }\n\n        // 민감 정보 마스킹 (토큰, 비밀번호 등)\n        formattedMessage = this.maskSensitiveData(formattedMessage);\n\n        return formattedMessage;\n    }\n\n    // 민감한 데이터(키, 패스워드 등) 마스킹 처리\n    private maskSensitiveData(text: string): string {\n        // 1. Authorization 헤더 마스킹 (Basic ***, Bearer ***)\n        let masked = text.replace(/(Authorization[\"']?\\s*[:=]\\s*[\"']?)(Basic|Bearer)\\s+([^\"'\\s]+)([\"']?)/gi, (match, p1, p2, p3, p4) => {\n            const maskedToken = p3.length > 8 ? p3.substring(0, 4) + '...' + p3.substring(p3.length - 4) : '******';\n            return `${p1}${p2} ${maskedToken}${p4}`;\n        });\n\n        // 2. 키워드 기반 마스킹 (token, password, secret, key 등)\n        // 헤더 이름(PRIVATE-TOKEN 등)과 변수명 모두 대응 가능하도록 개선\n        masked = masked.replace(/((?:token|password|secret|key|api_token|private_token)[\"']?\\s*[:=]\\s*[\"']?)([^\"'\\s]+)([\"']?)/gi, (match, p1, p2, p3) => {\n            const maskedValue = p2.length > 8 ? p2.substring(0, 4) + '...' + p2.substring(p2.length - 4) : '******';\n            return `${p1}${maskedValue}${p3}`;\n        });\n\n        return masked;\n    }\n\n    // Debug 레벨 로그 출력\n    debug(message: string, ...args: any[]) {\n        if (this.shouldLog('debug')) {\n            console.error(this.formatMessage('debug', message, ...args));\n        }\n    }\n\n    // Info 레벨 로그 출력\n    info(message: string, ...args: any[]) {\n        if (this.shouldLog('info')) {\n            console.error(this.formatMessage('info', message, ...args));\n        }\n    }\n\n    // Warn 레벨 로그 출력\n    warn(message: string, ...args: any[]) {\n        if (this.shouldLog('warn')) {\n            console.error(this.formatMessage('warn', message, ...args));\n        }\n    }\n\n    // Error 레벨 로그 출력\n    error(message: string, ...args: any[]) {\n        if (this.shouldLog('error')) {\n            console.error(this.formatMessage('error', message, ...args));\n        }\n    }\n\n    // 현재 설정된 로그 레벨에 따라 출력 여부 결정\n    private shouldLog(level: LogLevel): boolean {\n        const levels: LogLevel[] = ['debug', 'info', 'warn', 'error'];\n        return levels.indexOf(level) >= levels.indexOf(this.level);\n    }\n}\n\nexport const logger = new Logger();\n"],"mappings":";;;;;;;;AAEA,IAAM,SAAN,MAAa;AAAA,EACD,QAAkB;AAAA,EAE1B,cAAc;AACV,SAAK,QAAS,QAAQ,IAAI,aAA0B;AAAA,EACxD;AAAA;AAAA,EAGA,SAAS,OAAiB;AACtB,SAAK,QAAQ;AAAA,EACjB;AAAA;AAAA,EAGQ,cAAc,OAAiB,YAAoB,MAAqB;AAC5E,UAAM,aAAY,oBAAI,KAAK,GAAE,YAAY;AACzC,QAAI,mBAAmB,IAAI,SAAS,MAAM,MAAM,YAAY,CAAC,KAAK,OAAO;AAEzE,QAAI,KAAK,SAAS,GAAG;AACjB,0BAAoB,MAAM,KAAK,IAAI,SAAO;AACtC,YAAI,eAAe,OAAO;AACtB,iBAAO,IAAI,SAAS,IAAI;AAAA,QAC5B;AACA,eAAO,OAAO,QAAQ,WAAW,KAAK,UAAU,KAAK,MAAM,CAAC,IAAI,OAAO,GAAG;AAAA,MAC9E,CAAC,EAAE,KAAK,GAAG;AAAA,IACf;AAGA,uBAAmB,KAAK,kBAAkB,gBAAgB;AAE1D,WAAO;AAAA,EACX;AAAA;AAAA,EAGQ,kBAAkB,MAAsB;AAE5C,QAAI,SAAS,KAAK,QAAQ,2EAA2E,CAAC,OAAO,IAAI,IAAI,IAAI,OAAO;AAC5H,YAAM,cAAc,GAAG,SAAS,IAAI,GAAG,UAAU,GAAG,CAAC,IAAI,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC,IAAI;AAC/F,aAAO,GAAG,EAAE,GAAG,EAAE,IAAI,WAAW,GAAG,EAAE;AAAA,IACzC,CAAC;AAID,aAAS,OAAO,QAAQ,kGAAkG,CAAC,OAAO,IAAI,IAAI,OAAO;AAC7I,YAAM,cAAc,GAAG,SAAS,IAAI,GAAG,UAAU,GAAG,CAAC,IAAI,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC,IAAI;AAC/F,aAAO,GAAG,EAAE,GAAG,WAAW,GAAG,EAAE;AAAA,IACnC,CAAC;AAED,WAAO;AAAA,EACX;AAAA;AAAA,EAGA,MAAM,YAAoB,MAAa;AACnC,QAAI,KAAK,UAAU,OAAO,GAAG;AACzB,cAAQ,MAAM,KAAK,cAAc,SAAS,SAAS,GAAG,IAAI,CAAC;AAAA,IAC/D;AAAA,EACJ;AAAA;AAAA,EAGA,KAAK,YAAoB,MAAa;AAClC,QAAI,KAAK,UAAU,MAAM,GAAG;AACxB,cAAQ,MAAM,KAAK,cAAc,QAAQ,SAAS,GAAG,IAAI,CAAC;AAAA,IAC9D;AAAA,EACJ;AAAA;AAAA,EAGA,KAAK,YAAoB,MAAa;AAClC,QAAI,KAAK,UAAU,MAAM,GAAG;AACxB,cAAQ,MAAM,KAAK,cAAc,QAAQ,SAAS,GAAG,IAAI,CAAC;AAAA,IAC9D;AAAA,EACJ;AAAA;AAAA,EAGA,MAAM,YAAoB,MAAa;AACnC,QAAI,KAAK,UAAU,OAAO,GAAG;AACzB,cAAQ,MAAM,KAAK,cAAc,SAAS,SAAS,GAAG,IAAI,CAAC;AAAA,IAC/D;AAAA,EACJ;AAAA;AAAA,EAGQ,UAAU,OAA0B;AACxC,UAAM,SAAqB,CAAC,SAAS,QAAQ,QAAQ,OAAO;AAC5D,WAAO,OAAO,QAAQ,KAAK,KAAK,OAAO,QAAQ,KAAK,KAAK;AAAA,EAC7D;AACJ;AAEO,IAAM,SAAS,IAAI,OAAO;","names":[]}
+{"version":3,"sources":["../tools/common/logger.ts"],"sourcesContent":["export type LogLevel = 'debug' | 'info' | 'warn' | 'error';\n\nclass Logger {\n    private level: LogLevel = 'info';\n\n    constructor() {\n        this.level = (process.env.LOG_LEVEL as LogLevel) || 'info';\n    }\n\n    // 로그 레벨 설정\n    setLevel(level: LogLevel) {\n        this.level = level;\n    }\n\n    // 로그 메시지 포맷팅 (타임스탬프, 레벨 포함)\n    private formatMessage(level: LogLevel, message: string, ...args: any[]): string {\n        const timestamp = new Date().toISOString();\n        let formattedMessage = `[${timestamp}] [${level.toUpperCase()}] ${message}`;\n\n        if (args.length > 0) {\n            formattedMessage += ' ' + args.map(arg => {\n                if (arg instanceof Error) {\n                    return arg.stack || arg.message;\n                }\n                return typeof arg === 'object' ? JSON.stringify(arg, null, 2) : String(arg);\n            }).join(' ');\n        }\n\n        // 민감 정보 마스킹 (토큰, 비밀번호 등)\n        formattedMessage = this.maskSensitiveData(formattedMessage);\n\n        return formattedMessage;\n    }\n\n    // 민감한 데이터(키, 패스워드 등) 마스킹 처리\n    private maskSensitiveData(text: string): string {\n        // 1. Authorization 헤더 마스킹 (Basic ***, Bearer ***)\n        let masked = text.replace(/(Authorization[\"']?\\s*[:=]\\s*[\"']?)(Basic|Bearer)\\s+([^\"'\\s]+)([\"']?)/gi, (match, p1, p2, p3, p4) => {\n            const maskedToken = p3.length > 8 ? p3.substring(0, 4) + '...' + p3.substring(p3.length - 4) : '******';\n            return `${p1}${p2} ${maskedToken}${p4}`;\n        });\n\n        // 2. 키워드 기반 마스킹 (token, password, secret, key 등)\n        // 헤더 이름(PRIVATE-TOKEN 등)과 변수명 모두 대응 가능하도록 개선\n        masked = masked.replace(/((?:token|password|secret|key|api_token|private_token)[\"']?\\s*[:=]\\s*[\"']?)([^\"'\\s]+)([\"']?)/gi, (match, p1, p2, p3) => {\n            const maskedValue = p2.length > 8 ? p2.substring(0, 4) + '...' + p2.substring(p2.length - 4) : '******';\n            return `${p1}${maskedValue}${p3}`;\n        });\n\n        return masked;\n    }\n\n    // Debug 레벨 로그 출력\n    debug(message: string, ...args: any[]) {\n        if (this.shouldLog('debug')) {\n            console.error(this.formatMessage('debug', message, ...args));\n        }\n    }\n\n    // Info 레벨 로그 출력\n    info(message: string, ...args: any[]) {\n        if (this.shouldLog('info')) {\n            console.error(this.formatMessage('info', message, ...args));\n        }\n    }\n\n    // Warn 레벨 로그 출력\n    warn(message: string, ...args: any[]) {\n        if (this.shouldLog('warn')) {\n            console.error(this.formatMessage('warn', message, ...args));\n        }\n    }\n\n    // Error 레벨 로그 출력\n    error(message: string, ...args: any[]) {\n        if (this.shouldLog('error')) {\n            console.error(this.formatMessage('error', message, ...args));\n        }\n    }\n\n    // 현재 설정된 로그 레벨에 따라 출력 여부 결정\n    private shouldLog(level: LogLevel): boolean {\n        const levels: LogLevel[] = ['debug', 'info', 'warn', 'error'];\n        return levels.indexOf(level) >= levels.indexOf(this.level);\n    }\n}\n\nexport const logger = new Logger();\n"],"mappings":";AAEA,IAAM,SAAN,MAAa;AAAA,EACD,QAAkB;AAAA,EAE1B,cAAc;AACV,SAAK,QAAS,QAAQ,IAAI,aAA0B;AAAA,EACxD;AAAA;AAAA,EAGA,SAAS,OAAiB;AACtB,SAAK,QAAQ;AAAA,EACjB;AAAA;AAAA,EAGQ,cAAc,OAAiB,YAAoB,MAAqB;AAC5E,UAAM,aAAY,oBAAI,KAAK,GAAE,YAAY;AACzC,QAAI,mBAAmB,IAAI,SAAS,MAAM,MAAM,YAAY,CAAC,KAAK,OAAO;AAEzE,QAAI,KAAK,SAAS,GAAG;AACjB,0BAAoB,MAAM,KAAK,IAAI,SAAO;AACtC,YAAI,eAAe,OAAO;AACtB,iBAAO,IAAI,SAAS,IAAI;AAAA,QAC5B;AACA,eAAO,OAAO,QAAQ,WAAW,KAAK,UAAU,KAAK,MAAM,CAAC,IAAI,OAAO,GAAG;AAAA,MAC9E,CAAC,EAAE,KAAK,GAAG;AAAA,IACf;AAGA,uBAAmB,KAAK,kBAAkB,gBAAgB;AAE1D,WAAO;AAAA,EACX;AAAA;AAAA,EAGQ,kBAAkB,MAAsB;AAE5C,QAAI,SAAS,KAAK,QAAQ,2EAA2E,CAAC,OAAO,IAAI,IAAI,IAAI,OAAO;AAC5H,YAAM,cAAc,GAAG,SAAS,IAAI,GAAG,UAAU,GAAG,CAAC,IAAI,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC,IAAI;AAC/F,aAAO,GAAG,EAAE,GAAG,EAAE,IAAI,WAAW,GAAG,EAAE;AAAA,IACzC,CAAC;AAID,aAAS,OAAO,QAAQ,kGAAkG,CAAC,OAAO,IAAI,IAAI,OAAO;AAC7I,YAAM,cAAc,GAAG,SAAS,IAAI,GAAG,UAAU,GAAG,CAAC,IAAI,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC,IAAI;AAC/F,aAAO,GAAG,EAAE,GAAG,WAAW,GAAG,EAAE;AAAA,IACnC,CAAC;AAED,WAAO;AAAA,EACX;AAAA;AAAA,EAGA,MAAM,YAAoB,MAAa;AACnC,QAAI,KAAK,UAAU,OAAO,GAAG;AACzB,cAAQ,MAAM,KAAK,cAAc,SAAS,SAAS,GAAG,IAAI,CAAC;AAAA,IAC/D;AAAA,EACJ;AAAA;AAAA,EAGA,KAAK,YAAoB,MAAa;AAClC,QAAI,KAAK,UAAU,MAAM,GAAG;AACxB,cAAQ,MAAM,KAAK,cAAc,QAAQ,SAAS,GAAG,IAAI,CAAC;AAAA,IAC9D;AAAA,EACJ;AAAA;AAAA,EAGA,KAAK,YAAoB,MAAa;AAClC,QAAI,KAAK,UAAU,MAAM,GAAG;AACxB,cAAQ,MAAM,KAAK,cAAc,QAAQ,SAAS,GAAG,IAAI,CAAC;AAAA,IAC9D;AAAA,EACJ;AAAA;AAAA,EAGA,MAAM,YAAoB,MAAa;AACnC,QAAI,KAAK,UAAU,OAAO,GAAG;AACzB,cAAQ,MAAM,KAAK,cAAc,SAAS,SAAS,GAAG,IAAI,CAAC;AAAA,IAC/D;AAAA,EACJ;AAAA;AAAA,EAGQ,UAAU,OAA0B;AACxC,UAAM,SAAqB,CAAC,SAAS,QAAQ,QAAQ,OAAO;AAC5D,WAAO,OAAO,QAAQ,KAAK,KAAK,OAAO,QAAQ,KAAK,KAAK;AAAA,EAC7D;AACJ;AAEO,IAAM,SAAS,IAAI,OAAO;","names":[]}

package/dist/{chunk-R4YTIP7E.js → chunk-JBDK5WP3.js}

@@ -1,6 +1,6 @@
 import {
   logger
-} from "./chunk-6RIA6AJ3.js";
+} from "./chunk-IFYMZLQI.js";
 
 // tools/confluence/utils/image-downloader.ts
 import fs from "fs";
@@ -122,4 +122,4 @@ var ImageDownloader = class {
 export {
   ImageDownloader
 };
-//# sourceMappingURL=chunk-R4YTIP7E.js.map
+//# sourceMappingURL=chunk-JBDK5WP3.js.map