relayax-cli 0.1.7 → 0.1.9

package/dist/commands/install.js

@@ -10,6 +10,7 @@ function registerInstall(program) {
         .command('install <slug>')
         .description('에이전트 팀 설치 (감지된 에이전트 CLI에 설치)')
         .option('--path <install_path>', '설치 경로 지정 (기본: ./.claude)')
+        .option('--code <code>', '초대 코드 (invite-only 팀 설치 시 필요)')
         .action(async (slug, opts) => {
         const json = program.opts().json ?? false;
         const installPath = (0, config_js_1.getInstallPath)(opts.path);
@@ -17,14 +18,31 @@ function registerInstall(program) {
         try {
             // 1. Fetch team metadata
             const team = await (0, api_js_1.fetchTeamInfo)(slug);
-            // 2. Download package
+            // 2. Visibility check
+            const visibility = team.visibility ?? 'public';
+            if (visibility === 'login-only') {
+                const token = (0, config_js_1.loadToken)();
+                if (!token) {
+                    const err = { error: 'LOGIN_REQUIRED', visibility: 'login-only', slug, message: '이 팀은 로그인이 필요합니다.' };
+                    console.error(JSON.stringify(err));
+                    process.exit(1);
+                }
+            }
+            else if (visibility === 'invite-only') {
+                if (!opts.code) {
+                    const err = { error: 'INVITE_REQUIRED', visibility: 'invite-only', slug, message: '초대 코드가 필요합니다.' };
+                    console.error(JSON.stringify(err));
+                    process.exit(1);
+                }
+            }
+            // 3. Download package
             const tarPath = await (0, storage_js_1.downloadPackage)(team.package_url, tempDir);
-            // 3. Extract
+            // 4. Extract
             const extractDir = `${tempDir}/extracted`;
             await (0, storage_js_1.extractPackage)(tarPath, extractDir);
-            // 4. Copy files to install_path
+            // 5. Copy files to install_path
             const files = (0, installer_js_1.installTeam)(extractDir, installPath);
-            // 5. Record in installed.json
+            // 6. Record in installed.json
             const installed = (0, config_js_1.loadInstalled)();
             installed[slug] = {
                 version: team.version,
@@ -32,8 +50,8 @@ function registerInstall(program) {
                 files,
             };
             (0, config_js_1.saveInstalled)(installed);
-            // 6. Report install (non-blocking)
-            await (0, api_js_1.reportInstall)(slug);
+            // 7. Report install (non-blocking)
+            await (0, api_js_1.reportInstall)(slug, opts.code);
             const result = {
                 status: 'ok',
                 team: team.name,

package/dist/commands/outdated.d.ts

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

package/dist/commands/outdated.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerOutdated = registerOutdated;
+const api_js_1 = require("../lib/api.js");
+const config_js_1 = require("../lib/config.js");
+function registerOutdated(program) {
+    program
+        .command('outdated')
+        .description('설치된 팀의 업데이트 가능 여부를 확인합니다')
+        .action(async () => {
+        const json = program.opts().json ?? false;
+        const installed = (0, config_js_1.loadInstalled)();
+        const slugs = Object.keys(installed);
+        if (slugs.length === 0) {
+            if (json) {
+                console.log(JSON.stringify([]));
+            }
+            else {
+                console.log('설치된 팀이 없습니다.');
+            }
+            return;
+        }
+        // Fetch latest versions in parallel
+        const results = await Promise.all(slugs.map(async (slug) => {
+            const current = installed[slug].version;
+            try {
+                const team = await (0, api_js_1.fetchTeamInfo)(slug);
+                const latest = team.version;
+                return {
+                    slug,
+                    current,
+                    latest,
+                    status: current === latest ? 'up-to-date' : 'outdated',
+                };
+            }
+            catch {
+                return { slug, current, latest: '?', status: 'unknown' };
+            }
+        }));
+        if (json) {
+            console.log(JSON.stringify(results));
+            return;
+        }
+        const allUpToDate = results.every((r) => r.status === 'up-to-date');
+        if (allUpToDate) {
+            console.log('모든 팀이 최신 버전입니다.');
+            return;
+        }
+        // Determine column widths
+        const COL_TEAM = Math.max(4, ...results.map((r) => r.slug.length));
+        const COL_CURRENT = Math.max(4, ...results.map((r) => `v${r.current}`.length));
+        const COL_LATEST = Math.max(4, ...results.map((r) => `v${r.latest}`.length));
+        const pad = (s, len) => s.padEnd(len);
+        const header = `${pad('팀', COL_TEAM)}  ${pad('현재', COL_CURRENT)}  ${pad('최신', COL_LATEST)}  상태`;
+        const separator = '-'.repeat(header.length);
+        console.log(header);
+        console.log(separator);
+        for (const entry of results) {
+            const statusLabel = entry.status === 'outdated'
+                ? '\x1b[33m업데이트 가능\x1b[0m'
+                : entry.status === 'up-to-date'
+                    ? '\x1b[32m✓ 최신\x1b[0m'
+                    : '\x1b[31m조회 실패\x1b[0m';
+            const slugCol = pad(entry.slug, COL_TEAM);
+            const currentCol = pad(`v${entry.current}`, COL_CURRENT);
+            const latestCol = pad(`v${entry.latest}`, COL_LATEST);
+            console.log(`${slugCol}  ${currentCol}  ${latestCol}  ${statusLabel}`);
+        }
+    });
+}

package/dist/commands/publish.d.ts

@@ -1,2 +1,29 @@
 import { Command } from 'commander';
+export interface RequiresCli {
+    name: string;
+    install?: string;
+}
+export interface RequiresMcp {
+    name: string;
+    package?: string;
+}
+export interface RequiresEnv {
+    name: string;
+    optional?: boolean;
+    description?: string;
+}
+export interface Requires {
+    cli?: RequiresCli[];
+    mcp?: RequiresMcp[];
+    npm?: string[];
+    env?: RequiresEnv[];
+    teams?: string[];
+}
+export interface ContactInfo {
+    email?: string;
+    kakao?: string;
+    x?: string;
+    linkedin?: string;
+    website?: string;
+}
 export declare function registerPublish(program: Command): void;

package/dist/commands/publish.js

@@ -7,111 +7,43 @@ exports.registerPublish = registerPublish;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
 const tar_1 = require("tar");
 const config_js_1 = require("../lib/config.js");
 const VALID_DIRS = ['skills', 'agents', 'rules', 'commands'];
 const IMAGE_EXTS = ['.png', '.jpg', '.jpeg', '.webp'];
 function parseRelayYaml(content) {
-    const result = {};
-    const tags = [];
-    const portfolio = [];
-    let inTags = false;
-    let inPortfolio = false;
-    let inLongDesc = false;
-    let longDescLines = [];
-    let currentPortfolioItem = null;
-    for (const line of content.split('\n')) {
-        const trimmed = line.trim();
-        // long_description multiline (YAML | block)
-        if (inLongDesc) {
-            if (line.startsWith('  ') || line.startsWith('\t') || trimmed === '') {
-                longDescLines.push(line.replace(/^ {2}/, '').replace(/^\t/, ''));
-                continue;
-            }
-            else {
-                inLongDesc = false;
-                result.long_description = longDescLines.join('\n').trim();
-            }
-        }
-        // tags list
-        if (inTags) {
-            if (trimmed.startsWith('- ')) {
-                tags.push(trimmed.slice(2).replace(/^["']|["']$/g, ''));
-                continue;
-            }
-            else {
-                inTags = false;
-            }
-        }
-        // portfolio list
-        if (inPortfolio) {
-            if (trimmed.startsWith('- path:')) {
-                if (currentPortfolioItem?.path) {
-                    portfolio.push({ path: currentPortfolioItem.path, title: currentPortfolioItem.title ?? '', description: currentPortfolioItem.description });
-                }
-                currentPortfolioItem = { path: trimmed.slice(8).replace(/^["']|["']$/g, '').trim() };
-                continue;
-            }
-            if (trimmed.startsWith('title:') && currentPortfolioItem) {
-                currentPortfolioItem.title = trimmed.slice(6).replace(/^["']|["']$/g, '').trim();
-                continue;
-            }
-            if (trimmed.startsWith('description:') && currentPortfolioItem) {
-                currentPortfolioItem.description = trimmed.slice(12).replace(/^["']|["']$/g, '').trim();
-                continue;
-            }
-            if (!trimmed.startsWith('-') && !trimmed.startsWith('title:') && !trimmed.startsWith('description:') && trimmed !== '') {
-                // End of portfolio section
-                if (currentPortfolioItem?.path) {
-                    portfolio.push({ path: currentPortfolioItem.path, title: currentPortfolioItem.title ?? '', description: currentPortfolioItem.description });
-                }
-                currentPortfolioItem = null;
-                inPortfolio = false;
-            }
-            else if (trimmed === '') {
-                continue;
-            }
-        }
-        if (trimmed === 'tags: []') {
-            result.tags = [];
-            continue;
-        }
-        if (trimmed === 'tags:') {
-            inTags = true;
-            continue;
-        }
-        if (trimmed === 'portfolio:') {
-            inPortfolio = true;
-            continue;
-        }
-        if (trimmed === 'portfolio: []') {
-            continue;
-        }
-        if (trimmed === 'long_description: |') {
-            inLongDesc = true;
-            longDescLines = [];
-            continue;
-        }
-        const match = trimmed.match(/^(\w+):\s*["']?(.+?)["']?$/);
-        if (match) {
-            result[match[1]] = match[2];
-        }
-    }
-    // Flush remaining
-    if (inLongDesc && longDescLines.length > 0) {
-        result.long_description = longDescLines.join('\n').trim();
-    }
-    if (currentPortfolioItem?.path) {
-        portfolio.push({ path: currentPortfolioItem.path, title: currentPortfolioItem.title ?? '', description: currentPortfolioItem.description });
-    }
+    const raw = js_yaml_1.default.load(content) ?? {};
+    const tags = Array.isArray(raw.tags)
+        ? raw.tags.map((t) => String(t))
+        : [];
+    const portfolio = Array.isArray(raw.portfolio)
+        ? raw.portfolio.map((p) => ({
+            path: String(p.path ?? ''),
+            title: String(p.title ?? ''),
+            description: p.description ? String(p.description) : undefined,
+        })).filter((p) => p.path)
+        : [];
+    const requires = raw.requires;
+    const rawVisibility = String(raw.visibility ?? '');
+    const visibility = rawVisibility === 'login-only' ? 'login-only'
+        : rawVisibility === 'invite-only' ? 'invite-only'
+            : rawVisibility === 'public' ? 'public'
+                : undefined;
     return {
-        name: String(result.name ?? ''),
-        slug: String(result.slug ?? ''),
-        description: String(result.description ?? ''),
-        version: String(result.version ?? '1.0.0'),
-        long_description: result.long_description,
+        name: String(raw.name ?? ''),
+        slug: String(raw.slug ?? ''),
+        description: String(raw.description ?? ''),
+        version: String(raw.version ?? '1.0.0'),
+        changelog: raw.changelog ? String(raw.changelog) : undefined,
+        long_description: raw.long_description ? String(raw.long_description) : undefined,
         tags,
         portfolio,
+        requires,
+        welcome: raw.welcome ? String(raw.welcome) : undefined,
+        contact: raw.contact,
+        visibility,
+        invite_code: raw.invite_code ? String(raw.invite_code) : undefined,
     };
 }
 function detectCommands(teamDir) {
@@ -251,13 +183,106 @@ function registerPublish(program) {
         const json = program.opts().json ?? false;
         const teamDir = process.cwd();
         const relayYamlPath = path_1.default.join(teamDir, 'relay.yaml');
+        const isTTY = Boolean(process.stdin.isTTY) && !json;
         // Check relay.yaml exists
         if (!fs_1.default.existsSync(relayYamlPath)) {
-            console.error(JSON.stringify({
-                error: 'NOT_INITIALIZED',
-                message: 'relay.yaml이 없습니다. 먼저 `relay init`을 실행하세요.',
-            }));
-            process.exit(1);
+            if (!isTTY) {
+                console.error(JSON.stringify({
+                    error: 'NOT_INITIALIZED',
+                    message: 'relay.yaml이 없습니다. 먼저 `relay init`을 실행하세요.',
+                }));
+                process.exit(1);
+            }
+            // Interactive onboarding: create relay.yaml
+            const { input: promptInput, select: promptSelect, confirm: promptConfirm } = await import('@inquirer/prompts');
+            const dirName = path_1.default.basename(teamDir);
+            const defaultSlug = dirName.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+            console.error('\n\x1b[36m릴레이 팀 패키지를 초기화합니다.\x1b[0m');
+            console.error('relay.yaml을 생성하기 위해 몇 가지 정보를 입력해주세요.\n');
+            const name = await promptInput({
+                message: '팀 이름:',
+                default: dirName,
+            });
+            const slug = await promptInput({
+                message: '슬러그 (URL에 사용되는 고유 식별자):',
+                default: defaultSlug,
+            });
+            const description = await promptInput({
+                message: '팀 설명 (필수):',
+                validate: (v) => v.trim().length > 0 ? true : '설명을 입력해주세요.',
+            });
+            const tagsRaw = await promptInput({
+                message: '태그 (쉼표로 구분, 선택):',
+                default: '',
+            });
+            const visibility = await promptSelect({
+                message: '공개 범위:',
+                choices: [
+                    { name: '전체 공개', value: 'public' },
+                    { name: '로그인 사용자만', value: 'login-only' },
+                    { name: '초대 코드 필요', value: 'invite-only' },
+                ],
+            });
+            let invite_code;
+            if (visibility === 'invite-only') {
+                invite_code = await promptInput({
+                    message: '초대 코드:',
+                    validate: (v) => v.trim().length > 0 ? true : '초대 코드를 입력해주세요.',
+                });
+            }
+            // Welcome message section
+            console.error('\n\x1b[33m┌─────────────────────────────────────────────────────────────┐\x1b[0m');
+            console.error('\x1b[33m│  welcome 메시지란?                                          │\x1b[0m');
+            console.error('\x1b[33m│  설치할 때마다 이 메시지와 연락처가 설치자에게 전달됩니다.  │\x1b[0m');
+            console.error('\x1b[33m│  (설치 = 명함 전달)                                         │\x1b[0m');
+            console.error('\x1b[33m└─────────────────────────────────────────────────────────────┘\x1b[0m\n');
+            const wantsWelcome = await promptConfirm({
+                message: 'welcome 메시지를 작성하시겠습니까?',
+                default: false,
+            });
+            let welcome;
+            let contactEmail;
+            let contactKakao;
+            if (wantsWelcome) {
+                welcome = await promptInput({
+                    message: 'welcome 메시지:',
+                    validate: (v) => v.trim().length > 0 ? true : '메시지를 입력해주세요.',
+                });
+                contactEmail = await promptInput({
+                    message: '이메일 (선택):',
+                    default: '',
+                });
+                contactKakao = await promptInput({
+                    message: '카카오 오픈채팅 링크 (선택):',
+                    default: '',
+                });
+            }
+            const tags = tagsRaw
+                .split(',')
+                .map((t) => t.trim())
+                .filter(Boolean);
+            const yamlData = {
+                name,
+                slug,
+                description,
+                version: '1.0.0',
+                tags,
+                visibility,
+            };
+            if (invite_code)
+                yamlData.invite_code = invite_code;
+            if (welcome)
+                yamlData.welcome = welcome;
+            if (contactEmail || contactKakao) {
+                const contact = {};
+                if (contactEmail)
+                    contact.email = contactEmail;
+                if (contactKakao)
+                    contact.kakao = contactKakao;
+                yamlData.contact = contact;
+            }
+            fs_1.default.writeFileSync(relayYamlPath, js_yaml_1.default.dump(yamlData, { lineWidth: 120 }), 'utf-8');
+            console.error(`\n\x1b[32m✓ relay.yaml이 생성되었습니다.\x1b[0m\n`);
         }
         // Parse relay.yaml
         const yamlContent = fs_1.default.readFileSync(relayYamlPath, 'utf-8');
@@ -269,6 +294,10 @@ function registerPublish(program) {
             }));
             process.exit(1);
         }
+        // Welcome hint when welcome field is missing and TTY is available
+        if (isTTY && !config.welcome) {
+            console.error('💡 welcome 메시지를 추가하면 설치할 때마다 명함이 전달됩니다. relay.yaml에 welcome 필드를 추가해보세요.');
+        }
         // Validate structure
         const hasDirs = VALID_DIRS.some((d) => {
             const dirPath = path_1.default.join(teamDir, d);
@@ -283,7 +312,7 @@ function registerPublish(program) {
             }));
             process.exit(1);
         }
-        // Get token
+        // Get token (checked before tarball creation)
         const token = opts.token ?? process.env.RELAY_TOKEN ?? (0, config_js_1.loadToken)();
         if (!token) {
             console.error(JSON.stringify({
@@ -310,6 +339,12 @@ function registerPublish(program) {
             commands: detectedCommands,
             components,
             version: config.version,
+            changelog: config.changelog,
+            requires: config.requires,
+            welcome: config.welcome,
+            contact: config.contact,
+            visibility: config.visibility,
+            invite_code: config.invite_code,
         };
         if (!json) {
             console.error(`패키지 생성 중... (${config.name} v${config.version})`);

package/dist/commands/update.d.ts

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

package/dist/commands/update.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerUpdate = registerUpdate;
+const api_js_1 = require("../lib/api.js");
+const storage_js_1 = require("../lib/storage.js");
+const installer_js_1 = require("../lib/installer.js");
+const config_js_1 = require("../lib/config.js");
+function registerUpdate(program) {
+    program
+        .command('update <slug>')
+        .description('설치된 에이전트 팀을 최신 버전으로 업데이트합니다')
+        .option('--path <install_path>', '설치 경로 지정 (기본: ./.claude)')
+        .option('--code <code>', '초대 코드 (invite-only 팀 업데이트 시 필요)')
+        .action(async (slug, opts) => {
+        const json = program.opts().json ?? false;
+        const installPath = (0, config_js_1.getInstallPath)(opts.path);
+        const tempDir = (0, storage_js_1.makeTempDir)();
+        try {
+            // Check installed.json for current version
+            const installed = (0, config_js_1.loadInstalled)();
+            const currentEntry = installed[slug];
+            const currentVersion = currentEntry?.version ?? null;
+            // Fetch latest team metadata
+            const team = await (0, api_js_1.fetchTeamInfo)(slug);
+            const latestVersion = team.version;
+            if (currentVersion && currentVersion === latestVersion) {
+                if (json) {
+                    console.log(JSON.stringify({ status: 'up-to-date', slug, version: latestVersion }));
+                }
+                else {
+                    console.log(`이미 최신 버전입니다  (${slug} v${latestVersion})`);
+                }
+                return;
+            }
+            // Visibility check
+            const visibility = team.visibility ?? 'public';
+            if (visibility === 'login-only') {
+                const token = (0, config_js_1.loadToken)();
+                if (!token) {
+                    console.error('이 팀은 로그인이 필요합니다. `relay login`을 먼저 실행하세요.');
+                    process.exit(1);
+                }
+            }
+            else if (visibility === 'invite-only') {
+                if (!opts.code) {
+                    console.error('초대 코드가 필요합니다. `relay update ' + slug + ' --code <code>`로 업데이트하세요.');
+                    process.exit(1);
+                }
+            }
+            // Download package
+            const tarPath = await (0, storage_js_1.downloadPackage)(team.package_url, tempDir);
+            // Extract
+            const extractDir = `${tempDir}/extracted`;
+            await (0, storage_js_1.extractPackage)(tarPath, extractDir);
+            // Copy files to install_path
+            const files = (0, installer_js_1.installTeam)(extractDir, installPath);
+            // Update installed.json with new version
+            installed[slug] = {
+                version: latestVersion,
+                installed_at: new Date().toISOString(),
+                files,
+            };
+            (0, config_js_1.saveInstalled)(installed);
+            // Report install (non-blocking)
+            await (0, api_js_1.reportInstall)(slug, opts.code);
+            const result = {
+                status: 'updated',
+                slug,
+                from_version: currentVersion,
+                version: latestVersion,
+                files_installed: files.length,
+                install_path: installPath,
+            };
+            if (json) {
+                console.log(JSON.stringify(result));
+            }
+            else {
+                const fromLabel = currentVersion ? `v${currentVersion} → ` : '';
+                console.log(`\n\x1b[32m✓ ${team.name} ${fromLabel}v${latestVersion} 업데이트 완료\x1b[0m`);
+                console.log(`  설치 위치: \x1b[36m${installPath}\x1b[0m`);
+                console.log(`  파일 수:   ${files.length}개`);
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(JSON.stringify({ error: 'UPDATE_FAILED', message }));
+            process.exit(1);
+        }
+        finally {
+            (0, storage_js_1.removeTempDir)(tempDir);
+        }
+    });
+}

package/dist/index.js

@@ -9,6 +9,8 @@ const list_js_1 = require("./commands/list.js");
 const uninstall_js_1 = require("./commands/uninstall.js");
 const publish_js_1 = require("./commands/publish.js");
 const login_js_1 = require("./commands/login.js");
+const update_js_1 = require("./commands/update.js");
+const outdated_js_1 = require("./commands/outdated.js");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const pkg = require('../package.json');
 const program = new commander_1.Command();
@@ -24,4 +26,6 @@ program
 (0, uninstall_js_1.registerUninstall)(program);
 (0, publish_js_1.registerPublish)(program);
 (0, login_js_1.registerLogin)(program);
+(0, update_js_1.registerUpdate)(program);
+(0, outdated_js_1.registerOutdated)(program);
 program.parse();

package/dist/lib/api.d.ts

@@ -1,4 +1,10 @@
 import type { TeamRegistryInfo, SearchResult } from '../types.js';
 export declare function fetchTeamInfo(slug: string): Promise<TeamRegistryInfo>;
 export declare function searchTeams(query: string, tag?: string): Promise<SearchResult[]>;
-export declare function reportInstall(slug: string): Promise<void>;
+export interface TeamVersionInfo {
+    version: string;
+    changelog: string | null;
+    created_at: string;
+}
+export declare function fetchTeamVersions(slug: string): Promise<TeamVersionInfo[]>;
+export declare function reportInstall(slug: string, code?: string): Promise<void>;

package/dist/lib/api.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.fetchTeamInfo = fetchTeamInfo;
 exports.searchTeams = searchTeams;
+exports.fetchTeamVersions = fetchTeamVersions;
 exports.reportInstall = reportInstall;
 const config_js_1 = require("./config.js");
 async function fetchTeamInfo(slug) {
@@ -26,8 +27,18 @@ async function searchTeams(query, tag) {
     const data = (await res.json());
     return data.results;
 }
-async function reportInstall(slug) {
-    const url = `${config_js_1.API_URL}/api/registry/${slug}/install`;
+async function fetchTeamVersions(slug) {
+    const url = `${config_js_1.API_URL}/api/registry/${slug}/versions`;
+    const res = await fetch(url);
+    if (!res.ok) {
+        const body = await res.text();
+        throw new Error(`버전 목록 조회 실패 (${res.status}): ${body}`);
+    }
+    return res.json();
+}
+async function reportInstall(slug, code) {
+    const base = `${config_js_1.API_URL}/api/registry/${slug}/install`;
+    const url = code ? `${base}?code=${encodeURIComponent(code)}` : base;
     await fetch(url, { method: 'POST' }).catch(() => {
         // non-critical: ignore errors
     });

package/dist/lib/command-adapter.js

@@ -52,25 +52,47 @@ exports.RELAY_COMMANDS = [
     {
         id: 'relay-install',
         description: 'relay 마켓플레이스에서 에이전트 팀을 설치합니다',
-        body: `요청된 에이전트 팀을 relay 마켓플레이스에서 다운로드하여 현재 프로젝트에 설치합니다.
+        body: `요청된 에이전트 팀을 relay 마켓플레이스에서 다운로드하여 현재 프로젝트에 설치하고, 의존성을 확인·설치합니다.
 
 ## 실행 방법
 
-1. \`relay install <slug>\` 명령어를 실행합니다.
-2. 설치 결과를 확인합니다:
-   - 설치된 파일 수
-   - 사용 가능해진 커맨드 목록
-3. 각 커맨드의 사용법을 간단히 안내합니다.
-4. "바로 사용해볼까요?"라고 제안합니다.
-5. 사용자가 원하면 첫 번째 커맨드를 실행해봅니다.
+### 1. 팀 설치
+- \`relay install <slug>\` 명령어를 실행합니다.
+- 설치 결과를 확인합니다 (설치된 파일 수, 사용 가능한 커맨드 목록).
+
+### 2. 의존성 확인 및 설치
+설치된 팀의 relay.yaml에 \`requires\` 섹션이 있으면 각 항목을 확인하고 처리합니다:
+
+- **cli**: \`which <name>\`으로 확인 → 없으면 install 명령 실행 또는 안내
+- **npm**: \`npm list <package>\`로 확인 → 없으면 \`npm install\`
+- **env**: 환경변수 확인 → optional이면 경고, 필수면 설정 안내
+- **mcp**: MCP 서버 설정 안내
+- **teams**: \`relay install <team>\`으로 재귀 설치
+
+### 3. 제작자 소개 (welcome 메시지)
+- API 응답의 \`welcome\` 필드가 있으면 제작자 메시지를 보여줍니다.
+- \`contact\` 필드가 있으면 연락처도 함께 표시합니다.
+
+### 4. 팔로우 제안
+- "이 팀의 제작자 @username을 팔로우할까요?"라고 제안합니다.
+- 인증되어 있으면 POST /api/follows로 팔로우합니다.
+- 미인증이면 \`relay login\` 후 팔로우할 수 있다고 안내합니다.
+
+### 5. 완료 안내
+- 사용 가능한 커맨드 안내
+- "바로 사용해볼까요?" 제안
 
 ## 예시
 
 사용자: /relay-install contents-team
 → relay install contents-team 실행
-→ "설치 완료! 다음 커맨드를 사용할 수 있습니다:"
-→ /cardnews - 카드뉴스 제작
-→ /detailpage - 상세페이지 제작
+→ requires 확인: ✓ playwright, ✓ sharp 설치됨
+→ ✓ 설치 완료!
+→ ┌─ @haemin ──────────────────────────────┐
+→ │ contents-team을 설치해주셔서 감사합니다! │
+→ │ 💬 카카오톡  📧 이메일                  │
+→ └─────────────────────────────────────────┘
+→ "@haemin을 팔로우할까요?" → Yes → ✓ 팔로우 완료
 → "바로 /cardnews를 사용해볼까요?"`,
     },
     {
@@ -80,12 +102,17 @@ exports.RELAY_COMMANDS = [
 
 ## 실행 단계
 
-### 1. 팀 구조 분석
+### 1. 인증 확인 (가장 먼저)
+- \`cat ~/.relay/token\` 또는 환경변수 RELAY_TOKEN으로 토큰 존재 여부를 확인합니다.
+- 미인증이면 즉시 안내: "먼저 \`relay login\`으로 로그인이 필요합니다." → 로그인 후 재실행 안내.
+- 인증되어 있으면 다음 단계로 진행합니다.
+
+### 2. 팀 구조 분석
 - skills/, agents/, rules/, commands/ 디렉토리를 탐색합니다.
 - 각 파일의 이름과 description을 추출합니다.
 - relay.yaml이 있으면 읽고, 없으면 사용자에게 팀 정보(name, slug, description, tags)를 물어보고 생성합니다.
 
-### 2. 포트폴리오 생성
+### 3. 포트폴리오 생성
 
 #### Layer 1: 팀 구성 시각화 (자동)
 - 분석된 팀 구조를 HTML로 생성합니다. 내용:
@@ -105,18 +132,15 @@ exports.RELAY_COMMANDS = [
 - 사용자가 포트폴리오에 포함할 항목을 선택합니다.
 - 선택된 이미지를 ./portfolio/에 저장합니다.
 
-### 3. 메타데이터 생성
+### 4. 메타데이터 생성
 - description: skills 내용 기반으로 자동 생성합니다.
 - long_description: 팀 소개 마크다운을 자동 생성합니다 (README.md가 있으면 활용).
 - tags: 팀 특성에 맞는 태그를 추천합니다.
 - 사용자에게 확인: "이대로 배포할까요?"
 
-### 4. relay.yaml 업데이트
+### 5. relay.yaml 업데이트
 - 생성/수정된 메타데이터와 포트폴리오 경로를 relay.yaml에 반영합니다.
 
-### 5. 인증 확인
-- \`relay login\`으로 인증 상태를 확인합니다. 미인증이면 로그인을 안내합니다.
-
 ### 6. 배포
 - \`relay publish\` 명령어를 실행합니다.
 - 배포 결과와 마켓플레이스 URL을 보여줍니다.

package/dist/types.d.ts

@@ -20,6 +20,7 @@ export interface TeamRegistryInfo {
         rules: number;
         skills: number;
     };
+    visibility?: "public" | "login-only" | "invite-only";
 }
 export interface SearchResult {
     slug: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "relayax-cli",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "RelayAX Agent Team Marketplace CLI - Install and manage agent teams",
   "main": "dist/index.js",
   "bin": {
@@ -35,9 +35,11 @@
   "dependencies": {
     "@inquirer/prompts": "^8.3.2",
     "commander": "^13.1.0",
+    "js-yaml": "^4.1.1",
     "tar": "^7.4.0"
   },
   "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
     "@types/node": "^20",
     "typescript": "^5"
   }