relayax-cli 0.2.14 → 0.2.18

package/dist/commands/changelog.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerChangelog(program: Command): void;

package/dist/commands/changelog.js

@@ -0,0 +1,67 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerChangelog = registerChangelog;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
+function registerChangelog(program) {
+    const changelog = program
+        .command('changelog')
+        .description('팀 패키지의 changelog를 관리합니다');
+    changelog
+        .command('add')
+        .description('relay.yaml에 changelog 엔트리를 추가합니다')
+        .argument('[message]', 'changelog 메시지 (없으면 에디터에서 입력)')
+        .action(async (message) => {
+        const yamlPath = path_1.default.resolve('relay.yaml');
+        if (!fs_1.default.existsSync(yamlPath)) {
+            console.error('relay.yaml을 찾을 수 없습니다. 팀 패키지 디렉토리에서 실행하세요.');
+            process.exit(1);
+        }
+        const content = fs_1.default.readFileSync(yamlPath, 'utf-8');
+        const doc = js_yaml_1.default.load(content) ?? {};
+        if (!message) {
+            // Read from stdin if piped, otherwise prompt
+            const readline = await import('readline');
+            const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+            message = await new Promise((resolve) => {
+                rl.question('Changelog 메시지: ', (answer) => {
+                    rl.close();
+                    resolve(answer);
+                });
+            });
+        }
+        if (!message || message.trim() === '') {
+            console.error('changelog 메시지가 비어있습니다.');
+            process.exit(1);
+        }
+        const version = String(doc.version ?? '1.0.0');
+        const date = new Date().toISOString().split('T')[0];
+        const entry = `## v${version} (${date})\n\n- ${message.trim()}`;
+        const existing = doc.changelog ? String(doc.changelog) : '';
+        doc.changelog = existing ? `${entry}\n\n${existing}` : entry;
+        fs_1.default.writeFileSync(yamlPath, js_yaml_1.default.dump(doc, { lineWidth: -1, noRefs: true }), 'utf-8');
+        console.log(`\x1b[32m✓\x1b[0m changelog 추가됨 (v${version})`);
+        console.log(`  ${message.trim()}`);
+    });
+    changelog
+        .command('show')
+        .description('현재 relay.yaml의 changelog를 표시합니다')
+        .action(() => {
+        const yamlPath = path_1.default.resolve('relay.yaml');
+        if (!fs_1.default.existsSync(yamlPath)) {
+            console.error('relay.yaml을 찾을 수 없습니다.');
+            process.exit(1);
+        }
+        const content = fs_1.default.readFileSync(yamlPath, 'utf-8');
+        const doc = js_yaml_1.default.load(content) ?? {};
+        if (!doc.changelog) {
+            console.log('changelog가 없습니다. `relay changelog add "메시지"`로 추가하세요.');
+            return;
+        }
+        console.log(String(doc.changelog));
+    });
+}

package/dist/commands/publish.js

@@ -11,6 +11,7 @@ const js_yaml_1 = __importDefault(require("js-yaml"));
 const tar_1 = require("tar");
 const config_js_1 = require("../lib/config.js");
 const contact_format_js_1 = require("../lib/contact-format.js");
+const preamble_js_1 = require("../lib/preamble.js");
 const version_check_js_1 = require("../lib/version-check.js");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const cliPkg = require('../../package.json');
@@ -104,6 +105,118 @@ function detectCommands(teamDir) {
     }
     return entries;
 }
