relayax-cli 0.2.19 → 0.2.22

package/dist/commands/create.js

@@ -64,9 +64,8 @@ function registerCreate(program) {
             visibility = await promptSelect({
                 message: '공개 범위:',
                 choices: [
-                    { name: '전체 공개', value: 'public' },
-                    { name: '로그인 사용자만', value: 'login-only' },
-                    { name: '초대 코드 필요', value: 'invite-only' },
+                    { name: '공개', value: 'public' },
+                    { name: '비공개 (Space 멤버만)', value: 'private' },
                 ],
             });
         }

package/dist/commands/init.d.ts

@@ -1,2 +1,6 @@
 import { Command } from 'commander';
+/**
+ * 글로벌 User 커맨드가 이미 설치되어 있는지 확인한다.
+ */
+export declare function hasGlobalUserCommands(): boolean;
 export declare function registerInit(program: Command): void;

package/dist/commands/init.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasGlobalUserCommands = hasGlobalUserCommands;
 exports.registerInit = registerInit;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
@@ -115,8 +116,11 @@ function registerInit(program) {
         .description('에이전트 CLI에 relay 슬래시 커맨드를 설치합니다')
         .option('--tools <tools>', '설치할 에이전트 CLI 지정 (all 또는 쉼표 구분)')
         .option('--update', '이미 설치된 슬래시 커맨드를 최신 버전으로 업데이트')
+        .option('--auto', '대화형 프롬프트 없이 자동으로 모든 감지된 CLI에 설치')
         .action(async (opts) => {
         const json = program.opts().json ?? false;
+        // auto mode: --auto flag, --json flag, or stdin is not a TTY
+        const autoMode = opts.auto === true || json || !process.stdin.isTTY;
         const projectPath = process.cwd();
         const detected = (0, ai_tools_js_1.detectAgentCLIs)(projectPath);
         const detectedIds = new Set(detected.map((t) => t.value));
@@ -154,7 +158,8 @@ function registerInit(program) {
             else if (opts.tools) {
                 targetToolIds = resolveTools(opts.tools);
             }
-            else if (!json && process.stdin.isTTY) {
+            else if (!autoMode) {
+                // interactive mode: only when stdin is a TTY and not --auto/--json
                 showWelcome();
                 if (detected.length > 0) {
                     console.log(`  감지된 에이전트 CLI: \x1b[36m${detected.map((t) => t.name).join(', ')}\x1b[0m\n`);
@@ -171,18 +176,12 @@ function registerInit(program) {
                 }
             }
             else {
-                if (detected.length === 0) {
-                    if (json) {
-                        console.error(JSON.stringify({
-                            error: 'NO_AGENT_CLI',
-                            message: '에이전트 CLI 디렉토리를 찾을 수 없습니다. --tools 옵션으로 지정하세요.',
-                        }));
-                    }
-                    // 글로벌은 설치했으므로 에러로 종료하지 않음
-                    targetToolIds = [];
+                // auto mode: use detected CLIs, or all available tools if none detected
+                if (detected.length > 0) {
+                    targetToolIds = detected.map((t) => t.value);
                 }
                 else {
-                    targetToolIds = detected.map((t) => t.value);
+                    targetToolIds = ai_tools_js_1.AI_TOOLS.map((t) => t.value);
                 }
             }
             // Builder 커맨드 설치 (기존 파일 중 현재 목록에 없는 것 제거)
@@ -213,7 +212,7 @@ function registerInit(program) {
                 localResults.push({ tool: tool.name, commands: installedCommands });
             }
         }
-        else if (!json && process.stdin.isTTY) {
+        else if (!autoMode) {
             // User 모드: 글로벌만 설치, 안내 표시
             showWelcome();
         }

package/dist/commands/install.js

@@ -11,34 +11,139 @@ 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");
+const join_js_1 = require("./join.js");
+const init_js_1 = require("./init.js");
+/**
+ * slugInput이 "@spaces/{spaceSlug}/{teamSlug}" 형식이면 파싱해 반환.
+ * 아니면 null.
+ */
+function parseSpaceTarget(slugInput) {
+    const m = slugInput.match(/^@spaces\/([a-z0-9][a-z0-9-]*)\/([a-z0-9][a-z0-9-]*)$/);
+    if (!m)
+        return null;
+    return {
+        spaceSlug: m[1],
+        rawTeamSlug: m[2],
+        teamSlug: `@${m[1]}/${m[2]}`,
+    };
+}
 function registerInstall(program) {
     program
         .command('install <slug>')
         .description('에이전트 팀 패키지를 .relay/teams/에 다운로드합니다')
-        .action(async (slugInput) => {
+        .option('--no-guide', 'GUIDE.html 브라우저 자동 오픈을 비활성화합니다')
+        .option('--join-code <code>', 'Space 초대 코드 (Space 팀 설치 시 자동 가입)')
+        .action(async (slugInput, opts) => {
         const json = program.opts().json ?? false;
         const projectPath = process.cwd();
         const tempDir = (0, storage_js_1.makeTempDir)();
+        if (!(0, init_js_1.hasGlobalUserCommands)()) {
+            if (!json) {
+                console.error('\x1b[33m⚠ relay init이 실행되지 않았습니다. 먼저 relay init을 실행하세요.\x1b[0m');
+            }
+            else {
+                console.error(JSON.stringify({ error: 'NOT_INITIALIZED', message: 'relay init을 먼저 실행하세요.' }));
+            }
+            process.exit(1);
+        }
         try {
-            // 0. Resolve scoped slug
-            const parsed = await (0, slug_js_1.resolveSlug)(slugInput);
-            const slug = parsed.full;
-            // 1. Fetch team metadata
-            const team = await (0, api_js_1.fetchTeamInfo)(slug);
+            // 0. @spaces/{spaceSlug}/{teamSlug} 형식 감지 및 파싱
+            const spaceTarget = parseSpaceTarget(slugInput);
+            // 0a. --join-code가 있으면 먼저 Space 가입 시도
+            if (opts.joinCode && spaceTarget) {
+                try {
+                    const { spaceName } = await (0, join_js_1.joinSpace)(spaceTarget.spaceSlug, opts.joinCode);
+                    if (!json) {
+                        console.log(`\x1b[32m✅ ${spaceName} Space에 가입했습니다\x1b[0m`);
+                    }
+                }
+                catch (joinErr) {
+                    const joinMsg = joinErr instanceof Error ? joinErr.message : String(joinErr);
+                    // 이미 멤버인 경우 설치 계속 진행
+                    if (joinMsg !== 'ALREADY_MEMBER') {
+                        if (!json) {
+                            console.error(`\x1b[33m경고: Space 가입 실패 — ${joinMsg}\x1b[0m`);
+                        }
+                    }
+                }
+            }
+            // 0b. Resolve scoped slug and fetch team metadata
+            let team;
+            let slug;
+            let parsed;
+            if (spaceTarget) {
+                // Space 팀: POST /api/spaces/{spaceSlug}/teams/{teamSlug}/install
+                // This verifies membership, increments install count, and returns metadata.
+                try {
+                    team = await (0, api_js_1.installSpaceTeam)(spaceTarget.spaceSlug, spaceTarget.rawTeamSlug);
+                }
+                catch (fetchErr) {
+                    const fetchMsg = fetchErr instanceof Error ? fetchErr.message : String(fetchErr);
+                    if (fetchMsg.includes('403')) {
+                        if (json) {
+                            console.error(JSON.stringify({
+                                error: 'SPACE_ONLY',
+                                message: '이 팀은 Space 멤버만 설치 가능합니다.',
+                                spaceSlug: spaceTarget.spaceSlug,
+                            }));
+                        }
+                        else {
+                            console.error('\x1b[31m이 팀은 Space 멤버만 설치 가능합니다.\x1b[0m');
+                            console.error(`\x1b[33mSpace 관리자에게 초대 코드를 요청하세요: relay join ${spaceTarget.spaceSlug} --code <코드>\x1b[0m`);
+                        }
+                        process.exit(1);
+                    }
+                    throw fetchErr;
+                }
+                // slug from server is "@spaces/{spaceSlug}/{teamSlug}" — derive local path parts
+                parsed = { owner: spaceTarget.spaceSlug, name: spaceTarget.rawTeamSlug, full: team.slug };
+                slug = team.slug;
+            }
+            else {
+                // Normal registry install
+                const resolveInput = slugInput;
+                parsed = await (0, slug_js_1.resolveSlug)(resolveInput);
+                slug = parsed.full;
+                try {
+                    team = await (0, api_js_1.fetchTeamInfo)(slug);
+                }
+                catch (fetchErr) {
+                    const fetchMsg = fetchErr instanceof Error ? fetchErr.message : String(fetchErr);
+                    if (fetchMsg.includes('403')) {
+                        if (json) {
+                            console.error(JSON.stringify({
+                                error: 'SPACE_ONLY',
+                                message: '이 팀은 Space 멤버만 설치 가능합니다.',
+                                slug,
+                            }));
+                        }
+                        else {
+                            console.error('\x1b[31m이 팀은 Space 멤버만 설치 가능합니다.\x1b[0m');
+                            console.error('\x1b[33mSpace 관리자에게 초대 코드를 요청하세요.\x1b[0m');
+                        }
+                        process.exit(1);
+                    }
+                    throw fetchErr;
+                }
+            }
             const teamDir = path_1.default.join(projectPath, '.relay', 'teams', parsed.owner, parsed.name);
             // 2. Visibility check
             const visibility = team.visibility ?? 'public';
-            if (visibility === 'login-only' || visibility === 'invite-only') {
+            if (visibility === 'private') {
                 const token = await (0, config_js_1.getValidToken)();
                 if (!token) {
-                    console.error(JSON.stringify({
-                        error: 'LOGIN_REQUIRED',
-                        visibility,
-                        slug,
-                        message: visibility === 'invite-only'
-                            ? '이 팀은 초대받은 사용자만 설치할 수 있습니다. 로그인이 필요합니다.'
-                            : '이 팀은 로그인이 필요합니다.',
-                    }));
+                    if (json) {
+                        console.error(JSON.stringify({
+                            error: 'LOGIN_REQUIRED',
+                            visibility,
+                            slug,
+                            message: '이 팀은 Space 멤버만 설치할 수 있습니다. 로그인이 필요합니다.',
+                        }));
+                    }
+                    else {
+                        console.error('\x1b[31m이 팀은 Space 멤버만 설치할 수 있습니다. relay login 을 먼저 실행하세요.\x1b[0m');
+                    }
                     process.exit(1);
                 }
             }
@@ -50,6 +155,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;
@@ -66,12 +173,13 @@ function registerInstall(program) {
                 return count;
             }
             const fileCount = countFiles(teamDir);
-            // 6. Record in installed.json
+            // 6. Record in installed.json (space_slug 포함)
             const installed = (0, config_js_1.loadInstalled)();
             installed[slug] = {
                 version: team.version,
                 installed_at: new Date().toISOString(),
                 files: [teamDir],
+                ...(spaceTarget ? { space_slug: spaceTarget.spaceSlug } : {}),
             };
             (0, config_js_1.saveInstalled)(installed);
             // 7. Report install (non-blocking)
@@ -84,6 +192,7 @@ function registerInstall(program) {
                 commands: team.commands,
                 files: fileCount,
                 install_path: teamDir,
+                ...(spaceTarget ? { space_slug: spaceTarget.spaceSlug } : {}),
             };
             if (json) {
                 console.log(JSON.stringify(result));
@@ -121,6 +230,28 @@ 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}`);
+                    }
+                }
+                // Usage hint
+                if (team.commands && team.commands.length > 0) {
+                    console.log(`\n\x1b[33m💡 시작하려면 채팅에 아래 명령어를 입력하세요:\x1b[0m`);
+                    console.log(`  \x1b[1m/${team.commands[0].name}\x1b[0m`);
+                }
+                else {
+                    console.log(`\n\x1b[33m💡 설치 완료! AI 에이전트에서 사용할 수 있습니다.\x1b[0m`);
+                }
                 console.log('\n  에이전트가 /relay-install로 환경을 구성합니다.');
             }
         }

package/dist/commands/join.d.ts

@@ -0,0 +1,5 @@
+import { Command } from 'commander';
+export declare function joinSpace(spaceSlug: string, code: string): Promise<{
+    spaceName: string;
+}>;
+export declare function registerJoin(program: Command): void;

package/dist/commands/join.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.joinSpace = joinSpace;
+exports.registerJoin = registerJoin;
+const config_js_1 = require("../lib/config.js");
+const init_js_1 = require("./init.js");
+async function fetchSpaceTeams(spaceSlug, token) {
+    const res = await fetch(`${config_js_1.API_URL}/api/spaces/${spaceSlug}/teams`, {
+        headers: { Authorization: `Bearer ${token}` },
+        signal: AbortSignal.timeout(5000),
+    });
+    if (!res.ok)
+        throw new Error(`${res.status}`);
+    const data = (await res.json());
+    if (Array.isArray(data))
+        return data;
+    return data.teams ?? [];
+}
+async function joinSpace(spaceSlug, code) {
+    const token = await (0, config_js_1.getValidToken)();
+    if (!token) {
+        throw new Error('LOGIN_REQUIRED');
+    }
+    const res = await fetch(`${config_js_1.API_URL}/api/spaces/${spaceSlug}/join`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${token}`,
+        },
+        body: JSON.stringify({ code }),
+    });
+    const body = (await res.json().catch(() => ({})));
+    if (!res.ok) {
+        const errCode = body.error ?? String(res.status);
+        switch (errCode) {
+            case 'INVALID_CODE':
+                throw new Error('초대 코드가 올바르지 않습니다.');
+            case 'EXPIRED_CODE':
+                throw new Error('초대 코드가 만료되었습니다.');
+            case 'ALREADY_MEMBER':
+                throw new Error('ALREADY_MEMBER');
+            default:
+                throw new Error(body.message ?? `Space 가입 실패 (${res.status})`);
+        }
+    }
+    return { spaceName: body.space_name ?? spaceSlug };
+}
+function registerJoin(program) {
+    program
+        .command('join <slug>')
+        .description('Space에 초대 코드로 가입합니다')
+        .requiredOption('--code <code>', '초대 코드 (UUID)')
+        .action(async (slug, opts) => {
+        const json = program.opts().json ?? false;
+        if (!(0, init_js_1.hasGlobalUserCommands)()) {
+            if (!json) {
+                console.error('\x1b[33m⚠ relay init이 실행되지 않았습니다. 먼저 relay init을 실행하세요.\x1b[0m');
+            }
+            else {
+                console.error(JSON.stringify({ error: 'NOT_INITIALIZED', message: 'relay init을 먼저 실행하세요.' }));
+            }
+            process.exit(1);
+        }
+        try {
+            const { spaceName } = await joinSpace(slug, opts.code);
+            if (json) {
+                // best-effort: fetch teams for JSON response
+                let teams = [];
+                try {
+                    const token = await (0, config_js_1.getValidToken)();
+                    if (token)
+                        teams = await fetchSpaceTeams(slug, token);
+                }
+                catch {
+                    // ignore
+                }
+                console.log(JSON.stringify({ status: 'ok', space: slug, space_name: spaceName, teams: teams.map((t) => ({ slug: t.slug, name: t.name })) }));
+            }
+            else {
+                console.log(`\x1b[32m✅ ${spaceName} Space에 가입했습니다\x1b[0m`);
+                // best-effort: show available teams
+                try {
+                    const token = await (0, config_js_1.getValidToken)();
+                    if (token) {
+                        const teams = await fetchSpaceTeams(slug, token);
+                        if (teams.length === 0) {
+                            console.log('\n아직 추가된 팀이 없습니다.');
+                        }
+                        else {
+                            console.log('\n\x1b[1m📦 사용 가능한 팀:\x1b[0m');
+                            for (const t of teams) {
+                                const desc = t.description ? `  \x1b[90m— ${t.description}\x1b[0m` : '';
+                                console.log(`  \x1b[36m•\x1b[0m \x1b[1m${t.slug}\x1b[0m${desc}`);
+                            }
+                            console.log(`\n\x1b[33m💡 설치: relay install @spaces/${slug}/<팀슬러그>\x1b[0m`);
+                        }
+                    }
+                }
+                catch {
+                    // ignore — success message was already shown
+                }
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (message === 'ALREADY_MEMBER') {
+                if (json) {
+                    console.log(JSON.stringify({ status: 'already_member', space: slug }));
+                }
+                else {
+                    console.log(`\x1b[33m이미 ${slug} Space의 멤버입니다.\x1b[0m`);
+                }
+                return;
+            }
+            if (message === 'LOGIN_REQUIRED') {
+                if (json) {
+                    console.error(JSON.stringify({
+                        error: 'LOGIN_REQUIRED',
+                        message: '로그인이 필요합니다. relay login 을 먼저 실행하세요.',
+                    }));
+                }
+                else {
+                    console.error('\x1b[31m오류: 로그인이 필요합니다.\x1b[0m');
+                    console.error('  relay login 을 먼저 실행하세요.');
+                }
+                process.exit(1);
+            }
+            if (json) {
+                console.error(JSON.stringify({ error: 'JOIN_FAILED', message }));
+            }
+            else {
+                console.error(`\x1b[31m오류: ${message}\x1b[0m`);
+            }
+            process.exit(1);
+        }
+    });
+}

package/dist/commands/list.js

@@ -2,12 +2,73 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerList = registerList;
 const config_js_1 = require("../lib/config.js");
+async function fetchSpaceTeamList(spaceSlug, token) {
+    const res = await fetch(`${config_js_1.API_URL}/api/spaces/${spaceSlug}/teams`, {
+        headers: { Authorization: `Bearer ${token}` },
+        signal: AbortSignal.timeout(8000),
+    });
+    if (!res.ok) {
+        const body = await res.text();
+        throw new Error(`Space 팀 목록 조회 실패 (${res.status}): ${body}`);
+    }
+    const data = (await res.json());
+    if (Array.isArray(data))
+        return data;
+    return data.teams ?? [];
+}
 function registerList(program) {
     program
         .command('list')
         .description('설치된 에이전트 팀 목록')
-        .action(() => {
+        .option('--space <slug>', 'Space 마켓플레이스의 팀 목록 조회')
+        .action(async (opts) => {
         const json = program.opts().json ?? false;
+        // --space 옵션: Space 마켓플레이스 팀 목록
+        if (opts.space) {
+            const spaceSlug = opts.space;
+            const token = await (0, config_js_1.getValidToken)();
+            if (!token) {
+                if (json) {
+                    console.error(JSON.stringify({ error: 'LOGIN_REQUIRED', message: '로그인이 필요합니다. relay login을 먼저 실행하세요.' }));
+                }
+                else {
+                    console.error('\x1b[31m오류: 로그인이 필요합니다.\x1b[0m');
+                    console.error('  relay login을 먼저 실행하세요.');
+                }
+                process.exit(1);
+            }
+            try {
+                const teams = await fetchSpaceTeamList(spaceSlug, token);
+                if (json) {
+                    console.log(JSON.stringify({ space: spaceSlug, teams }));
+                    return;
+                }
+                if (teams.length === 0) {
+                    console.log(`\n${spaceSlug} Space에 추가된 팀이 없습니다.`);
+                    return;
+                }
+                console.log(`\n\x1b[1m${spaceSlug} Space 팀 목록\x1b[0m (${teams.length}개):\n`);
+                for (const t of teams) {
+                    const desc = t.description
+                        ? `  \x1b[90m${t.description.length > 50 ? t.description.slice(0, 50) + '...' : t.description}\x1b[0m`
+                        : '';
+                    console.log(`  \x1b[36m${t.slug}\x1b[0m  \x1b[1m${t.name}\x1b[0m${desc}`);
+                }
+                console.log(`\n\x1b[33m💡 설치: relay install @spaces/${spaceSlug}/<팀슬러그>\x1b[0m`);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                if (json) {
+                    console.error(JSON.stringify({ error: 'FETCH_FAILED', message }));
+                }
+                else {
+                    console.error(`\x1b[31m오류: ${message}\x1b[0m`);
+                }
+                process.exit(1);
+            }
+            return;
+        }
+        // 기본 동작: 로컬에 설치된 팀 목록
         const installed = (0, config_js_1.loadInstalled)();
         const entries = Object.entries(installed);
         const installedList = entries.map(([slug, info]) => ({

package/dist/commands/login.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerLogin = registerLogin;
 const http_1 = __importDefault(require("http"));
+const readline_1 = __importDefault(require("readline"));
 const child_process_1 = require("child_process");
 const config_js_1 = require("../lib/config.js");
 function openBrowser(url) {
@@ -112,11 +113,109 @@ function findAvailablePort() {
         });
     });
 }
+function promptLine(rl, question) {
+    return new Promise((resolve) => rl.question(question, resolve));
+}
+function promptPassword(question) {
+    return new Promise((resolve) => {
+        const rl = readline_1.default.createInterface({ input: process.stdin, output: process.stdout });
+        process.stdout.write(question);
+        // Hide input
+        const stdin = process.stdin;
+        if (stdin.isTTY)
+            stdin.setRawMode(true);
+        let input = '';
+        process.stdin.resume();
+        process.stdin.setEncoding('utf8');
+        const onData = (ch) => {
+            if (ch === '\n' || ch === '\r' || ch === '\u0004') {
+                if (stdin.isTTY)
+                    stdin.setRawMode(false);
+                process.stdout.write('\n');
+                process.stdin.removeListener('data', onData);
+                rl.close();
+                resolve(input);
+            }
+            else if (ch === '\u0003') {
+                process.exit(1);
+            }
+            else if (ch === '\u007f') {
+                input = input.slice(0, -1);
+            }
+            else {
+                input += ch;
+            }
+        };
+        process.stdin.on('data', onData);
+    });
+}
+async function loginWithBrowser(provider, json) {
+    const port = await findAvailablePort();
+    const loginUrl = `${config_js_1.API_URL}/auth/cli-login?port=${port}&provider=${provider}`;
+    if (!json) {
+        const providerName = provider === 'github' ? 'GitHub' : '카카오';
+        console.error(`브라우저에서 ${providerName} 로그인을 진행합니다...`);
+    }
+    openBrowser(loginUrl);
+    return waitForToken(port);
+}
+async function loginWithEmail(json) {
+    const rl = readline_1.default.createInterface({ input: process.stdin, output: process.stdout });
+    if (!json) {
+        console.error('이메일로 로그인합니다.');
+    }
+    let email;
+    let password;
+    try {
+        email = (await promptLine(rl, '이메일: ')).trim();
+        rl.close();
+        password = await promptPassword('비밀번호: ');
+    }
+    catch {
+        rl.close();
+        throw new Error('입력이 취소되었습니다');
+    }
+    const res = await fetch(`${config_js_1.API_URL}/api/auth/email-login`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ email, password }),
+    });
+    if (!res.ok) {
+        const body = (await res.json().catch(() => ({})));
+        const msg = body.error ?? '이메일 또는 비밀번호가 올바르지 않습니다.';
+        throw new Error(msg);
+    }
+    const data = (await res.json());
+    return {
+        token: data.access_token,
+        refresh_token: data.refresh_token,
+        expires_at: data.expires_at,
+    };
+}
+async function selectProvider(json) {
+    if (json)
+        return 'github';
+    const rl = readline_1.default.createInterface({ input: process.stdin, output: process.stdout });
+    console.error('');
+    console.error('로그인 방법을 선택하세요:');
+    console.error('  1) GitHub');
+    console.error('  2) 카카오');
+    console.error('  3) 이메일 / 비밀번호');
+    console.error('');
+    const answer = (await promptLine(rl, '선택 (기본값: 1): ')).trim();
+    rl.close();
+    if (answer === '2')
+        return 'kakao';
+    if (answer === '3')
+        return 'email';
+    return 'github';
+}
 function registerLogin(program) {
     program
         .command('login')
         .description('RelayAX 계정에 로그인합니다')
         .option('--token <token>', '직접 토큰 입력 (브라우저 없이)')
+        .option('--provider <provider>', '로그인 제공자 (github | kakao | email)')
         .action(async (opts) => {
         const json = program.opts().json ?? false;
         (0, config_js_1.ensureGlobalRelayDir)();
@@ -125,18 +224,32 @@ function registerLogin(program) {
         let expiresAt;
         if (!accessToken) {
             try {
-                const port = await findAvailablePort();
-                const loginUrl = `${config_js_1.API_URL}/auth/cli-login?port=${port}`;
-                console.error('브라우저에서 로그인을 진행합니다...');
-                openBrowser(loginUrl);
-                const loginResult = await waitForToken(port);
+                let provider = opts.provider;
+                if (!provider) {
+                    provider = await selectProvider(json);
+                }
+                let loginResult;
+                if (provider === 'email') {
+                    loginResult = await loginWithEmail(json);
+                }
+                else if (provider === 'kakao') {
+                    loginResult = await loginWithBrowser('kakao', json);
+                }
+                else {
+                    loginResult = await loginWithBrowser('github', json);
+                }
                 accessToken = loginResult.token;
                 refreshToken = loginResult.refresh_token;
                 expiresAt = loginResult.expires_at;
             }
             catch (err) {
                 const msg = err instanceof Error ? err.message : '로그인 실패';
-                console.error(JSON.stringify({ error: 'LOGIN_FAILED', message: msg }));
+                if (json) {
+                    console.error(JSON.stringify({ error: 'LOGIN_FAILED', message: msg }));
+                }
+                else {
+                    console.error(`\x1b[31m오류: ${msg}\x1b[0m`);
+                }
                 process.exit(1);
             }
         }

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 = {
@@ -56,10 +51,9 @@ function parseRelayYaml(content) {
     }
     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;
+    const visibility = rawVisibility === 'private' ? 'private'
+        : rawVisibility === 'public' ? 'public'
+            : undefined;
     return {
         name: String(raw.name ?? ''),
         slug: String(raw.slug ?? ''),
@@ -223,19 +217,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 +257,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 +292,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 +357,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}` },
@@ -443,14 +446,13 @@ function registerPublish(program) {
             const visibility = await promptSelect({
                 message: '공개 범위:',
                 choices: [
-                    { name: '전체 공개', value: 'public' },
-                    { name: '로그인 사용자만', value: 'login-only' },
-                    { name: '초대 코드 필요', value: 'invite-only' },
+                    { name: '공개', value: 'public' },
+                    { name: '비공개 (Space 멤버만)', value: 'private' },
                 ],
             });
             console.error('\n\x1b[2m💡 프로필에 연락처를 설정하면 설치 시 명함이 전달됩니다: www.relayax.com/dashboard/profile\x1b[0m');
-            if (visibility === 'invite-only') {
-                console.error('\x1b[2m💡 invite-only 팀은 웹 대시보드에서 사용자를 초대하세요: www.relayax.com/dashboard/teams\x1b[0m');
+            if (visibility === 'private') {
+                console.error('\x1b[2m💡 비공개 팀은 Space를 통해 멤버를 관리하세요: www.relayax.com/dashboard/teams\x1b[0m');
             }
             console.error('');
             const tags = tagsRaw
@@ -528,6 +530,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 +550,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,12 +7,13 @@ 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>')
         .description('설치된 에이전트 팀을 최신 버전으로 업데이트합니다')
         .option('--path <install_path>', '설치 경로 지정 (기본: ./.claude)')
-        .option('--code <code>', '초대 코드 (invite-only 팀 업데이트 시 필요)')
+        .option('--code <code>', '초대 코드 (비공개 팀 업데이트 시 필요)')
         .action(async (slugInput, opts) => {
         const json = program.opts().json ?? false;
         const installPath = (0, config_js_1.getInstallPath)(opts.path);
@@ -51,16 +52,10 @@ function registerUpdate(program) {
             }
             // Visibility check
             const visibility = team.visibility ?? 'public';
-            if (visibility === 'login-only') {
+            if (visibility === 'private') {
                 const token = await (0, config_js_1.getValidToken)();
                 if (!token) {
-                    console.error('이 팀은 로그인이 필요합니다. `relay login`을 먼저 실행하세요.');
-                    process.exit(1);
-                }
-            }
-            else if (visibility === 'invite-only') {
-                if (!opts.code) {
-                    console.error('초대 코드가 필요합니다. `relay update ' + slug + ' --code <code>`로 업데이트하세요.');
+                    console.error('이 팀은 Space 멤버만 업데이트할 수 있습니다. `relay login`을 먼저 실행하세요.');
                     process.exit(1);
                 }
             }
@@ -69,6 +64,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/index.js

@@ -16,6 +16,7 @@ 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");
+const join_js_1 = require("./commands/join.js");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const pkg = require('../package.json');
 const program = new commander_1.Command();
@@ -38,4 +39,5 @@ program
 (0, check_update_js_1.registerCheckUpdate)(program);
 (0, follow_js_1.registerFollow)(program);
 (0, changelog_js_1.registerChangelog)(program);
+(0, join_js_1.registerJoin)(program);
 program.parse();

package/dist/lib/api.d.ts

@@ -8,6 +8,11 @@ export interface TeamVersionInfo {
 }
 export declare function fetchTeamVersions(slug: string): Promise<TeamVersionInfo[]>;
 export declare function reportInstall(slug: string, version?: string): Promise<void>;
+/**
+ * Space 팀 설치: 멤버십 검증 + install count 증가 + 팀 메타데이터 반환을 한 번에 처리.
+ * POST /api/spaces/{spaceSlug}/teams/{teamSlug}/install
+ */
+export declare function installSpaceTeam(spaceSlug: string, teamSlug: string, version?: string): Promise<TeamRegistryInfo>;
 export interface ResolvedSlug {
     owner: string;
     name: string;

package/dist/lib/api.js

@@ -4,6 +4,7 @@ exports.fetchTeamInfo = fetchTeamInfo;
 exports.searchTeams = searchTeams;
 exports.fetchTeamVersions = fetchTeamVersions;
 exports.reportInstall = reportInstall;
+exports.installSpaceTeam = installSpaceTeam;
 exports.resolveSlugFromServer = resolveSlugFromServer;
 exports.sendUsagePing = sendUsagePing;
 exports.followBuilder = followBuilder;
@@ -62,6 +63,31 @@ async function reportInstall(slug, version) {
         // non-critical: ignore errors
     });
 }
+/**
+ * Space 팀 설치: 멤버십 검증 + install count 증가 + 팀 메타데이터 반환을 한 번에 처리.
+ * POST /api/spaces/{spaceSlug}/teams/{teamSlug}/install
+ */
+async function installSpaceTeam(spaceSlug, teamSlug, version) {
+    const url = `${config_js_1.API_URL}/api/spaces/${spaceSlug}/teams/${teamSlug}/install`;
+    const headers = { 'Content-Type': 'application/json' };
+    const token = await (0, config_js_1.getValidToken)();
+    if (token) {
+        headers['Authorization'] = `Bearer ${token}`;
+    }
+    const body = {};
+    if (version)
+        body.version = version;
+    const res = await fetch(url, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`Space 팀 설치 실패 (${res.status}): ${text}`);
+    }
+    return res.json();
+}
 async function resolveSlugFromServer(name) {
     const url = `${config_js_1.API_URL}/api/registry/resolve?name=${encodeURIComponent(name)}`;
     const res = await fetch(url, { signal: AbortSignal.timeout(5000) });

package/dist/lib/command-adapter.js

@@ -108,7 +108,10 @@ exports.USER_COMMANDS = [
 - 업데이트 여부와 관계없이 설치를 계속 진행합니다.
 
 ### 1. 팀 패키지 다운로드
-- \`relay install <@author/slug>\` 명령어를 실행합니다.
+- Public 마켓 팀: \`relay install <@author/slug>\` 명령어를 실행합니다.
+- Space 팀: \`relay install @spaces/<space-slug>/<team-slug>\` 명령어를 실행합니다.
+  - Space 가입이 필요하면: \`relay join <space-slug> --code <invite-code>\` 를 먼저 실행합니다.
+  - 또는 \`relay install @spaces/<space-slug>/<team-slug> --join-code <code>\` 로 가입+설치를 한번에 할 수 있습니다.
 - 패키지가 \`.relay/teams/<slug>/\`에 다운로드됩니다.
 
 ### 2. 패키지 내용 확인
@@ -160,7 +163,13 @@ ${BUSINESS_CARD_FORMAT}
 → commands/cardnews.md → .claude/commands/cardnews.md 복사
 → skills/pdf-gen.md → .claude/skills/pdf-gen.md 복사
 → requires 확인: ✓ playwright 설치됨, ✓ sharp 설치됨
-→ "✓ 설치 완료! /cardnews를 사용해볼까요?"`,
+→ "✓ 설치 완료! /cardnews를 사용해볼까요?"
+
+사용자: /relay-install @spaces/bobusan/pm-bot
+→ relay install @spaces/bobusan/pm-bot 실행
+→ Space 멤버 확인 → 정상
+→ 패키지 다운로드 및 배치
+→ "✓ 설치 완료!"`,
     },
     {
         id: 'relay-list',
@@ -176,13 +185,23 @@ ${BUSINESS_CARD_FORMAT}
    - 사용 가능한 커맨드
 3. 설치된 팀이 없으면 \`/relay-explore\`로 팀을 탐색해보라고 안내합니다.
 
+### Space 팀 목록 확인
+- 특정 Space에서 사용 가능한 팀 목록을 보려면: \`relay list --space <space-slug> --json\`
+- Space에 가입되어 있어야 합니다.
+
 ## 예시
 
 사용자: /relay-list
 → relay list --json 실행
 → "2개 팀이 설치되어 있어요:"
 → "  @example/contents-team v1.2.0 (2일 전 설치) - /cardnews, /pdf-report"
-→ "  qa-team v0.5.1 (1주 전 설치) - /qa, /qa-only"`,
+→ "  qa-team v0.5.1 (1주 전 설치) - /qa, /qa-only"
+
+사용자: /relay-list --space bobusan
+→ relay list --space bobusan --json 실행
+→ "bobusan Space에서 설치 가능한 팀:"
+→ "  pm-bot — 프로젝트 관리 봇"
+→ "  cs-bot — 고객 응대 봇"`,
     },
     {
         id: 'relay-update',
@@ -241,7 +260,7 @@ exports.BUILDER_COMMANDS = [
     {
         id: 'relay-publish',
         description: '현재 팀 패키지를 포트폴리오와 함께 relay 마켓플레이스에 배포합니다',
-        body: `현재 디렉토리의 에이전트 팀(.relay/)을 분석하고, 보안 점검 및 requirements를 구성한 뒤, 포트폴리오를 생성하고 relay 마켓플레이스에 배포합니다.
+        body: `현재 디렉토리의 에이전트 팀(.relay/)을 분석하고, 보안 점검 및 requirements를 구성한 뒤, 사용가이드와 포트폴리오를 생성하고 relay 마켓플레이스에 배포합니다.
 
 ## 실행 단계
 
@@ -327,76 +346,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 +418,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/types.d.ts

@@ -8,6 +8,8 @@ export interface InstalledTeam {
     installed_at: string;
     files: string[];
     type?: 'team' | 'system';
+    /** Space 소속 팀인 경우 Space slug */
+    space_slug?: string;
 }
 /** 키는 scoped slug 포맷: "@owner/name" */
 export interface InstalledRegistry {
@@ -30,7 +32,7 @@ export interface TeamRegistryInfo {
     tags?: string[];
     install_count?: number;
     requires?: Record<string, unknown>;
-    visibility?: "public" | "login-only" | "invite-only";
+    visibility?: "public" | "private";
     welcome?: string | null;
     contact?: Record<string, string> | null;
     author?: {

package/package.json

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