relayax-cli 0.2.18 → 0.2.20

package/dist/commands/install.js

@@ -11,11 +11,13 @@ const storage_js_1 = require("../lib/storage.js");
 const config_js_1 = require("../lib/config.js");
 const slug_js_1 = require("../lib/slug.js");
 const contact_format_js_1 = require("../lib/contact-format.js");
+const preamble_js_1 = require("../lib/preamble.js");
 function registerInstall(program) {
     program
         .command('install <slug>')
         .description('에이전트 팀 패키지를 .relay/teams/에 다운로드합니다')
-        .action(async (slugInput) => {
+        .option('--no-guide', 'GUIDE.html 브라우저 자동 오픈을 비활성화합니다')
+        .action(async (slugInput, opts) => {
         const json = program.opts().json ?? false;
         const projectPath = process.cwd();
         const tempDir = (0, storage_js_1.makeTempDir)();
@@ -50,6 +52,8 @@ function registerInstall(program) {
             }
             fs_1.default.mkdirSync(teamDir, { recursive: true });
             await (0, storage_js_1.extractPackage)(tarPath, teamDir);
+            // 4.5. Inject preamble (update check) into SKILL.md and commands
+            (0, preamble_js_1.injectPreambleToTeam)(teamDir, slug);
             // 5. Count extracted files
             function countFiles(dir) {
                 let count = 0;
@@ -75,7 +79,7 @@ function registerInstall(program) {
             };
             (0, config_js_1.saveInstalled)(installed);
             // 7. Report install (non-blocking)
-            await (0, api_js_1.reportInstall)(slug);
+            await (0, api_js_1.reportInstall)(slug, team.version);
             const result = {
                 status: 'ok',
                 team: team.name,
@@ -121,6 +125,20 @@ function registerInstall(program) {
                     }
                     console.log(`  \x1b[90m└${'─'.repeat(44)}┘\x1b[0m`);
                 }
+                // Open GUIDE.html in browser if present
+                const guideHtmlPath = path_1.default.join(teamDir, 'GUIDE.html');
+                if (opts.guide !== false && fs_1.default.existsSync(guideHtmlPath)) {
+                    const isTTY = Boolean(process.stdin.isTTY);
+                    if (isTTY) {
+                        const { exec } = await import('child_process');
+                        const openCmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start ""' : 'xdg-open';
+                        exec(`${openCmd} "${guideHtmlPath}"`);
+                        console.log(`\n  📖 사용가이드를 브라우저에서 열었습니다`);
+                    }
+                    else {
+                        console.log(`\n  📖 사용가이드: ${guideHtmlPath}`);
+                    }
+                }
                 console.log('\n  에이전트가 /relay-install로 환경을 구성합니다.');
             }
         }

package/dist/commands/publish.js

@@ -30,12 +30,7 @@ function parseRelayYaml(content) {
     const rawPortfolio = raw.portfolio;
     const portfolio = {};
     if (rawPortfolio && typeof rawPortfolio === 'object' && !Array.isArray(rawPortfolio)) {
-        // New slot-based format: { cover: {...}, demo: {...}, gallery: [...] }
-        if (rawPortfolio.cover && typeof rawPortfolio.cover === 'object') {
-            const c = rawPortfolio.cover;
-            if (c.path)
-                portfolio.cover = { path: String(c.path) };
-        }
+        // Slot-based format: { demo: {...}, gallery: [...] }
         if (rawPortfolio.demo && typeof rawPortfolio.demo === 'object') {
             const d = rawPortfolio.demo;
             portfolio.demo = {
@@ -223,19 +218,18 @@ function countDir(teamDir, dirName) {
         return 0;
     return fs_1.default.readdirSync(dirPath).filter((f) => !f.startsWith('.')).length;
 }
+function listDir(teamDir, dirName) {
+    const dirPath = path_1.default.join(teamDir, dirName);
+    if (!fs_1.default.existsSync(dirPath))
+        return [];
+    return fs_1.default.readdirSync(dirPath).filter((f) => !f.startsWith('.'));
+}
 /**
  * 슬롯 기반 포트폴리오를 PortfolioEntry[] 로 평탄화한다.
  * relay.yaml에 슬롯이 정의되어 있으면 사용, 없으면 portfolio/ 자동 스캔.
  */
 function collectPortfolio(relayDir, slots) {
     const entries = [];
-    // Cover
-    if (slots.cover?.path) {
-        const absPath = path_1.default.resolve(relayDir, slots.cover.path);
-        if (fs_1.default.existsSync(absPath)) {
-            entries.push({ path: slots.cover.path, title: 'Cover', slot_type: 'cover' });
-        }
-    }
     // Demo
     if (slots.demo) {
         if (slots.demo.type === 'video_url' && slots.demo.url) {
@@ -264,13 +258,13 @@ function collectPortfolio(relayDir, slots) {
             const files = fs_1.default.readdirSync(portfolioDir)
                 .filter((f) => IMAGE_EXTS.some((ext) => f.toLowerCase().endsWith(ext)))
                 .sort();
-            // First image as cover, rest as gallery
+            // All images as gallery
             for (let i = 0; i < files.length && i < 6; i++) {
                 const f = files[i];
                 entries.push({
                     path: path_1.default.join('portfolio', f),
                     title: path_1.default.basename(f, path_1.default.extname(f)).replace(/[-_]/g, ' '),
-                    slot_type: i === 0 ? 'cover' : 'gallery',
+                    slot_type: 'gallery',
                 });
             }
         }
@@ -299,11 +293,14 @@ 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
+    // Include root SKILL.md and GUIDE.html if they exist
     const entries = [...dirsToInclude];
     if (fs_1.default.existsSync(path_1.default.join(teamDir, 'SKILL.md'))) {
         entries.push('SKILL.md');
     }
+    if (fs_1.default.existsSync(path_1.default.join(teamDir, 'GUIDE.html'))) {
+        entries.push('GUIDE.html');
+    }
     await (0, tar_1.create)({
         gzip: true,
         file: tmpFile,
@@ -361,6 +358,13 @@ async function publishToApi(token, tarPath, metadata, teamDir, portfolioEntries)
         }
         form.append('portfolio_meta', JSON.stringify(portfolioMeta));
     }
+    // Attach GUIDE.html if it exists
+    const guidePath = path_1.default.join(teamDir, 'GUIDE.html');
+    if (fs_1.default.existsSync(guidePath)) {
+        const guideBuffer = fs_1.default.readFileSync(guidePath);
+        const guideBlob = new Blob([guideBuffer], { type: 'text/html' });
+        form.append('guide', guideBlob, 'GUIDE.html');
+    }
     const res = await fetch(`${config_js_1.API_URL}/api/publish`, {
         method: 'POST',
         headers: { Authorization: `Bearer ${token}` },
@@ -528,6 +532,8 @@ function registerPublish(program) {
             requires: config.requires,
             visibility: config.visibility,
             cli_version: cliPkg.version,
+            agent_names: listDir(relayDir, 'agents'),
+            skill_names: listDir(relayDir, 'skills'),
         };
         if (!json) {
             console.error(`패키지 생성 중... (${config.name} v${config.version})`);
@@ -546,6 +552,19 @@ function registerPublish(program) {
                 console.error(`업로드 중...`);
             }
             const result = await publishToApi(token, tarPath, metadata, relayDir, portfolioEntries);
+            // Update local SKILL.md preamble with scoped slug from server (non-fatal)
+            try {
+                if (result.slug && result.slug !== config.slug) {
+                    const localSkillMd = path_1.default.join(relayDir, 'SKILL.md');
+                    if (fs_1.default.existsSync(localSkillMd)) {
+                        const { injectPreamble } = await import('../lib/preamble.js');
+                        injectPreamble(localSkillMd, result.slug);
+                    }
+                }
+            }
+            catch {
+                // preamble update is best-effort — publish already succeeded
+            }
             if (json) {
                 console.log(JSON.stringify(result));
             }

package/dist/commands/update.js

@@ -7,6 +7,7 @@ const installer_js_1 = require("../lib/installer.js");
 const config_js_1 = require("../lib/config.js");
 const slug_js_1 = require("../lib/slug.js");
 const contact_format_js_1 = require("../lib/contact-format.js");
+const preamble_js_1 = require("../lib/preamble.js");
 function registerUpdate(program) {
     program
         .command('update <slug>')
@@ -69,6 +70,8 @@ function registerUpdate(program) {
             // Extract
             const extractDir = `${tempDir}/extracted`;
             await (0, storage_js_1.extractPackage)(tarPath, extractDir);
+            // Inject preamble (update check) before copying
+            (0, preamble_js_1.injectPreambleToTeam)(extractDir, slug);
             // Copy files to install_path
             const files = (0, installer_js_1.installTeam)(extractDir, installPath);
             // Update installed.json with new version

package/dist/lib/api.d.ts

@@ -7,12 +7,12 @@ export interface TeamVersionInfo {
     created_at: string;
 }
 export declare function fetchTeamVersions(slug: string): Promise<TeamVersionInfo[]>;
-export declare function reportInstall(slug: string): Promise<void>;
+export declare function reportInstall(slug: string, version?: string): Promise<void>;
 export interface ResolvedSlug {
     owner: string;
     name: string;
     full: string;
 }
 export declare function resolveSlugFromServer(name: string): Promise<ResolvedSlug[]>;
-export declare function sendUsagePing(slug: string): Promise<void>;
+export declare function sendUsagePing(slug: string, version?: string): Promise<void>;
 export declare function followBuilder(username: string): Promise<void>;

package/dist/lib/api.js

@@ -41,10 +41,24 @@ async function fetchTeamVersions(slug) {
     }
     return res.json();
 }
-async function reportInstall(slug) {
+async function reportInstall(slug, version) {
     const registrySlug = slug.startsWith('@') ? slug.slice(1) : slug;
     const url = `${config_js_1.API_URL}/api/registry/${registrySlug}/install`;
-    await fetch(url, { method: 'POST' }).catch(() => {
+    const headers = {};
+    const body = {};
+    if (version) {
+        headers['Content-Type'] = 'application/json';
+        body.version = version;
+    }
+    const token = await (0, config_js_1.getValidToken)();
+    if (token) {
+        headers['Authorization'] = `Bearer ${token}`;
+    }
+    await fetch(url, {
+        method: 'POST',
+        headers: Object.keys(headers).length > 0 ? headers : undefined,
+        body: Object.keys(body).length > 0 ? JSON.stringify(body) : undefined,
+    }).catch(() => {
         // non-critical: ignore errors
     });
 }
@@ -57,7 +71,7 @@ async function resolveSlugFromServer(name) {
     const data = (await res.json());
     return data.results;
 }
-async function sendUsagePing(slug) {
+async function sendUsagePing(slug, version) {
     const registrySlug = slug.startsWith('@') ? slug.slice(1) : slug;
     const { createHash } = await import('crypto');
     const { hostname, userInfo } = await import('os');
@@ -65,10 +79,17 @@ async function sendUsagePing(slug) {
         .update(`${hostname()}:${userInfo().username}`)
         .digest('hex');
     const url = `${config_js_1.API_URL}/api/registry/${registrySlug}/ping`;
+    const payload = { device_hash: deviceHash };
+    if (version)
+        payload.installed_version = version;
+    const headers = { 'Content-Type': 'application/json' };
+    const token = await (0, config_js_1.getValidToken)();
+    if (token)
+        headers['Authorization'] = `Bearer ${token}`;
     await fetch(url, {
         method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({ device_hash: deviceHash }),
+        headers,
+        body: JSON.stringify(payload),
     }).catch(() => {
         // fire-and-forget: ignore errors
     });

package/dist/lib/command-adapter.js

@@ -241,7 +241,7 @@ exports.BUILDER_COMMANDS = [
     {
         id: 'relay-publish',
         description: '현재 팀 패키지를 포트폴리오와 함께 relay 마켓플레이스에 배포합니다',
-        body: `현재 디렉토리의 에이전트 팀(.relay/)을 분석하고, 보안 점검 및 requirements를 구성한 뒤, 포트폴리오를 생성하고 relay 마켓플레이스에 배포합니다.
+        body: `현재 디렉토리의 에이전트 팀(.relay/)을 분석하고, 보안 점검 및 requirements를 구성한 뒤, 사용가이드와 포트폴리오를 생성하고 relay 마켓플레이스에 배포합니다.
 
 ## 실행 단계
 
@@ -327,76 +327,67 @@ requires:
     - @example/contents-team
 \`\`\`
 
-### 4. 포트폴리오 생성 (슬롯 기반)
-
-포트폴리오는 3가지 슬롯으로 구성됩니다. .relay/portfolio/ 디렉토리에 저장합니다.
-
-#### 슬롯 1: cover (필수 — 마켓 리스팅 카드)
-- 규격: 1200x630px, WebP, 최대 500KB
-- 팀 구조를 요약하는 카드 HTML을 생성합니다:
-  - 팀 이름, 버전
-  - Skills 목록 (이름 + 설명)
-  - Commands 목록
-  - 주요 기능 요약
-- 생성된 HTML을 Playwright로 1200x630 뷰포트에서 스크린샷 캡처합니다.
-- .relay/portfolio/cover.png에 저장합니다.
-- 사용자에게 "이 cover를 사용할까요?" 확인. 직접 제공도 가능.
-
-#### 슬롯 2: demo (자동 생성 — 동작 시연)
-에이전트가 **직접 팀의 커맨드를 실행하여** demo를 자동 생성합니다. 사용자에게 묻기 전에 먼저 만듭니다.
-
-**생성 절차:**
-1. .relay/commands/ 의 커맨드 목록을 읽고, 가장 대표적인 커맨드를 선택합니다.
-2. 해당 커맨드를 예시 주제/데이터로 실행합니다.
-   - 콘텐츠 팀: "라즈베리파이5 신제품 소개" 같은 예시 주제로 커맨드 실행
-   - 크롤링 팀: 예시 URL로 실행하며 브라우저 동작을 녹화
-   - 분석 팀: 샘플 데이터로 실행하여 결과 캡처
-3. 실행 결과물로 demo를 생성합니다:
-   - 여러 장 이미지 (카드뉴스 등): 슬라이드쇼 GIF (각 장 2초 간격)
-   - 브라우저 동작: 동작 녹화 GIF
-   - 단일 결과물: 결과 이미지를 demo로 사용
-4. 생성된 demo를 사용자에게 보여줍니다: "이 demo를 사용할까요?"
-   - 수정 요청 가능: "다른 주제로 다시 만들어줘", "좀 더 짧게"
-   - 확정 시 .relay/portfolio/demo.gif에 저장
-
-**예시 주제 선택 기준:**
-- relay.yaml의 description, tags에서 도메인 힌트 추출
-- 기존 output/에 결과물이 있으면 같은 주제 활용
-- 없으면 팀 설명에서 가장 그럴듯한 예시 주제를 자체 생성
-
-**GIF 규격:** 최대 5MB, .relay/portfolio/demo.gif
-**대안:** 외부 영상 URL (YouTube, Loom)도 가능 — relay.yaml에 기록
-
-#### 슬롯 3: gallery (선택 — 결과물 쇼케이스, 최대 5장)
-- 규격: 800x600px 이하, WebP, 각 500KB 이하
-- output/, results/, examples/ 디렉토리를 스캔합니다.
-- 큰 이미지 → 사용자에게 "어느 영역을 보여줄까요?" 확인 후 핵심 영역 crop
-- HTML 파일 → Playwright 스크린샷으로 변환
+### 4. 포트폴리오 수집
+
+- output/, results/, examples/, portfolio/ 디렉토리를 스캔합니다.
+- 발견된 결과물(PNG, JPG, HTML, PDF)을 사용자에게 보여줍니다.
+- HTML 파일은 Playwright 스크린샷으로 변환합니다.
 - 사용자가 포트폴리오에 포함할 항목을 선택합니다.
-- .relay/portfolio/에 저장합니다.
+- 선택된 이미지를 .relay/portfolio/에 저장합니다.
+
+### 5. 사용가이드 생성 (GUIDE.html)
+
+설치자가 읽을 수 있는 사용가이드를 HTML로 생성합니다.
+
+#### 5-1. 팀 소스 분석
+- skills/, agents/, commands/ 디렉토리의 **모든 파일 내용**을 읽습니다.
+- 각 스킬의 SKILL.md, 에이전트 설정, 커맨드 문서를 분석하여 팀의 파이프라인 흐름을 추론합니다.
+
+#### 5-2. GUIDE.html 생성
+- \`cli/src/lib/guide.ts\`의 \`GUIDE_HTML_PROMPT\`를 읽고, 해당 프롬프트의 콘텐츠 구조와 디자인 규칙을 따라 GUIDE.html을 생성합니다.
+- 5-1에서 분석한 팀 소스 정보를 프롬프트에 반영합니다.
+- 파이프라인이 없는 단순한 팀은 시작 방법 + 기능 설명 + Q&A만 포함합니다.
+
+#### 5-3. 미리보기 + 컨펌
+- 생성된 GUIDE.html을 브라우저에서 열어 빌더에게 미리보기를 보여줍니다.
+- 빌더에게 확인: "사용가이드를 확인해주세요. 이대로 진행할까요?"
+
+#### 5-4. 재생성 루프
+- 빌더가 수정을 요청하면 (예: "Q&A 추가해줘", "파이프라인 설명 더 자세히") 요청사항을 반영하여 GUIDE.html을 재생성합니다.
+- 재생성 후 다시 브라우저에서 미리보기를 보여줍니다.
+- 빌더가 컨펌할 때까지 반복합니다.
+
+#### 5-5. 저장
+- 컨펌된 GUIDE.html을 \`.relay/GUIDE.html\`에 저장합니다.
+
+#### 5-6. GUIDE.html 스크린샷 → gallery 등록
+- GUIDE.html을 Playwright로 열어 첫 화면(뷰포트 1200x630)을 스크린샷 캡처합니다. (gstack 또는 webapp-testing 스킬 활용)
+- 결과 PNG를 \`./portfolio/guide-preview.png\`에 저장합니다.
+- relay.yaml의 portfolio gallery 첫 번째 항목으로 자동 등록합니다.
+- 이 이미지는 마켓플레이스 카드 및 OG 이미지의 fallback으로 사용됩니다 (demo > gallery 순).
 
-### 5. 메타데이터 생성
+### 6. 메타데이터 생성
 - description: skills 내용 기반으로 자동 생성합니다.
 - long_description: 팀 소개 마크다운을 자동 생성합니다 (README.md가 있으면 활용).
 - tags: 팀 특성에 맞는 태그를 추천합니다.
 - 사용자에게 확인: "이대로 배포할까요?"
 
-### 6. .relay/relay.yaml 업데이트
+### 7. .relay/relay.yaml 업데이트
 - 메타데이터, requires, 포트폴리오 슬롯을 .relay/relay.yaml에 반영합니다.
 
 \`\`\`yaml
 portfolio:
-  cover:
-    path: portfolio/cover.png
   demo:                          # 선택
     type: gif
     path: portfolio/demo.gif
   gallery:                       # 선택, 최대 5장
+    - path: portfolio/guide-preview.png
+      title: "사용가이드 미리보기"
     - path: portfolio/example-1.png
       title: "카드뉴스 예시"
 \`\`\`
 
-### 7. 배포
+### 8. 배포
 - \`relay publish\` 명령어를 실행합니다.
 - 배포 결과와 마켓플레이스 URL을 보여줍니다.
 ${BUSINESS_CARD_FORMAT}
@@ -408,9 +399,9 @@ ${BUSINESS_CARD_FORMAT}
 → 보안 스캔: ✓ 시크릿 없음
 → 환경변수 감지: OPENAI_API_KEY (필수), DATABASE_URL (선택)
 → requires 업데이트 완료
-→ cover 생성: 팀 구조 카드 HTML → 1200x630 스크린샷
-→ demo: "브라우저 자동화 감지. GIF 데모 녹화할까요?" → Yes → 녹화 완료
-→ gallery: output/ 스캔 → "카드뉴스 예시.png 포함?" → Yes → crop + 리사이즈
+→ 포트폴리오: output/ 스캔 → "카드뉴스 예시.png 포함?" → Yes
+→ GUIDE.html 생성 → 브라우저에서 미리보기 → 빌더 컨펌
+→ GUIDE.html 스크린샷 → gallery 첫 번째 이미지로 등록
 → relay publish 실행
 → "배포 완료! URL: https://relayax.com/teams/my-team"`,
     },

package/dist/lib/guide.d.ts

@@ -0,0 +1,5 @@
+/**
+ * GUIDE.html 생성 프롬프트 템플릿.
+ * publish slash command에서 Claude Code가 이 프롬프트를 읽고 GUIDE.html을 생성한다.
+ */
+export declare const GUIDE_HTML_PROMPT: string;

package/dist/lib/guide.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * GUIDE.html 생성 프롬프트 템플릿.
+ * publish slash command에서 Claude Code가 이 프롬프트를 읽고 GUIDE.html을 생성한다.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GUIDE_HTML_PROMPT = void 0;
+exports.GUIDE_HTML_PROMPT = `
+당신은 에이전트 팀의 사용가이드(GUIDE.html)를 생성하는 에이전트입니다.
+팀의 skills/, agents/, commands/ 파일을 분석한 결과를 바탕으로, 설치자가 읽을 수 있는 standalone HTML 파일을 생성하세요.
+
+## 콘텐츠 구조 (순서대로)
+
+1. **헤더**: 팀 이름 + 한 줄 소개
+2. **설치 방법 (준비하기)**:
+   - Step 1: CLI 설치 — \`npm install -g relayax-cli\`
+   - Step 2: 팀 설치 — \`relay install @owner/slug\` (실제 팀의 scoped slug 사용)
+   - Step 3: 에이전트에 복사붙여넣기 — "사용하시는 AI 에이전트(Claude Code, Codex 등)의 채팅창에 아래 명령어를 붙여넣기 하세요!"
+3. **안내 Callout**: 노란 배경 박스로 시작 방법 강조 — "채팅창에 '○○○'라고 입력하세요."
+4. **워크플로우 요약**: 전체 흐름을 한 줄로 — \`[0 온보딩 → 1 분석 → 1.5 선택 → 2 추천 → 3 생성]\`
+5. **파이프라인 다이어그램**: 2-column 세로 플로우차트
+   - 왼쪽 컬럼: 파이프라인 단계 (노드 + 연결선, 세로 흐름)
+   - 오른쪽 컬럼: 해당 단계에서 사용하는 skill 카드 (skill명 + 한 줄 설명)
+   - 색상 구분: 유저 개입 단계 = 베이지/주황 톤, AI 자동 단계 = 연두/초록 톤
+   - 상단에 범례: ■ 유저 개입 / ■ 자동 실행
+   - 선택적 단계(optional)는 점선 테두리 그룹으로 묶기
+6. **단계별 상세 테이블**: 4-column 테이블
+   - 컬럼: 단계 | skill명 | 액션 | 상세
+   - 각 행에 역할 뱃지: "AI가 알아서 해줘요" (초록 배경) / "직접 아래 액션을 수행해주세요!" (주황 배경, 볼드)
+   - 상세 컬럼에 bullet list로 구체적 동작 설명
+   - 주의사항은 빨간 이탤릭 (*주의: ...)
+7. **사전 준비사항**: 필요한 환경변수, 접근 권한, 데이터 등
+8. **Q&A**: 접이식 토글(details/summary)로 자주 묻는 질문
+   - 커스터마이징 방법 (개수 변경, 타입 고정 등)
+   - 중단/재시작 방법
+   - 데이터 형식 요구사항
+
+파이프라인이 없는 단순한 팀은 시작 방법 + 기능 설명 + Q&A만 포함합니다.
+
+## 디자인 규칙 (Notion 스타일)
+
+- **라이트 모드**: 배경 #ffffff / 부배경 #fafaf8, 텍스트 다크 #1a1a18
+- **레이아웃**: max-width 900px, padding 40px, Notion 문서형 넓은 여백
+- **타이포그래피**: system-ui, -apple-system, sans-serif. 본문 15px, line-height 1.7
+- **Callout 박스**: 노란 배경 #fffbeb + 좌측 보더 4px solid #fcd34d (중요 안내), 파란 배경 #eff6ff + 보더 #93c5fd (참고)
+- **역할 뱃지**: 둥근 모서리 pill, 초록 배경 #e0f5ea + 텍스트 #0d6b2e (AI) / 주황 배경 #fff0e0 + 텍스트 #b85a00 (유저)
+- **테이블**: 깔끔한 border #e8e8e4, hover 시 행 하이라이트 #f5f5f3, 헤더 회색 배경 #f5f5f3
+- **색상**: 유저 단계 = 베이지/주황 (#fff8f0, #f0c090), AI 단계 = 연두 (#f0faf4, #90d4a8)
+- **톤**: 따뜻하고 친근한 한국어, 이모지 적절히 활용
+- **반응형**: 600px 이하에서 테이블 가로스크롤, 다이어그램 단일 컬럼
+- **기술 제약**: standalone HTML, CSS는 style 태그 내, 외부 CDN/폰트 없음, JS 최소화 (details/summary만)
+`.trim();

package/dist/lib/version-check.js

@@ -43,7 +43,7 @@ async function checkTeamVersion(slug, force) {
         const team = await (0, api_js_1.fetchTeamInfo)(slug);
         (0, update_cache_js_1.updateCacheTimestamp)(slug);
         // Fire-and-forget usage ping (only when cache expired = actual API call happened)
-        (0, api_js_1.sendUsagePing)(slug);
+        (0, api_js_1.sendUsagePing)(slug, entry.version);
         if (team.version !== entry.version) {
             return {
                 type: 'team',

package/package.json

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