+function detectSkills(teamDir) {
+    const skillsDir = path_1.default.join(teamDir, 'skills');
+    if (!fs_1.default.existsSync(skillsDir))
+        return [];
+    const entries = [];
+    for (const entry of fs_1.default.readdirSync(skillsDir, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        const skillMd = path_1.default.join(skillsDir, entry.name, 'SKILL.md');
+        if (!fs_1.default.existsSync(skillMd))
+            continue;
+        let description = entry.name;
+        try {
+            const content = fs_1.default.readFileSync(skillMd, 'utf-8');
+            const m = content.match(/^---\n[\s\S]*?description:\s*[|>]?\s*\n?\s*(.+)\n[\s\S]*?---/m)
+                ?? content.match(/^---\n[\s\S]*?description:\s*(.+)\n[\s\S]*?---/m);
+            if (m)
+                description = m[1].trim();
+        }
+        catch {
+            // ignore
+        }
+        entries.push({ name: entry.name, description });
+    }
+    return entries;
+}
+function generateRootSkillMd(config, commands, skills, scopedSlug) {
+    const lines = [];
+    // Frontmatter
+    lines.push('---');
+    lines.push(`name: ${config.name}`);
+    lines.push(`description: ${config.description}`);
+    lines.push('---');
+    lines.push('');
+    // Preamble
+    lines.push((0, preamble_js_1.generatePreamble)(scopedSlug));
+    lines.push('');
+    // Skills
+    if (skills.length > 0) {
+        lines.push('## 포함된 스킬');
+        lines.push('');
+        for (const s of skills) {
+            lines.push(`- **${s.name}**: ${s.description}`);
+        }
+        lines.push('');
+    }
+    // Commands
+    if (commands.length > 0) {
+        lines.push('## 포함된 커맨드');
+        lines.push('');
+        for (const c of commands) {
+            lines.push(`- **/${c.name}**: ${c.description}`);
+        }
+        lines.push('');
+    }
+    // Requires
+    const req = config.requires;
+    if (req) {
+        lines.push('## 요구사항');
+        lines.push('');
+        if (req.env && req.env.length > 0) {
+            lines.push('### 환경변수');
+            for (const e of req.env) {
+                const name = typeof e === 'string' ? e : e.name;
+                const desc = typeof e === 'string' ? '' : e.description ?? '';
+                const required = typeof e === 'string' ? true : e.required !== false;
+                lines.push(`- \`${name}\` ${required ? '(필수)' : '(선택)'}${desc ? ' — ' + desc : ''}`);
+            }
+            lines.push('');
+        }
+        if (req.cli && req.cli.length > 0) {
+            lines.push('### CLI 도구');
+            for (const c of req.cli) {
+                const install = c.install ? ` — 설치: \`${c.install}\`` : '';
+                lines.push(`- \`${c.name}\`${install}`);
+            }
+            lines.push('');
+        }
+        if (req.npm && req.npm.length > 0) {
+            lines.push('### npm 패키지');
+            for (const n of req.npm) {
+                const name = typeof n === 'string' ? n : n.name;
+                lines.push(`- \`${name}\``);
+            }
+            lines.push('');
+        }
+        if (req.mcp && req.mcp.length > 0) {
+            lines.push('### MCP 서버');
+            for (const m of req.mcp) {
+                const pkg = m.package ? ` (\`${m.package}\`)` : '';
+                lines.push(`- **${m.name}**${pkg}`);
+            }
+            lines.push('');
+        }
+        if (req.runtime) {
+            lines.push('### 런타임');
+            if (req.runtime.node)
+                lines.push(`- Node.js ${req.runtime.node}`);
+            if (req.runtime.python)
+                lines.push(`- Python ${req.runtime.python}`);
+            lines.push('');
+        }
+        if (req.teams && req.teams.length > 0) {
+            lines.push('### 의존 팀');
+            for (const t of req.teams) {
+                lines.push(`- \`${t}\``);
+            }
+            lines.push('');
+        }
+    }
+    return lines.join('\n');
+}
 function countDir(teamDir, dirName) {
     const dirPath = path_1.default.join(teamDir, dirName);
     if (!fs_1.default.existsSync(dirPath))
@@ -186,11 +299,16 @@ function resolveLongDescription(teamDir, yamlValue) {
 async function createTarball(teamDir) {
     const tmpFile = path_1.default.join(os_1.default.tmpdir(), `relay-publish-${Date.now()}.tar.gz`);
     const dirsToInclude = VALID_DIRS.filter((d) => fs_1.default.existsSync(path_1.default.join(teamDir, d)));
+    // Include root SKILL.md if it exists
+    const entries = [...dirsToInclude];
+    if (fs_1.default.existsSync(path_1.default.join(teamDir, 'SKILL.md'))) {
+        entries.push('SKILL.md');
+    }
     await (0, tar_1.create)({
         gzip: true,
         file: tmpFile,
         cwd: teamDir,
-    }, [...dirsToInclude]);
+    }, entries);
     return tmpFile;
 }
 async function publishToApi(token, tarPath, metadata, teamDir, portfolioEntries) {
@@ -417,6 +535,10 @@ function registerPublish(program) {
                 console.error(`포트폴리오 이미지: ${portfolioEntries.length}개`);
             }
         }
+        // Generate root SKILL.md for skill discovery and update checks
+        const detectedSkills = detectSkills(relayDir);
+        const rootSkillContent = generateRootSkillMd(config, detectedCommands, detectedSkills, config.slug);
+        fs_1.default.writeFileSync(path_1.default.join(relayDir, 'SKILL.md'), rootSkillContent);
         let tarPath = null;
         try {
             tarPath = await createTarball(relayDir);

package/dist/commands/update.js

@@ -101,6 +101,21 @@ function registerUpdate(program) {
                 const authorDisplayName = team.author?.display_name ?? authorUsername ?? '';
                 const contactParts = (0, contact_format_js_1.formatContactParts)(team.author?.contact_links);
                 const hasCard = team.welcome || contactParts.length > 0 || authorUsername;
+                // Show changelog for this version
+                try {
+                    const versions = await (0, api_js_1.fetchTeamVersions)(slug);
+                    const thisVersion = versions.find((v) => v.version === latestVersion);
+                    if (thisVersion?.changelog) {
+                        console.log(`\n  \x1b[90m── Changelog ──────────────────────────────\x1b[0m`);
+                        for (const line of thisVersion.changelog.split('\n').slice(0, 5)) {
+                            console.log(`  ${line}`);
+                        }
+                        console.log(`  \x1b[90m───────────────────────────────────────────\x1b[0m`);
+                    }
+                }
+                catch {
+                    // Non-critical: skip changelog display
+                }
                 if (hasCard) {
                     console.log(`\n  \x1b[90m┌─ ${authorDisplayName || '빌더'}의 명함 ${'─'.repeat(Math.max(0, 34 - (authorDisplayName || '빌더').length))}┐\x1b[0m`);
                     if (team.welcome) {

package/dist/index.js

@@ -15,6 +15,7 @@ const update_js_1 = require("./commands/update.js");
 const outdated_js_1 = require("./commands/outdated.js");
 const check_update_js_1 = require("./commands/check-update.js");
 const follow_js_1 = require("./commands/follow.js");
+const changelog_js_1 = require("./commands/changelog.js");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const pkg = require('../package.json');
 const program = new commander_1.Command();
@@ -36,4 +37,5 @@ program
 (0, outdated_js_1.registerOutdated)(program);
 (0, check_update_js_1.registerCheckUpdate)(program);
 (0, follow_js_1.registerFollow)(program);
+(0, changelog_js_1.registerChangelog)(program);
 program.parse();

package/dist/lib/command-adapter.js

@@ -54,23 +54,20 @@ const LOGIN_JIT_GUIDE = `
 // ─── 명함 표시 포맷 ───
 const BUSINESS_CARD_FORMAT = `
 ### 빌더 명함 표시
-CLI 출력에 포함된 빌더 명함 정보를 아래 포맷으로 사용자에게 보여줍니다:
+CLI 출력에 포함된 빌더 명함 정보를 반드시 아래 예시와 동일한 형태로 출력합니다.
+불릿 리스트(- 또는 *)로 나열하지 마세요. 반드시 인용 블록(>) 안에 넣어야 합니다.
 
-\`\`\`
-┌─ {빌더이름}의 명함 ─────────────────────────┐
-│                                              │
-│  💬 "{환영 메시지}"                           │
-│                                              │
-│  📧 {이메일}                                  │
-│  🔗 {웹사이트 또는 기타 연락처}                │
-│  👤 relayax.com/@{username}                  │
-│                                              │
-└──────────────────────────────────────────────┘
-\`\`\`
+**예시 (이 형태를 그대로 따르세요):**
+
+> **🪪 devhaemin의 명함**
+>
+> 💬 "안녕하세요!"
+>
+> 📧 haemin@musibe.com
+> 👤 relayax.com/@devhaemin
 
-- CLI 출력의 ┌─ ... ┘ 박스를 그대로 복사하지 말고, 위 마크다운 포맷으로 다시 렌더링합니다.
-- 연락처가 여러 개면 각각 한 줄씩 표시합니다.
 - 환영 메시지가 없으면 💬 줄을 생략합니다.
+- 연락처가 여러 개면 각각 한 줄씩 표시합니다.
 - 명함이 비어있으면 명함 블록 전체를 생략합니다.`;
 // ─── User Commands (글로벌 설치) ───
 exports.USER_COMMANDS = [
@@ -122,14 +119,22 @@ exports.USER_COMMANDS = [
 - rules/ — 룰 파일들
 - relay.yaml — 팀 메타데이터 및 requirements
 
-### 3. 에이전트 환경에 맞게 배치
+### 3. 기존 파일 충돌 확인
+배치 대상 디렉토리(\`.claude/commands/\`, \`.claude/skills/\` 등)에 **같은 이름의 파일이 이미 존재하는지** 확인합니다.
+- 충돌하는 파일이 있으면 사용자에게 반드시 물어봅니다:
+  - "다음 파일이 이미 존재합니다: {파일 목록}. 덮어쓸까요, 건너뛸까요?"
+  - 사용자가 선택할 때까지 진행하지 않습니다.
+- 충돌이 없으면 그대로 진행합니다.
+- **주의**: 팀에 포함되지 않은 기존 파일은 절대 삭제하지 않습니다.
+
+### 4. 에이전트 환경에 맞게 배치
 현재 에이전트의 디렉토리 구조에 맞게 파일을 복사합니다:
 - Claude Code: \`.relay/teams/<slug>/commands/\` → \`.claude/commands/\`에 복사
 - Claude Code: \`.relay/teams/<slug>/skills/\` → \`.claude/skills/\`에 복사
 - 다른 에이전트(Cursor, Cline 등): 해당 에이전트의 규칙에 맞는 디렉토리에 복사
 - 에이전트 설정이나 룰은 적절한 위치에 배치
 
-### 4. Requirements 확인 및 설치
+### 5. Requirements 확인 및 설치
 \`.relay/teams/<slug>/relay.yaml\`의 \`requires\` 섹션을 읽고 처리합니다:
 - **cli**: \`which <name>\`으로 확인 → 없으면 install 명령 실행 또는 안내
 - **npm**: \`npm list <package>\`로 확인 → 없으면 \`npm install\`
@@ -139,7 +144,7 @@ exports.USER_COMMANDS = [
 - **teams**: 의존하는 다른 팀 → \`relay install <@author/team>\`으로 재귀 설치
 ${LOGIN_JIT_GUIDE}
 
-### 5. 완료 안내
+### 6. 완료 안내
 - 배치된 파일과 활성화된 커맨드 목록을 보여줍니다.
 ${BUSINESS_CARD_FORMAT}
 - **팔로우 제안**: 사용자에게 직접 질문하는 인터랙티브 도구(예: AskUserQuestion 등)를 사용하여 "@{username}을 팔로우할까요? 새 버전 알림을 받을 수 있습니다."라고 반드시 물어봅니다. 인터랙티브 도구가 없으면 텍스트로 물어봅니다.

package/dist/lib/preamble.d.ts

@@ -1,3 +1,11 @@
 export declare function generatePreamble(slug: string): string;
+/**
+ * frontmatter(---...---) 뒤에 preamble을 삽입한다.
+ * frontmatter가 없으면 파일 맨 앞에 삽입한다.
+ */
 export declare function injectPreamble(filePath: string, slug: string): void;
+/**
+ * 팀의 루트 SKILL.md와 commands/*.md에 preamble을 주입한다.
+ * 서브 스킬의 SKILL.md는 건드리지 않는다 (frontmatter 검색에 영향).
+ */
 export declare function injectPreambleToTeam(teamDir: string, slug: string): number;

package/dist/lib/preamble.js

@@ -12,7 +12,7 @@ const PREAMBLE_START = '<!-- RELAY_PREAMBLE_START - DO NOT EDIT -->';
 const PREAMBLE_END = '<!-- RELAY_PREAMBLE_END -->';
 function generatePreamble(slug) {
     return `${PREAMBLE_START}
-## Preamble (auto-generated by relay)
+## Preamble (run first)
 
 \`\`\`bash
 relay check-update ${slug} --quiet 2>/dev/null
@@ -22,39 +22,58 @@ If output shows \`CLI_UPGRADE_AVAILABLE <old> <new>\`: tell user "relay v{new} a
 If output shows \`TEAM_UPGRADE_AVAILABLE\`: tell user "${slug} v{new} available (by @{author}). Run: relay update ${slug}"
 ${PREAMBLE_END}`;
 }
+/**
+ * frontmatter(---...---) 뒤에 preamble을 삽입한다.
+ * frontmatter가 없으면 파일 맨 앞에 삽입한다.
+ */
 function injectPreamble(filePath, slug) {
     const content = fs_1.default.readFileSync(filePath, 'utf-8');
     const preamble = generatePreamble(slug);
-    const startIdx = content.indexOf(PREAMBLE_START);
-    const endIdx = content.indexOf(PREAMBLE_END);
-    let newContent;
+    // 기존 preamble 제거
+    let cleaned = content;
+    const startIdx = cleaned.indexOf(PREAMBLE_START);
+    const endIdx = cleaned.indexOf(PREAMBLE_END);
     if (startIdx !== -1 && endIdx !== -1) {
-        newContent =
-            content.slice(0, startIdx) +
-                preamble +
-                content.slice(endIdx + PREAMBLE_END.length);
+        cleaned =
+            cleaned.slice(0, startIdx).trimEnd() +
+                '\n' +
+                cleaned.slice(endIdx + PREAMBLE_END.length).trimStart();
+    }
+    // frontmatter 뒤에 삽입
+    const fmMatch = cleaned.match(/^---\n[\s\S]*?\n---\n/);
+    if (fmMatch) {
+        const fmEnd = fmMatch[0].length;
+        cleaned =
+            cleaned.slice(0, fmEnd) +
+                '\n' + preamble + '\n\n' +
+                cleaned.slice(fmEnd).trimStart();
     }
     else {
-        newContent = preamble + '\n\n' + content;
+        cleaned = preamble + '\n\n' + cleaned.trimStart();
     }
-    fs_1.default.writeFileSync(filePath, newContent);
+    fs_1.default.writeFileSync(filePath, cleaned);
 }
+/**
+ * 팀의 루트 SKILL.md와 commands/*.md에 preamble을 주입한다.
+ * 서브 스킬의 SKILL.md는 건드리지 않는다 (frontmatter 검색에 영향).
+ */
 function injectPreambleToTeam(teamDir, slug) {
     let count = 0;
-    function walk(dir) {
-        if (!fs_1.default.existsSync(dir))
-            return;
-        for (const entry of fs_1.default.readdirSync(dir, { withFileTypes: true })) {
-            const fullPath = path_1.default.join(dir, entry.name);
-            if (entry.isDirectory()) {
-                walk(fullPath);
-            }
-            else if (entry.name === 'SKILL.md') {
-                injectPreamble(fullPath, slug);
-                count++;
-            }
+    // 1. 루트 SKILL.md (skills/<slug>/SKILL.md 레벨)
+    const rootSkill = path_1.default.join(teamDir, 'SKILL.md');
+    if (fs_1.default.existsSync(rootSkill)) {
+        injectPreamble(rootSkill, slug);
+        count++;
+    }
+    // 2. commands/*.md
+    const commandsDir = path_1.default.join(teamDir, 'commands');
+    if (fs_1.default.existsSync(commandsDir)) {
+        for (const entry of fs_1.default.readdirSync(commandsDir, { withFileTypes: true })) {
+            if (!entry.isFile() || !entry.name.endsWith('.md'))
+                continue;
+            injectPreamble(path_1.default.join(commandsDir, entry.name), slug);
+            count++;
         }
     }
-    walk(teamDir);
     return count;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "relayax-cli",
-  "version": "0.2.14",
+  "version": "0.2.18",
   "description": "RelayAX Agent Team Marketplace CLI - Install and manage agent teams",
   "main": "dist/index.js",
   "bin": {