relayax-cli 0.2.36 → 0.2.38

package/dist/commands/create.js

@@ -129,7 +129,7 @@ function registerCreate(program) {
             if (globalInstalled) {
                 console.log(`\n  \x1b[36mUser 커맨드 (글로벌)\x1b[0m — 설치됨`);
             }
-            console.log(`\n  다음 단계: \x1b[33m/relay-publish\x1b[0m로 마켓플레이스에 배포`);
+            console.log(`\n  다음 단계: \x1b[33m/relay-publish\x1b[0m로 Space에 배포`);
             console.log('  IDE를 재시작하면 슬래시 커맨드가 활성화됩니다.\n');
         }
     });

package/dist/commands/init.js

@@ -122,7 +122,6 @@ function registerInit(program) {
         .command('init')
         .description('에이전트 CLI에 relay 슬래시 커맨드를 설치합니다')
         .option('--tools <tools>', '설치할 에이전트 CLI 지정 (all 또는 쉼표 구분)')
-        .option('--update', '이미 설치된 슬래시 커맨드를 최신 버전으로 업데이트')
         .option('--auto', '대화형 프롬프트 없이 자동으로 모든 감지된 CLI에 설치')
         .action(async (opts) => {
         const json = program.opts().json ?? false;
@@ -135,9 +134,9 @@ function registerInit(program) {
         // ── 1. 글로벌 User 커맨드 설치 ──
         let globalStatus = 'already';
         let globalTools = [];
-        if (opts.update || !hasGlobalUserCommands()) {
+        {
             const result = installGlobalUserCommands();
-            globalStatus = opts.update ? 'updated' : 'installed';
+            globalStatus = hasGlobalUserCommands() ? 'updated' : 'installed';
             globalTools = result.tools;
             // Register relay-core in installed.json
             const installed = (0, config_js_1.loadInstalled)();
@@ -155,17 +154,7 @@ function registerInit(program) {
         if (isBuilder && command_adapter_js_1.BUILDER_COMMANDS.length > 0) {
             // 도구 선택
             let targetToolIds;
-            if (opts.update) {
-                const installed = detected.filter((tool) => {
-                    const cmdDir = path_1.default.join(projectPath, tool.skillsDir, 'commands', 'relay');
-                    return fs_1.default.existsSync(cmdDir);
-                });
-                if (installed.length === 0 && !json) {
-                    console.error('로컬에 설치된 relay Builder 커맨드가 없습니다.');
-                }
-                targetToolIds = installed.map((t) => t.value);
-            }
-            else if (opts.tools) {
+            if (opts.tools) {
                 targetToolIds = resolveTools(opts.tools);
             }
             else if (!autoMode) {
@@ -240,9 +229,9 @@ function registerInit(program) {
             }));
         }
         else {
-            console.log(`\n\x1b[32m✓ relay ${opts.update ? '업데이트' : '초기화'} 완료\x1b[0m\n`);
+            console.log(`\n\x1b[32m✓ relay 초기화 완료\x1b[0m\n`);
             // 글로벌
-            if (globalStatus !== 'already') {
+            {
                 const toolNames = globalTools.length > 0 ? globalTools.join(', ') : 'Claude Code';
                 console.log(`  \x1b[36mUser 커맨드 (글로벌)\x1b[0m — ${globalStatus === 'updated' ? '업데이트됨' : '설치됨'}`);
                 console.log(`  감지된 CLI: \x1b[36m${toolNames}\x1b[0m`);
@@ -251,10 +240,6 @@ function registerInit(program) {
                 }
                 console.log();
             }
-            else {
-                console.log(`  \x1b[36mUser 커맨드 (글로벌)\x1b[0m — 이미 설치됨`);
-                console.log();
-            }
             // 로컬 Builder
             if (localResults.length > 0) {
                 console.log(`  \x1b[36mBuilder 커맨드 (로컬)\x1b[0m`);

package/dist/commands/install.js

@@ -99,8 +99,7 @@ function registerInstall(program) {
             }
             else {
                 // Normal registry install
-                const resolveInput = slugInput;
-                parsed = await (0, slug_js_1.resolveSlug)(resolveInput);
+                parsed = await (0, slug_js_1.resolveSlug)(slugInput);
                 slug = parsed.full;
                 try {
                     team = await (0, api_js_1.fetchTeamInfo)(slug);
@@ -108,20 +107,86 @@ function registerInstall(program) {
                 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,
-                            }));
+                        // Parse join_policy and membership_status from error body if available
+                        let joinPolicy;
+                        let membershipStatus;
+                        try {
+                            const errBody = JSON.parse(fetchMsg.replace(/^.*?(\{)/, '{'));
+                            joinPolicy = typeof errBody.join_policy === 'string' ? errBody.join_policy : undefined;
+                            membershipStatus = typeof errBody.membership_status === 'string' ? errBody.membership_status : undefined;
+                        }
+                        catch { /* ignore parse errors */ }
+                        if (joinPolicy === 'auto') {
+                            // Auto-join the Space then retry install
+                            if (!json) {
+                                console.error(`\x1b[33m⚙ Space에 자동 가입합니다...\x1b[0m`);
+                            }
+                            try {
+                                const spaceSlug = parsed.owner;
+                                await (0, join_js_1.joinSpace)(spaceSlug, '');
+                                if (!json) {
+                                    console.error(`\x1b[32m✓ Space에 가입했습니다\x1b[0m`);
+                                }
+                                team = await (0, api_js_1.fetchTeamInfo)(slug);
+                            }
+                            catch (joinErr) {
+                                const joinMsg = joinErr instanceof Error ? joinErr.message : String(joinErr);
+                                if (json) {
+                                    console.error(JSON.stringify({ error: 'JOIN_FAILED', message: joinMsg, slug }));
+                                }
+                                else {
+                                    console.error(`\x1b[31mSpace 가입 실패: ${joinMsg}\x1b[0m`);
+                                }
+                                process.exit(1);
+                            }
+                        }
+                        else if (joinPolicy === 'approval') {
+                            const spaceSlug = parsed.owner;
+                            if (json) {
+                                console.error(JSON.stringify({
+                                    error: 'APPROVAL_REQUIRED',
+                                    message: `가입 신청이 필요합니다. \`relay join @${spaceSlug}\`로 가입하세요.`,
+                                    slug,
+                                    spaceSlug,
+                                }));
+                            }
+                            else {
+                                console.error(`\x1b[33m가입 신청이 필요합니다. \`relay join @${spaceSlug}\`로 가입하세요.\x1b[0m`);
+                            }
+                            process.exit(1);
+                        }
+                        else if (membershipStatus === 'member') {
+                            // Member but no access to this specific team
+                            if (json) {
+                                console.error(JSON.stringify({
+                                    error: 'NO_ACCESS',
+                                    message: '이 팀에 대한 접근 권한이 없습니다.',
+                                    slug,
+                                }));
+                            }
+                            else {
+                                console.error('\x1b[31m이 팀에 대한 접근 권한이 없습니다.\x1b[0m');
+                            }
+                            process.exit(1);
                         }
                         else {
-                            console.error('\x1b[31m이 팀은 Space 멤버만 설치 가능합니다.\x1b[0m');
-                            console.error('\x1b[33mSpace 관리자에게 초대 코드를 요청하세요.\x1b[0m');
+                            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);
                         }
-                        process.exit(1);
                     }
-                    throw fetchErr;
+                    else {
+                        throw fetchErr;
+                    }
                 }
             }
             const teamDir = path_1.default.join(projectPath, '.relay', 'teams', parsed.owner, parsed.name);

package/dist/commands/list.js

@@ -20,10 +20,10 @@ function registerList(program) {
     program
         .command('list')
         .description('설치된 에이전트 팀 목록')
-        .option('--space <slug>', 'Space 마켓플레이스의 팀 목록 조회')
+        .option('--space <slug>', 'Space 팀 목록 조회')
         .action(async (opts) => {
         const json = program.opts().json ?? false;
-        // --space 옵션: Space 마켓플레이스 팀 목록
+        // --space 옵션: Space 팀 목록
         if (opts.space) {
             const spaceSlug = opts.space;
             const token = await (0, config_js_1.getValidToken)();

package/dist/commands/publish.js

@@ -279,7 +279,7 @@ async function publishToApi(token, tarPath, metadata) {
 function registerPublish(program) {
     program
         .command('publish')
-        .description('현재 팀 패키지를 마켓플레이스에 배포합니다 (relay.yaml 필요)')
+        .description('현재 팀 패키지를 Space에 배포합니다 (relay.yaml 필요)')
         .option('--token <token>', '인증 토큰')
         .action(async (opts) => {
         const json = program.opts().json ?? false;
@@ -404,36 +404,97 @@ function registerPublish(program) {
                 console.error(`  → relay.yaml에 version: ${newVersion} 저장됨\n`);
             }
         }
+        // Validate structure (콘텐츠는 .relay/ 안에 있음)
+        const hasDirs = VALID_DIRS.some((d) => {
+            const dirPath = path_1.default.join(relayDir, d);
+            if (!fs_1.default.existsSync(dirPath))
+                return false;
+            return fs_1.default.readdirSync(dirPath).filter((f) => !f.startsWith('.')).length > 0;
+        });
+        if (!hasDirs) {
+            console.error(JSON.stringify({
+                error: 'EMPTY_PACKAGE',
+                message: '.relay/ 안에 skills/, agents/, rules/, commands/ 중 하나 이상에 파일이 있어야 합니다.',
+            }));
+            process.exit(1);
+        }
+        // Get token (checked before tarball creation)
+        const token = opts.token ?? process.env.RELAY_TOKEN ?? await (0, config_js_1.getValidToken)();
+        if (!token) {
+            console.error(JSON.stringify({
+                error: 'NO_TOKEN',
+                message: '인증이 필요합니다. `relay login`을 먼저 실행하세요.',
+            }));
+            process.exit(1);
+        }
+        // Fetch user's Spaces and select publish target
+        let selectedSpaceId;
+        let selectedSpaceIsPersonal = true;
+        try {
+            const { fetchMySpaces } = await import('./spaces.js');
+            const spaces = await fetchMySpaces(token);
+            const personalSpace = spaces.find((s) => s.is_personal);
+            const teamSpaces = spaces.filter((s) => !s.is_personal);
+            if (isTTY) {
+                if (spaces.length === 0) {
+                    // No spaces at all — publish without space_id
+                    console.error('\x1b[33m⚠ 소속 Space가 없습니다. 개인 계정으로 배포합니다.\x1b[0m\n');
+                }
+                else if (spaces.length === 1 && personalSpace) {
+                    // Only personal Space — auto-select
+                    selectedSpaceId = personalSpace.id;
+                    selectedSpaceIsPersonal = true;
+                    console.error(`\x1b[2m  Space: 개인 스페이스 (${personalSpace.slug})\x1b[0m\n`);
+                }
+                else {
+                    // Multiple spaces — prompt user
+                    const { select: selectSpace } = await import('@inquirer/prompts');
+                    const spaceChoices = [
+                        ...(personalSpace ? [{ name: `개인 스페이스 (${personalSpace.slug})`, value: personalSpace.id, isPersonal: true }] : []),
+                        ...teamSpaces.map((s) => ({ name: `${s.name} (${s.slug})`, value: s.id, isPersonal: false })),
+                    ];
+                    const chosenId = await selectSpace({
+                        message: '어떤 Space에 배포할까요?',
+                        choices: spaceChoices.map((c) => ({ name: c.name, value: c.value })),
+                    });
+                    const chosen = spaceChoices.find((c) => c.value === chosenId);
+                    selectedSpaceId = chosenId;
+                    selectedSpaceIsPersonal = chosen?.isPersonal ?? false;
+                    const chosenLabel = chosen?.name ?? chosenId;
+                    console.error(`  → Space: ${chosenLabel}\n`);
+                }
+            }
+            else if (personalSpace) {
+                selectedSpaceId = personalSpace.id;
+                selectedSpaceIsPersonal = true;
+            }
+        }
+        catch {
+            // Space 조회 실패 시 무시하고 계속 진행
+        }
+        // Visibility default based on Space type: personal → public, team Space → private
+        const defaultVisibility = selectedSpaceIsPersonal ? 'public' : 'private';
+        const defaultVisLabel = defaultVisibility === 'public'
+            ? '공개 (개인 Space 기본값)'
+            : '비공개 (팀 Space 기본값)';
         // Visibility validation: must be explicitly set
         if (!config.visibility) {
             if (isTTY) {
                 const { select: promptSelect } = await import('@inquirer/prompts');
-                console.error('\n\x1b[33m⚠ relay.yaml에 visibility가 설정되지 않았습니다.\x1b[0m');
-                // Show user's spaces to help decide
-                try {
-                    const { fetchMySpaces } = await import('./spaces.js');
-                    const spaceToken = opts.token ?? process.env.RELAY_TOKEN ?? await (0, config_js_1.getValidToken)();
-                    if (spaceToken) {
-                        const spaces = await fetchMySpaces(spaceToken);
-                        const nonPersonal = spaces.filter((s) => !s.is_personal);
-                        if (nonPersonal.length > 0) {
-                            console.error(`\n  내 Space:`);
-                            for (const s of nonPersonal) {
-                                console.error(`    \x1b[36m${s.slug}\x1b[0m — ${s.name}`);
-                            }
-                            console.error(`\n  비공개로 설정하면 위 Space 멤버만 접근할 수 있습니다.\n`);
-                        }
-                    }
-                }
-                catch {
-                    // Space 조회 실패는 무시 — visibility 선택은 계속 진행
-                }
+                console.error(`\n\x1b[33m⚠ relay.yaml에 visibility가 설정되지 않았습니다.\x1b[0m  (기본값: ${defaultVisLabel})`);
                 config.visibility = await promptSelect({
                     message: '공개 범위를 선택하세요:',
                     choices: [
-                        { name: '공개 — 마켓플레이스에 누구나 검색·설치', value: 'public' },
-                        { name: '비공개 — Space 멤버만 접근', value: 'private' },
+                        {
+                            name: `공개 — Space에 누구나 검색·설치${defaultVisibility === 'public' ? '  ✓ 추천' : ''}`,
+                            value: 'public',
+                        },
+                        {
+                            name: `비공개 — Space 멤버만 접근${defaultVisibility === 'private' ? '  ✓ 추천' : ''}`,
+                            value: 'private',
+                        },
                     ],
+                    default: defaultVisibility,
                 });
                 // Save back to relay.yaml
                 const yamlData = js_yaml_1.default.load(yamlContent);
@@ -453,8 +514,8 @@ function registerPublish(program) {
         if (isTTY) {
             const { select: promptConfirmVis } = await import('@inquirer/prompts');
             const visLabel = config.visibility === 'public'
-                ? '\x1b[32m공개\x1b[0m (마켓플레이스에 누구나 검색·설치)'
-                : '\x1b[33m비공개\x1b[0m (Space 멤버만 접근)';
+                ? `\x1b[32m공개\x1b[0m (Space에 누구나 검색·설치)${defaultVisibility === 'public' ? '  ✓ 추천' : ''}`
+                : `\x1b[33m비공개\x1b[0m (Space 멤버만 접근)${defaultVisibility === 'private' ? '  ✓ 추천' : ''}`;
             const visAction = await promptConfirmVis({
                 message: `공개 범위: ${config.visibility === 'public' ? '공개' : '비공개'} — 유지할까요?`,
                 choices: [
@@ -475,29 +536,6 @@ function registerPublish(program) {
         if (isTTY) {
             console.error('💡 프로필에 연락처를 설정하면 설치 시 명함이 전달됩니다: www.relayax.com/dashboard/profile');
         }
-        // Validate structure (콘텐츠는 .relay/ 안에 있음)
-        const hasDirs = VALID_DIRS.some((d) => {
-            const dirPath = path_1.default.join(relayDir, d);
-            if (!fs_1.default.existsSync(dirPath))
-                return false;
-            return fs_1.default.readdirSync(dirPath).filter((f) => !f.startsWith('.')).length > 0;
-        });
-        if (!hasDirs) {
-            console.error(JSON.stringify({
-                error: 'EMPTY_PACKAGE',
-                message: '.relay/ 안에 skills/, agents/, rules/, commands/ 중 하나 이상에 파일이 있어야 합니다.',
-            }));
-            process.exit(1);
-        }
-        // Get token (checked before tarball creation)
-        const token = opts.token ?? process.env.RELAY_TOKEN ?? await (0, config_js_1.getValidToken)();
-        if (!token) {
-            console.error(JSON.stringify({
-                error: 'NO_TOKEN',
-                message: '인증이 필요합니다. `relay login`을 먼저 실행하세요.',
-            }));
-            process.exit(1);
-        }
         const detectedCommands = detectCommands(relayDir);
         const components = {
             agents: countDir(relayDir, 'agents'),
@@ -525,6 +563,7 @@ function registerPublish(program) {
             type: config.type ?? 'hybrid',
             agent_details: detectedAgents,
             skill_details: detectedSkills,
+            ...(selectedSpaceId ? { space_id: selectedSpaceId } : {}),
         };
         if (!json) {
             console.error(`패키지 생성 중... (${config.name} v${config.version})`);
@@ -617,7 +656,8 @@ function registerPublish(program) {
                     console.log('```');
                     guideLines.forEach((line) => console.log(line));
                     console.log('```');
-                    console.log(`\n  \x1b[90m상세페이지: \x1b[36mrelayax.com/teams/${result.slug}\x1b[0m`);
+                    const detailSlug = result.slug.startsWith('@') ? result.slug.slice(1) : result.slug;
+                    console.log(`\n  \x1b[90m상세페이지: \x1b[36mrelayax.com/@${detailSlug}\x1b[0m`);
                 }
             }
         }

package/dist/commands/search.js

@@ -26,19 +26,24 @@ function formatTable(results) {
 function registerSearch(program) {
     program
         .command('search <keyword>')
-        .description('에이전트 팀 검색')
+        .description('Space에서 에이전트 팀 검색 (공개 팀 + 내 Space 팀)')
         .option('--tag <tag>', '태그로 필터링')
+        .option('--space <space>', '특정 Space 내에서 검색')
         .action(async (keyword, opts) => {
         const json = program.opts().json ?? false;
         try {
-            const results = await (0, api_js_1.searchTeams)(keyword, opts.tag);
+            const results = await (0, api_js_1.searchTeams)(keyword, opts.tag, opts.space);
             if (json) {
                 console.log(JSON.stringify({ results }));
             }
             else {
-                console.log(`\n검색어: \x1b[36m${keyword}\x1b[0m${opts.tag ? `  태그: \x1b[33m${opts.tag}\x1b[0m` : ''}\n`);
+                const spaceSuffix = opts.space ? `  Space: \x1b[35m@${opts.space}\x1b[0m` : '';
+                console.log(`\n검색어: \x1b[36m${keyword}\x1b[0m${opts.tag ? `  태그: \x1b[33m${opts.tag}\x1b[0m` : ''}${spaceSuffix}\n`);
                 console.log(formatTable(results));
                 console.log(`\n총 ${results.length}건`);
+                if (!opts.space && results.length === 0) {
+                    console.log('\x1b[33m💡 내 Space에서 검색하려면: relay search <keyword> --space <space-slug>\x1b[0m');
+                }
             }
         }
         catch (err) {

package/dist/lib/api.d.ts

@@ -1,6 +1,6 @@
 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 searchTeams(query: string, tag?: string, space?: string): Promise<SearchResult[]>;
 export interface TeamVersionInfo {
     version: string;
     changelog: string | null;

package/dist/lib/api.js

@@ -19,10 +19,12 @@ async function fetchTeamInfo(slug) {
     }
     return res.json();
 }
-async function searchTeams(query, tag) {
+async function searchTeams(query, tag, space) {
     const params = new URLSearchParams({ q: query });
     if (tag)
         params.set('tag', tag);
+    if (space)
+        params.set('space', space);
     const url = `${config_js_1.API_URL}/api/registry/search?${params.toString()}`;
     const res = await fetch(url);
     if (!res.ok) {

package/dist/lib/command-adapter.js

@@ -111,32 +111,32 @@ JSON 결과 예시:
 exports.USER_COMMANDS = [
     {
         id: 'relay-install',
-        description: 'relay 마켓플레이스에서 에이전트 팀을 설치합니다',
-        body: `요청된 에이전트 팀을 relay 마켓플레이스에서 다운로드하고, 현재 에이전트 환경에 맞게 구성합니다.
+        description: 'relay Space에서 에이전트 팀을 설치합니다',
+        body: `요청된 에이전트 팀을 relay Space에서 다운로드하고, 현재 에이전트 환경에 맞게 구성합니다.
 인자 없이 호출하면 인터랙티브 탐색 모드로 진입합니다.
 
 ## 인터랙션 플로우
 
 이 커맨드는 3단계 인터랙션으로 진행됩니다. 각 단계에서 반드시 AskUserQuestion 도구를 사용하세요.
 
-### Step 1. 공간 선택 & 팀 탐색 (slug가 없을 때만)
+### Step 1. Space 선택 & 팀 탐색 (slug가 없을 때만)
 
 slug가 직접 주어지면 (\`/relay-install @alice/doc-writer\`) 이 단계를 건너뛰고 Step 2로 갑니다.
 
-#### 1-1. 공간 선택
+#### 1-1. Space 선택
 \`relay spaces --json\` 을 실행하여 사용자의 Space 목록을 가져옵니다.
 
 **AskUserQuestion 호출:**
 - question: "어디서 팀을 찾을까요?"
-- options: Space가 있으면 \`["마켓플레이스 (공개)", "<space1_name>", "<space2_name>", ...]\`, 없으면 이 단계를 건너뛰고 바로 마켓 검색으로 진행
+- options: Space가 있으면 \`["<space1_name> (개인)", "<space2_name>", ...]\`, 없으면 이 단계를 건너뛰고 바로 내 Space 탐색으로 진행
 
 **응답 처리:**
-- "마켓플레이스 (공개)" → 1-2. 마켓 검색으로 진행
-- Space 이름 선택 → 1-3. Space 팀 목록으로 진행
+- Space 이름 선택 → 1-2. Space 팀 탐색으로 진행
 
-#### 1-2. 마켓 검색
-사용자의 요청에서 키워드를 추출합니다. 명시적 키워드가 없으면 현재 프로젝트를 분석하여 적절한 검색어를 판단합니다.
+#### 1-2. Space 팀 탐색
+선택된 Space에서 팀을 검색합니다.
 \`relay search <keyword>\` 명령어를 실행합니다 (필요하면 여러 키워드로 반복).
+또는 \`relay list --space <space-slug> --json\`으로 전체 목록을 가져옵니다.
 
 검색 결과를 번호 리스트로 보여줍니다:
 
@@ -155,12 +155,13 @@ slug가 직접 주어지면 (\`/relay-install @alice/doc-writer\`) 이 단계를
 
 **AskUserQuestion 호출:**
 - question: "어떤 팀을 설치할까요?"
-- options: \`["1", "2", "3", "다시 검색"]\`
+- options: \`["1", "2", "3", "다시 검색", "돌아가기"]\`
 
 "다시 검색" → 새 키워드로 1-2 반복
+"돌아가기" → 1-1로 돌아감
 번호 선택 → 해당 팀의 slug로 설치 진행
 
-#### 1-3. Space 팀 목록
+#### 1-3. Space 팀 목록 (전체 보기)
 \`relay list --space <space-slug> --json\` 을 실행합니다.
 
 팀 목록을 번호 리스트로 보여줍니다 (1-2와 동일 형식).
@@ -175,9 +176,9 @@ slug가 직접 주어지면 (\`/relay-install @alice/doc-writer\`) 이 단계를
 ### Step 2. 설치 & 배치 범위 선택
 
 #### 2-1. 패키지 다운로드
-\`relay install <@author/slug> --json\` 명령어를 실행합니다.
-- Public 마켓 팀: \`relay install <@author/slug> --json\`
-- Space 팀: \`relay install @spaces/<space-slug>/<team-slug> --json\`
+\`relay install <@space/team> --json\` 명령어를 실행합니다.
+- 공개 팀: \`relay install <@space/team> --json\`
+- Space 팀 (비공개): \`relay install @<space-slug>/<team-slug> --json\`
   - Space 가입이 필요하면: \`relay join <space-slug> --code <invite-code>\` 를 먼저 실행합니다.
   - 또는 \`--join-code <code>\`로 가입+설치를 한번에 할 수 있습니다.
 - CLI가 init과 login을 자동으로 처리합니다 (사용자가 별도 실행할 필요 없음).
@@ -311,9 +312,11 @@ npm install -g relayax-cli
 relay login
 relay install {slug}
 
-상세페이지: relayax.com/teams/{slug}
+상세페이지: relayax.com/@{owner}/{team}
 \`\`\`
 
+- \`{slug}\`가 \`@owner/team\` 형식이면 상세페이지는 \`relayax.com/@{owner}/{team}\`으로 치환합니다.
+
 - type 기반 사용법도 포함:
   - command/hybrid: \`# 사용법: /{첫번째 커맨드}\`
   - passive: \`# 설치하면 자동 적용됩니다\`
@@ -330,8 +333,8 @@ relay install {slug}
 
 ### 인터랙티브 모드 (/relay-install)
 → relay spaces --json 실행
-→ AskUserQuestion: "어디서 팀을 찾을까요?" → ["마켓플레이스 (공개)", "Acme Corp"]
-→ "마켓플레이스" 선택 → "어떤 팀을 찾고 계세요?"
+→ AskUserQuestion: "어디서 팀을 찾을까요?" → ["개인 Space (alice)", "Acme Corp"]
+→ "개인 Space" 선택 → "어떤 팀을 찾고 계세요?"
 → relay search "문서" 실행 → 결과 리스트 표시
 → AskUserQuestion: "어떤 팀을 설치할까요?" → ["1", "2", "3", "다시 검색"]
 → "1" 선택 (@alice/doc-writer)
@@ -464,8 +467,8 @@ ${LOGIN_JIT_GUIDE}
     },
     {
         id: 'relay-publish',
-        description: '현재 팀 패키지를 relay 마켓플레이스에 배포합니다',
-        body: `현재 디렉토리의 에이전트 팀(.relay/)을 분석하고, 보안 점검 및 requirements를 구성한 뒤, 사용가이드를 생성하고 relay 마켓플레이스에 배포합니다.
+        description: '현재 팀 패키지를 relay Space에 배포합니다',
+        body: `현재 디렉토리의 에이전트 팀(.relay/)을 분석하고, 보안 점검 및 requirements를 구성한 뒤, 사용가이드를 생성하고 relay Space에 배포합니다.
 
 ## 사전 준비 (자동)
 
@@ -484,7 +487,7 @@ ${LOGIN_JIT_GUIDE}
    - 기본값으로 현재 디렉토리명을 제안합니다.
 
 3. **AskUserQuestion 호출:**
-   - question: "팀을 한 줄로 설명해주세요 (마켓플레이스에 표시됩니다)"
+   - question: "팀을 한 줄로 설명해주세요 (Space에 표시됩니다)"
    - 기본값으로 적절한 값을 만들어줍니다.
 
 4. 자동 처리:
@@ -540,15 +543,18 @@ relay.yaml의 \`visibility\` 설정을 확인합니다.
 
 **AskUserQuestion 호출:**
 - question: "어디에 배포할까요?"
-- options: \`["공개 (마켓플레이스)", "비공개 (Space 전용)"]\`
+- options: \`["공개 (Space 공개)", "비공개 (Space 전용)"]\`
 
 **응답 처리:**
 - "공개" → relay.yaml에 \`visibility: public\` 저장
 - "비공개" → \`relay spaces --json\` 실행 후 Space 목록 표시
+  - \`is_personal: true\`인 개인 Space는 **제외**합니다. 비공개 배포는 팀 Space에만 가능합니다.
+  - 팀 Space가 0개이면: "비공개 배포하려면 팀 Space가 필요합니다. www.relayax.com/spaces 에서 Space를 생성하세요."라고 안내하고 중단합니다.
 
-  **AskUserQuestion 호출:**
+  **AskUserQuestion 호출 (Space가 1개여도 반드시 호출):**
   - question: "어떤 Space에 배포할까요?"
   - options: \`["<space1_name>", "<space2_name>", ...]\`
+  - **중요: Space가 1개라도 자동 선택하지 말고 반드시 사용자에게 확인받으세요.**
 
   → relay.yaml에 \`visibility: private\`, \`space: <selected_slug>\` 저장
 
@@ -557,7 +563,7 @@ relay.yaml의 \`visibility\` 설정을 확인합니다.
 현재 설정을 확인합니다:
 
 **AskUserQuestion 호출:**
-- question: 공개일 때 "현재 **공개** 설정입니다. 마켓플레이스에 노출됩니다. 유지할까요?", 비공개일 때 "현재 **비공개** 설정입니다 (Space: {name}). 유지할까요?"
+- question: 공개일 때 "현재 **공개** 설정입니다. Space에 공개됩니다. 유지할까요?", 비공개일 때 "현재 **비공개** 설정입니다 (Space: {name}). 유지할까요?"
 - options: \`["유지", "변경"]\`
 
 "변경" → 신규 배포와 동일한 플로우
@@ -651,7 +657,7 @@ requires:
 배포 요약
 
 팀: my-team v1.0.0
-공개: 마켓플레이스 (공개)
+공개: Space 공개
 Skills: 3개, Commands: 5개
 requires: env 2개, cli 1개
 \`\`\`
@@ -665,7 +671,7 @@ requires: env 2개, cli 1개
 - "취소" → 중단
 
 #### 3-3. 배포 완료 & 온보딩 가이드
-- 배포 결과와 마켓플레이스 URL을 보여줍니다.
+- 배포 결과와 Space URL을 보여줍니다.
 - \`relay publish\` 출력 끝에 코드블록 형태의 온보딩 가이드가 포함됩니다.
 - 이 코드블록을 사용자에게 그대로 보여줍니다.
 - 출력에 코드블록이 없으면 아래 형태로 직접 생성합니다:
@@ -684,7 +690,7 @@ ${BUSINESS_CARD_FORMAT}
 
 사용자: /relay-publish
 → 인증 확인 ✓, 팀 구조 분석 (skills 3개, commands 5개)
-→ AskUserQuestion: "어디에 배포할까요?" → ["공개 (마켓플레이스)", "비공개 (Space 전용)"]
+→ AskUserQuestion: "어디에 배포할까요?" → ["공개 (Space 공개)", "비공개 (Space 전용)"]
 → "공개" 선택
 → 보안 스캔 ✓ 시크릿 없음 → requires 분석 결과 표시
 → AskUserQuestion: "requires 설정이 맞나요?" → ["확인", "수정"]
@@ -692,7 +698,7 @@ ${BUSINESS_CARD_FORMAT}
 → 배포 요약 표시
 → AskUserQuestion: "이대로 배포할까요?" → ["배포", "취소"]
 → "배포" → relay publish 실행
-→ "배포 완료! URL: https://relayax.com/teams/my-team"
+→ "배포 완료! URL: https://relayax.com/@my-space/my-team"
 → 온보딩 가이드 코드블록 표시`,
     },
 ];

package/dist/lib/config.js

@@ -121,6 +121,19 @@ async function getValidToken() {
         return undefined;
     }
 }
+/**
+ * `@spaces/{spaceSlug}/{teamSlug}` 레거시 키를 `@{spaceSlug}/{teamSlug}`로 정규화한다.
+ * installed.json 로드 시 자동 적용되어 모든 소비자가 일관된 키를 사용한다.
+ */
+function normalizeInstalledRegistry(raw) {
+    const normalized = {};
+    for (const [key, value] of Object.entries(raw)) {
+        const m = key.match(/^@spaces\/([a-z0-9][a-z0-9-]*)\/([a-z0-9][a-z0-9-]*)$/);
+        const normalizedKey = m ? `@${m[1]}/${m[2]}` : key;
+        normalized[normalizedKey] = value;
+    }
+    return normalized;
+}
 /** 프로젝트 로컬 installed.json 읽기 */
 function loadInstalled() {
     const file = path_1.default.join(process.cwd(), '.relay', 'installed.json');
@@ -128,7 +141,7 @@ function loadInstalled() {
         return {};
     }
     try {
-        return JSON.parse(fs_1.default.readFileSync(file, 'utf-8'));
+        return normalizeInstalledRegistry(JSON.parse(fs_1.default.readFileSync(file, 'utf-8')));
     }
     catch {
         return {};
@@ -147,7 +160,7 @@ function loadGlobalInstalled() {
     if (!fs_1.default.existsSync(file))
         return {};
     try {
-        return JSON.parse(fs_1.default.readFileSync(file, 'utf-8'));
+        return normalizeInstalledRegistry(JSON.parse(fs_1.default.readFileSync(file, 'utf-8')));
     }
     catch {
         return {};

package/dist/lib/preamble.js

@@ -17,7 +17,11 @@ const PREAMBLE_END = '<!-- RELAY_PREAMBLE_END -->';
  * relay CLI가 있으면 사용, 없으면 curl fallback.
  */
 function generatePreambleScript(slug, apiUrl) {
-    const registrySlug = slug.startsWith('@') ? slug.slice(1) : slug;
+    // slug format: @space/team → space=space, team=team
+    const stripped = slug.startsWith('@') ? slug.slice(1) : slug;
+    const slashIdx = stripped.indexOf('/');
+    const spacePart = slashIdx !== -1 ? stripped.slice(0, slashIdx) : stripped;
+    const teamPart = slashIdx !== -1 ? stripped.slice(slashIdx + 1) : stripped;
     return `#!/usr/bin/env bash
 # relay-preamble.sh — auto-generated by relay publish
 set +e
@@ -28,7 +32,7 @@ DEVICE_HASH=$(echo "$HOSTNAME:$USER" | shasum -a 256 | cut -d' ' -f1)
 if command -v relay &>/dev/null; then
   relay ping "${slug}" --quiet 2>/dev/null &
 else
-  curl -sf -X POST "${apiUrl}/api/registry/${registrySlug}/ping" \\
+  curl -sf -X POST "${apiUrl}/api/spaces/${spacePart}/teams/${teamPart}/ping" \\
     -H "Content-Type: application/json" \\
     -d "{\\"device_hash\\":\\"$DEVICE_HASH\\"}" \\
     2>/dev/null &

package/dist/lib/slug.d.ts

@@ -15,5 +15,6 @@ export declare function isSimpleSlug(input: string): boolean;
 /**
  * Scoped 또는 단순 slug를 받아 ParsedSlug를 반환한다.
  * 단순 slug는 서버에 resolve를 요청한다.
+ * `@spaces/{spaceSlug}/{teamSlug}` 형식은 `@{spaceSlug}/{teamSlug}`로 정규화된다.
  */
 export declare function resolveSlug(input: string): Promise<ParsedSlug>;

package/dist/lib/slug.js

@@ -28,18 +28,22 @@ function isSimpleSlug(input) {
 /**
  * Scoped 또는 단순 slug를 받아 ParsedSlug를 반환한다.
  * 단순 slug는 서버에 resolve를 요청한다.
+ * `@spaces/{spaceSlug}/{teamSlug}` 형식은 `@{spaceSlug}/{teamSlug}`로 정규화된다.
  */
 async function resolveSlug(input) {
+    // @spaces/{spaceSlug}/{teamSlug} → @{spaceSlug}/{teamSlug} 정규화
+    const spacesPrefix = input.match(/^@spaces\/([a-z0-9][a-z0-9-]*)\/([a-z0-9][a-z0-9-]*)$/);
+    const normalized = spacesPrefix ? `@${spacesPrefix[1]}/${spacesPrefix[2]}` : input;
     // scoped slug면 바로 파싱
-    const parsed = parseSlug(input);
+    const parsed = parseSlug(normalized);
     if (parsed)
         return parsed;
     // 단순 slug인지 검증
-    if (!isSimpleSlug(input)) {
+    if (!isSimpleSlug(normalized)) {
         throw new Error(`잘못된 slug 형식입니다: '${input}'. @owner/name 또는 name 형태로 입력하세요.`);
     }
     // 서버에 resolve 요청
-    const results = await (0, api_js_1.resolveSlugFromServer)(input);
+    const results = await (0, api_js_1.resolveSlugFromServer)(normalized);
     if (results.length === 0) {
         throw new Error(`'${input}' 팀을 찾을 수 없습니다.`);
     }

package/package.json

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