relayax-cli 0.2.23 → 0.2.25

package/README.md

@@ -9,7 +9,7 @@ Agent Team Marketplace CLI - 에이전트 팀을 검색하고 설치하세요.
 npx relay-cli install contents-team
 
 # 또는 글로벌 설치
-npm install -g relay-cli
+npm install -g relayax-cli
 relay install contents-team
 ```
 

package/dist/commands/check-update.js

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerCheckUpdate = registerCheckUpdate;
 const version_check_js_1 = require("../lib/version-check.js");
 const slug_js_1 = require("../lib/slug.js");
-const config_js_1 = require("../lib/config.js");
 function registerCheckUpdate(program) {
     program
         .command('check-update [slug]')
@@ -32,19 +31,12 @@ function registerCheckUpdate(program) {
                 scopedSlug = slug;
             }
             else {
-                const installed = (0, config_js_1.loadInstalled)();
-                const found = (0, slug_js_1.findInstalledByName)(installed, slug);
-                if (found) {
-                    scopedSlug = found;
+                try {
+                    const parsed = await (0, slug_js_1.resolveSlug)(slug);
+                    scopedSlug = parsed.full;
                 }
-                else {
-                    try {
-                        const parsed = await (0, slug_js_1.resolveSlug)(slug);
-                        scopedSlug = parsed.full;
-                    }
-                    catch {
-                        scopedSlug = slug; // fallback to original
-                    }
+                catch {
+                    scopedSlug = slug;
                 }
             }
             const teamResult = await (0, version_check_js_1.checkTeamVersion)(scopedSlug, force);

package/dist/commands/deploy-record.d.ts

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

package/dist/commands/deploy-record.js

@@ -0,0 +1,93 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDeployRecord = registerDeployRecord;
+const path_1 = __importDefault(require("path"));
+const config_js_1 = require("../lib/config.js");
+const slug_js_1 = require("../lib/slug.js");
+function registerDeployRecord(program) {
+    program
+        .command('deploy-record <slug>')
+        .description('에이전트가 배치한 파일 정보를 installed.json에 기록합니다')
+        .requiredOption('--scope <scope>', '배치 범위 (global 또는 local)')
+        .option('--files <paths...>', '배치된 파일 경로 목록')
+        .action((slugInput, opts) => {
+        const json = program.opts().json ?? false;
+        const scope = opts.scope;
+        if (scope !== 'global' && scope !== 'local') {
+            const msg = { error: 'INVALID_SCOPE', message: '--scope는 global 또는 local이어야 합니다.' };
+            if (json) {
+                console.error(JSON.stringify(msg));
+            }
+            else {
+                console.error(`\x1b[31m오류:\x1b[0m ${msg.message}`);
+            }
+            process.exit(1);
+        }
+        const files = opts.files ?? [];
+        // Resolve absolute paths
+        const resolvedFiles = files.map((f) => f.startsWith('/') || f.startsWith('~')
+            ? f
+            : path_1.default.resolve(f));
+        // Find the team in the appropriate registry
+        const localRegistry = (0, config_js_1.loadInstalled)();
+        const globalRegistry = (0, config_js_1.loadGlobalInstalled)();
+        // Resolve slug — check both registries for short name match
+        let slug;
+        if ((0, slug_js_1.isScopedSlug)(slugInput)) {
+            slug = slugInput;
+        }
+        else {
+            const allKeys = [...Object.keys(localRegistry), ...Object.keys(globalRegistry)];
+            const match = allKeys.find((key) => {
+                const parsed = (0, slug_js_1.parseSlug)(key);
+                return parsed && parsed.name === slugInput;
+            });
+            slug = match ?? slugInput;
+        }
+        // Check if team exists in either registry
+        const entry = localRegistry[slug] ?? globalRegistry[slug];
+        if (!entry) {
+            const msg = { error: 'NOT_INSTALLED', message: `'${slugInput}'는 설치되어 있지 않습니다.` };
+            if (json) {
+                console.error(JSON.stringify(msg));
+            }
+            else {
+                console.error(`\x1b[31m오류:\x1b[0m ${msg.message}`);
+            }
+            process.exit(1);
+        }
+        // Update deploy info
+        entry.deploy_scope = scope;
+        entry.deployed_files = resolvedFiles;
+        // Save to the correct registry based on scope
+        if (scope === 'global') {
+            globalRegistry[slug] = entry;
+            (0, config_js_1.saveGlobalInstalled)(globalRegistry);
+            // Also update local registry if entry exists there
+            if (localRegistry[slug]) {
+                localRegistry[slug] = entry;
+                (0, config_js_1.saveInstalled)(localRegistry);
+            }
+        }
+        else {
+            localRegistry[slug] = entry;
+            (0, config_js_1.saveInstalled)(localRegistry);
+        }
+        const result = {
+            status: 'ok',
+            slug,
+            deploy_scope: scope,
+            deployed_files: resolvedFiles.length,
+        };
+        if (json) {
+            console.log(JSON.stringify(result));
+        }
+        else {
+            const scopeLabel = scope === 'global' ? '글로벌' : '로컬';
+            console.log(`\x1b[32m✓ ${slug} 배치 정보 기록 완료\x1b[0m (${scopeLabel}, ${resolvedFiles.length}개 파일)`);
+        }
+    });
+}

package/dist/commands/init.d.ts

@@ -1,4 +1,12 @@
 import { Command } from 'commander';
+/**
+ * 글로벌 User 커맨드를 ~/.claude/commands/relay/에 설치한다.
+ * 기존 파일 중 현재 커맨드 목록에 없는 것은 제거한다.
+ */
+export declare function installGlobalUserCommands(): {
+    installed: boolean;
+    commands: string[];
+};
 /**
  * 글로벌 User 커맨드가 이미 설치되어 있는지 확인한다.
  */

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.installGlobalUserCommands = installGlobalUserCommands;
 exports.hasGlobalUserCommands = hasGlobalUserCommands;
 exports.registerInit = registerInit;
 const fs_1 = __importDefault(require("fs"));

package/dist/commands/install.js

@@ -38,14 +38,12 @@ function registerInstall(program) {
         const json = program.opts().json ?? false;
         const projectPath = process.cwd();
         const tempDir = (0, storage_js_1.makeTempDir)();
+        // Auto-init: 글로벌 커맨드가 없으면 자동 설치
         if (!(0, init_js_1.hasGlobalUserCommands)()) {
             if (!json) {
-                console.error('\x1b[33m⚠ relay init이 실행되지 않았습니다. 먼저 relay init을 실행하세요.\x1b[0m');
+                console.error('\x1b[33m⚙ 글로벌 커맨드를 자동 설치합니다...\x1b[0m');
             }
-            else {
-                console.error(JSON.stringify({ error: 'NOT_INITIALIZED', message: 'relay init을 먼저 실행하세요.' }));
-            }
-            process.exit(1);
+            (0, init_js_1.installGlobalUserCommands)();
         }
         try {
             // 0. @spaces/{spaceSlug}/{teamSlug} 형식 감지 및 파싱
@@ -128,23 +126,33 @@ function registerInstall(program) {
                 }
             }
             const teamDir = path_1.default.join(projectPath, '.relay', 'teams', parsed.owner, parsed.name);
-            // 2. Visibility check
+            // 2. Visibility check + auto-login
             const visibility = team.visibility ?? 'public';
             if (visibility === 'private') {
-                const token = await (0, config_js_1.getValidToken)();
+                let token = await (0, config_js_1.getValidToken)();
                 if (!token) {
-                    if (json) {
-                        console.error(JSON.stringify({
-                            error: 'LOGIN_REQUIRED',
-                            visibility,
-                            slug,
-                            message: '이 팀은 Space 멤버만 설치할 수 있습니다. 로그인이 필요합니다.',
-                        }));
+                    const isTTY = Boolean(process.stdin.isTTY);
+                    if (isTTY && !json) {
+                        // Auto-login: TTY 환경에서 자동으로 login 플로우 트리거
+                        console.error('\x1b[33m⚙ 이 팀은 로그인이 필요합니다. 로그인을 시작합니다...\x1b[0m');
+                        const { runLogin } = await import('./login.js');
+                        await runLogin();
+                        token = await (0, config_js_1.getValidToken)();
                     }
-                    else {
-                        console.error('\x1b[31m이 팀은 Space 멤버만 설치할 수 있습니다. relay login 을 먼저 실행하세요.\x1b[0m');
+                    if (!token) {
+                        if (json) {
+                            console.error(JSON.stringify({
+                                error: 'LOGIN_REQUIRED',
+                                visibility,
+                                slug,
+                                message: '이 팀은 로그인이 필요합니다. relay login을 먼저 실행하세요.',
+                            }));
+                        }
+                        else {
+                            console.error('\x1b[31m이 팀은 로그인이 필요합니다. relay login 을 먼저 실행하세요.\x1b[0m');
+                        }
+                        process.exit(1);
                     }
-                    process.exit(1);
                 }
             }
             // 3. Download package
@@ -252,7 +260,7 @@ function registerInstall(program) {
                 else {
                     console.log(`\n\x1b[33m💡 설치 완료! AI 에이전트에서 사용할 수 있습니다.\x1b[0m`);
                 }
-                console.log('\n  에이전트가 /relay-install로 환경을 구성합니다.');
+                console.log('\n  \x1b[90m에이전트가 /relay-install로 환경을 구성합니다.\x1b[0m');
             }
         }
         catch (err) {

package/dist/commands/list.js

@@ -68,27 +68,53 @@ function registerList(program) {
             }
             return;
         }
-        // 기본 동작: 로컬에 설치된 팀 목록
-        const installed = (0, config_js_1.loadInstalled)();
-        const entries = Object.entries(installed);
-        const installedList = entries.map(([slug, info]) => ({
-            slug,
-            version: info.version,
-            installed_at: info.installed_at,
-            files: info.files.length,
-        }));
+        // 기본 동작: 글로벌 + 로컬 통합 목록
+        const { global: globalInstalled, local: localInstalled } = (0, config_js_1.loadMergedInstalled)();
+        const allEntries = [];
+        const seen = new Set();
+        // 글로벌 먼저
+        for (const [slug, info] of Object.entries(globalInstalled)) {
+            allEntries.push({
+                slug,
+                version: info.version,
+                installed_at: info.installed_at,
+                scope: 'global',
+                deploy_scope: info.deploy_scope,
+                space_slug: info.space_slug,
+            });
+            seen.add(slug);
+        }
+        // 로컬 (글로벌과 중복되지 않는 것만)
+        for (const [slug, info] of Object.entries(localInstalled)) {
+            if (seen.has(slug))
+                continue;
+            allEntries.push({
+                slug,
+                version: info.version,
+                installed_at: info.installed_at,
+                scope: 'local',
+                deploy_scope: info.deploy_scope,
+                space_slug: info.space_slug,
+            });
+        }
         if (json) {
-            console.log(JSON.stringify({ installed: installedList }));
+            console.log(JSON.stringify({ installed: allEntries }));
         }
         else {
-            if (installedList.length === 0) {
+            if (allEntries.length === 0) {
                 console.log('\n설치된 팀이 없습니다. `relay install <slug>`로 설치하세요.');
                 return;
             }
-            console.log(`\n설치된 팀 (${installedList.length}개):\n`);
-            for (const item of installedList) {
+            console.log(`\n설치된 팀 (${allEntries.length}개):\n`);
+            for (const item of allEntries) {
                 const date = new Date(item.installed_at).toLocaleDateString('ko-KR');
-                console.log(`  \x1b[36m${item.slug}\x1b[0m  v${item.version}  (${date})  파일 ${item.files}개`);
+                const scopeLabel = item.deploy_scope === 'global'
+                    ? '\x1b[32m글로벌\x1b[0m'
+                    : item.deploy_scope === 'local'
+                        ? '\x1b[33m로컬\x1b[0m'
+                        : '\x1b[90m미배치\x1b[0m';
+                const spaceLabel = item.space_slug ? `  \x1b[90m[Space: ${item.space_slug}]\x1b[0m` : '';
+                console.log(`  \x1b[36m${item.slug}\x1b[0m  v${item.version}  ${scopeLabel}  (${date})${spaceLabel}`);
             }
         }
     });

package/dist/commands/login.d.ts

@@ -1,2 +1,7 @@
 import { Command } from 'commander';
+/**
+ * 대화형 로그인 플로우 실행 (auto-login에서 호출).
+ * 로그인 성공 시 토큰 저장, 실패 시 throw.
+ */
+export declare function runLogin(): Promise<void>;
 export declare function registerLogin(program: Command): void;

package/dist/commands/login.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.runLogin = runLogin;
 exports.registerLogin = registerLogin;
 const http_1 = __importDefault(require("http"));
 const readline_1 = __importDefault(require("readline"));
@@ -38,9 +39,6 @@ async function verifyToken(token) {
         return null;
     }
 }
-function parseFormBody(body) {
-    return new URLSearchParams(body);
-}
 function collectBody(req) {
     return new Promise((resolve) => {
         const chunks = [];
@@ -65,16 +63,9 @@ function waitForToken(port) {
         }, 5 * 60 * 1000);
         const server = http_1.default.createServer(async (req, res) => {
             const url = new URL(req.url ?? '/', `http://localhost:${port}`);
-            if (url.pathname === '/callback') {
-                // POST body (secure) 또는 GET query params (하위 호환) 모두 지원
-                let params;
-                if (req.method === 'POST') {
-                    const body = await collectBody(req);
-                    params = parseFormBody(body);
-                }
-                else {
-                    params = url.searchParams;
-                }
+            if (url.pathname === '/callback' && req.method === 'POST') {
+                const body = await collectBody(req);
+                const params = new URLSearchParams(body);
                 const token = params.get('token');
                 const refresh_token = params.get('refresh_token') ?? undefined;
                 const expires_at_raw = params.get('expires_at');
@@ -210,6 +201,31 @@ async function selectProvider(json) {
         return 'email';
     return 'github';
 }
+/**
+ * 대화형 로그인 플로우 실행 (auto-login에서 호출).
+ * 로그인 성공 시 토큰 저장, 실패 시 throw.
+ */
+async function runLogin() {
+    (0, config_js_1.ensureGlobalRelayDir)();
+    const provider = await selectProvider(false);
+    let loginResult;
+    if (provider === 'email') {
+        loginResult = await loginWithEmail(false);
+    }
+    else if (provider === 'kakao') {
+        loginResult = await loginWithBrowser('kakao', false);
+    }
+    else {
+        loginResult = await loginWithBrowser('github', false);
+    }
+    await verifyToken(loginResult.token);
+    (0, config_js_1.saveTokenData)({
+        access_token: loginResult.token,
+        ...(loginResult.refresh_token ? { refresh_token: loginResult.refresh_token } : {}),
+        ...(loginResult.expires_at ? { expires_at: loginResult.expires_at } : {}),
+    });
+    console.log(`\x1b[32m✓ 로그인 완료\x1b[0m`);
+}
 function registerLogin(program) {
     program
         .command('login')

package/dist/commands/publish.js

@@ -646,6 +646,19 @@ function registerPublish(program) {
                     console.log(`  \x1b[90m└${'─'.repeat(44)}┘\x1b[0m`);
                     console.log(`\n  \x1b[90m명함 수정: \x1b[36mwww.relayax.com/dashboard/profile\x1b[0m`);
                 }
+                // Show shareable onboarding guide as a plain copyable block
+                if (isTTY) {
+                    const guideLines = [
+                        'npm install -g relayax-cli',
+                        'relay login',
+                        `relay install ${result.slug}`,
+                    ];
+                    console.log(`\n  \x1b[90m공유용 온보딩 가이드:\x1b[0m\n`);
+                    console.log('```');
+                    guideLines.forEach((line) => console.log(line));
+                    console.log('```');
+                    console.log(`\n  \x1b[90m위 블록을 복사하여 팀원에게 공유하세요\x1b[0m`);
+                }
             }
         }
         catch (err) {

package/dist/commands/uninstall.js

@@ -1,6 +1,11 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerUninstall = registerUninstall;
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
 const config_js_1 = require("../lib/config.js");
 const installer_js_1 = require("../lib/installer.js");
 const slug_js_1 = require("../lib/slug.js");
@@ -10,17 +15,24 @@ function registerUninstall(program) {
         .description('에이전트 팀 제거')
         .action((slugInput) => {
         const json = program.opts().json ?? false;
-        const installed = (0, config_js_1.loadInstalled)();
-        // Resolve slug from installed.json
+        const localInstalled = (0, config_js_1.loadInstalled)();
+        const globalInstalled = (0, config_js_1.loadGlobalInstalled)();
+        // Resolve slug — support short names like "cardnews-team"
         let slug;
         if ((0, slug_js_1.isScopedSlug)(slugInput)) {
             slug = slugInput;
         }
         else {
-            const found = (0, slug_js_1.findInstalledByName)(installed, slugInput);
-            slug = found ?? slugInput;
+            const allKeys = [...Object.keys(localInstalled), ...Object.keys(globalInstalled)];
+            const match = allKeys.find((key) => {
+                const parsed = (0, slug_js_1.parseSlug)(key);
+                return parsed && parsed.name === slugInput;
+            });
+            slug = match ?? slugInput;
         }
-        if (!installed[slug]) {
+        const localEntry = localInstalled[slug];
+        const globalEntry = globalInstalled[slug];
+        if (!localEntry && !globalEntry) {
             const msg = { error: 'NOT_INSTALLED', message: `'${slugInput}'는 설치되어 있지 않습니다.` };
             if (json) {
                 console.error(JSON.stringify(msg));
@@ -30,21 +42,55 @@ function registerUninstall(program) {
             }
             process.exit(1);
         }
-        const { files } = installed[slug];
-        const removed = (0, installer_js_1.uninstallTeam)(files);
-        delete installed[slug];
-        (0, config_js_1.saveInstalled)(installed);
+        let totalRemoved = 0;
+        // Remove from local registry
+        if (localEntry) {
+            const removed = (0, installer_js_1.uninstallTeam)(localEntry.files);
+            totalRemoved += removed.length;
+            // Remove deployed files
+            if (localEntry.deployed_files && localEntry.deployed_files.length > 0) {
+                const deployedRemoved = (0, installer_js_1.uninstallTeam)(localEntry.deployed_files);
+                totalRemoved += deployedRemoved.length;
+                // Clean empty parent directories
+                const boundary = path_1.default.join(process.cwd(), '.claude');
+                for (const f of deployedRemoved) {
+                    (0, installer_js_1.cleanEmptyParents)(f, boundary);
+                }
+            }
+            delete localInstalled[slug];
+            (0, config_js_1.saveInstalled)(localInstalled);
+        }
+        // Remove from global registry
+        if (globalEntry) {
+            // Only remove files if not already handled by local entry
+            if (!localEntry) {
+                const removed = (0, installer_js_1.uninstallTeam)(globalEntry.files);
+                totalRemoved += removed.length;
+            }
+            // Remove globally deployed files
+            if (globalEntry.deployed_files && globalEntry.deployed_files.length > 0) {
+                const deployedRemoved = (0, installer_js_1.uninstallTeam)(globalEntry.deployed_files);
+                totalRemoved += deployedRemoved.length;
+                // Clean empty parent directories
+                const boundary = path_1.default.join(os_1.default.homedir(), '.claude');
+                for (const f of deployedRemoved) {
+                    (0, installer_js_1.cleanEmptyParents)(f, boundary);
+                }
+            }
+            delete globalInstalled[slug];
+            (0, config_js_1.saveGlobalInstalled)(globalInstalled);
+        }
         const result = {
             status: 'ok',
             team: slug,
-            files_removed: removed.length,
+            files_removed: totalRemoved,
         };
         if (json) {
             console.log(JSON.stringify(result));
         }
         else {
             console.log(`\n\x1b[32m✓ ${slug} 제거 완료\x1b[0m`);
-            console.log(`  삭제된 파일: ${removed.length}개`);
+            console.log(`  삭제된 파일: ${totalRemoved}개`);
         }
     });
 }

package/dist/commands/update.js

@@ -26,14 +26,8 @@ function registerUpdate(program) {
                 slug = slugInput;
             }
             else {
-                const found = (0, slug_js_1.findInstalledByName)(installed, slugInput);
-                if (found) {
-                    slug = found;
-                }
-                else {
-                    const parsed = await (0, slug_js_1.resolveSlug)(slugInput);
-                    slug = parsed.full;
-                }
+                const parsed = await (0, slug_js_1.resolveSlug)(slugInput);
+                slug = parsed.full;
             }
             // Check installed.json for current version
             const currentEntry = installed[slug];
@@ -68,11 +62,17 @@ function registerUpdate(program) {
             (0, preamble_js_1.injectPreambleToTeam)(extractDir, slug);
             // Copy files to install_path
             const files = (0, installer_js_1.installTeam)(extractDir, installPath);
+            // Preserve deploy info but clear deployed_files (agent needs to re-deploy)
+            const previousDeployScope = currentEntry?.deploy_scope;
+            const hadDeployedFiles = (currentEntry?.deployed_files?.length ?? 0) > 0;
             // Update installed.json with new version
             installed[slug] = {
                 version: latestVersion,
                 installed_at: new Date().toISOString(),
                 files,
+                // Keep deploy_scope so agent knows where to re-deploy
+                ...(previousDeployScope ? { deploy_scope: previousDeployScope } : {}),
+                // Clear deployed_files — agent must re-deploy and call deploy-record
             };
             (0, config_js_1.saveInstalled)(installed);
             // Report install (non-blocking)
@@ -84,6 +84,7 @@ function registerUpdate(program) {
                 version: latestVersion,
                 files_installed: files.length,
                 install_path: installPath,
+                ...(hadDeployedFiles ? { needs_redeploy: true, previous_deploy_scope: previousDeployScope } : {}),
             };
             if (json) {
                 console.log(JSON.stringify(result));

package/dist/index.js

@@ -18,6 +18,7 @@ const follow_js_1 = require("./commands/follow.js");
 const changelog_js_1 = require("./commands/changelog.js");
 const join_js_1 = require("./commands/join.js");
 const spaces_js_1 = require("./commands/spaces.js");
+const deploy_record_js_1 = require("./commands/deploy-record.js");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const pkg = require('../package.json');
 const program = new commander_1.Command();
@@ -42,4 +43,5 @@ program
 (0, changelog_js_1.registerChangelog)(program);
 (0, join_js_1.registerJoin)(program);
 (0, spaces_js_1.registerSpaces)(program);
+(0, deploy_record_js_1.registerDeployRecord)(program);
 program.parse();

package/dist/lib/command-adapter.d.ts

@@ -29,5 +29,3 @@ export declare function getGlobalCommandDir(): string;
 export declare function formatCommandFile(content: CommandContent): string;
 export declare const USER_COMMANDS: CommandContent[];
 export declare const BUILDER_COMMANDS: CommandContent[];
-/** 하위 호환 — 기존 코드에서 RELAY_COMMANDS를 참조하는 경우 */
-export declare const RELAY_COMMANDS: CommandContent[];

package/dist/lib/command-adapter.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RELAY_COMMANDS = exports.BUILDER_COMMANDS = exports.USER_COMMANDS = void 0;
+exports.BUILDER_COMMANDS = exports.USER_COMMANDS = void 0;
 exports.createAdapter = createAdapter;
 exports.getGlobalCommandPath = getGlobalCommandPath;
 exports.getGlobalCommandDir = getGlobalCommandDir;
@@ -20,9 +20,7 @@ function createAdapter(tool) {
         getFilePath(commandId) {
             return path_1.default.join(tool.skillsDir, 'commands', 'relay', `${commandId}.md`);
         },
-        formatFile(content) {
-            return `---\ndescription: ${content.description}\n---\n\n${content.body}\n`;
-        },
+        formatFile: formatCommandFile,
     };
 }
 /**
@@ -101,44 +99,46 @@ exports.USER_COMMANDS = [
 
 ## 실행 방법
 
-### 0. 업데이트 확인
-- 먼저 \`relay check-update\` 명령어를 실행합니다.
-- CLI 업데이트가 있으면 사용자에게 안내합니다: "relay v{new} available. Run: npm update -g relayax-cli"
-- 팀 업데이트가 있으면 안내합니다.
-- 업데이트 여부와 관계없이 설치를 계속 진행합니다.
-
-### 1. 팀 패키지 다운로드
-- Public 마켓 팀: \`relay install <@author/slug>\` 명령어를 실행합니다.
-- Space 팀: \`relay install @spaces/<space-slug>/<team-slug>\` 명령어를 실행합니다.
+### 1. 패키지 다운로드
+\`relay install <@author/slug> --json\` 명령어를 실행합니다.
+- Public 마켓 팀: \`relay install <@author/slug> --json\`
+- Space 팀: \`relay install @spaces/<space-slug>/<team-slug> --json\`
   - Space 가입이 필요하면: \`relay join <space-slug> --code <invite-code>\` 를 먼저 실행합니다.
-  - 또는 \`relay install @spaces/<space-slug>/<team-slug> --join-code <code>\` 로 가입+설치를 한번에 할 수 있습니다.
-- 패키지가 \`.relay/teams/<slug>/\`에 다운로드됩니다.
-
-### 2. 패키지 내용 확인
-다운로드된 \`.relay/teams/<slug>/\` 디렉토리를 읽어 구조를 파악합니다:
-- skills/ — 스킬 파일들
-- commands/ — 슬래시 커맨드 파일들
-- agents/ — 에이전트 설정 파일들
-- rules/ — 룰 파일들
-- relay.yaml — 팀 메타데이터 및 requirements
-
-### 3. 기존 파일 충돌 확인
-배치 대상 디렉토리(\`.claude/commands/\`, \`.claude/skills/\` 등)에 **같은 이름의 파일이 이미 존재하는지** 확인합니다.
-- 충돌하는 파일이 있으면 사용자에게 반드시 물어봅니다:
-  - "다음 파일이 이미 존재합니다: {파일 목록}. 덮어쓸까요, 건너뛸까요?"
-  - 사용자가 선택할 때까지 진행하지 않습니다.
-- 충돌이 없으면 그대로 진행합니다.
-- **주의**: 팀에 포함되지 않은 기존 파일은 절대 삭제하지 않습니다.
-
-### 4. 에이전트 환경에 맞게 배치
-현재 에이전트의 디렉토리 구조에 맞게 파일을 복사합니다:
-- Claude Code: \`.relay/teams/<slug>/commands/\` → \`.claude/commands/\`에 복사
-- Claude Code: \`.relay/teams/<slug>/skills/\` → \`.claude/skills/\`에 복사
-- 다른 에이전트(Cursor, Cline 등): 해당 에이전트의 규칙에 맞는 디렉토리에 복사
-- 에이전트 설정이나 룰은 적절한 위치에 배치
+  - 또는 \`--join-code <code>\`로 가입+설치를 한번에 할 수 있습니다.
+- CLI가 init과 login을 자동으로 처리합니다 (사용자가 별도 실행할 필요 없음).
+- JSON 출력에서 \`install_path\` (패키지 경로)를 확인합니다.
+
+### 2. 배치 범위 선택
+사용자에게 설치 범위를 물어봅니다:
+
+- **글로벌** (\`~/.claude/\`): 모든 프로젝트에서 사용 가능
+- **로컬** (현재 프로젝트 \`.claude/\`): 이 프로젝트에서만 사용
+
+판단 기준:
+- 범용 도구 (카드뉴스, PDF 생성 등): 글로벌 추천
+- 프로젝트 전용 팀: 로컬 추천
+- Space 비공개 팀: 로컬 추천
+
+사용자가 별도 지정하지 않으면 글로벌로 진행합니다.
+
+### 3. 에이전트 환경에 맞게 배치
+다운로드된 패키지(\`install_path\`)에서 파일을 읽고 선택된 범위에 배치합니다:
+- Claude Code 글로벌: \`<install_path>/commands/\` → \`~/.claude/commands/\`에 복사
+- Claude Code 글로벌: \`<install_path>/skills/\` → \`~/.claude/skills/\`에 복사
+- Claude Code 로컬: \`<install_path>/commands/\` → \`.claude/commands/\`에 복사
+- Claude Code 로컬: \`<install_path>/skills/\` → \`.claude/skills/\`에 복사
+- agents/, rules/ 파일도 같은 방식으로 배치합니다.
+- **충돌 확인**: 같은 이름의 파일이 이미 있으면 사용자에게 덮어쓸지 물어봅니다.
+
+### 4. 배치 정보 기록 (필수)
+배치 완료 후 반드시 \`relay deploy-record\`를 실행하여 배치 정보를 기록합니다:
+\`\`\`
+relay deploy-record <slug> --scope <global|local> --files <배치된_파일1> <배치된_파일2> ...
+\`\`\`
+이 정보는 \`relay uninstall\` 시 배치된 파일까지 정리하는 데 사용됩니다.
 
 ### 5. Requirements 확인 및 설치
-\`.relay/teams/<slug>/relay.yaml\`의 \`requires\` 섹션을 읽고 처리합니다:
+\`<install_path>/relay.yaml\`의 \`requires\` 섹션을 읽고 처리합니다:
 - **cli**: \`which <name>\`으로 확인 → 없으면 install 명령 실행 또는 안내
 - **npm**: \`npm list <package>\`로 확인 → 없으면 \`npm install\`
 - **env**: 환경변수 확인 → required이면 설정 안내, optional이면 알림
@@ -155,21 +155,20 @@ ${BUSINESS_CARD_FORMAT}
   - 거절하면: 건너뜁니다
 - "바로 사용해볼까요?" 제안
 
+### 7. 업데이트 확인 (설치 완료 후)
+- \`relay check-update\` 명령어를 실행합니다.
+- CLI 업데이트가 있으면 안내합니다: "relay v{new} available. Run: npm update -g relayax-cli"
+- 다른 팀 업데이트가 있으면 안내합니다.
+
 ## 예시
 
 사용자: /relay-install @example/contents-team
-→ relay install @example/contents-team 실행 (패키지 다운로드)
-→ .relay/teams/@example/contents-team/ 내용 확인
-→ commands/cardnews.md → .claude/commands/cardnews.md 복사
-→ skills/pdf-gen.md → .claude/skills/pdf-gen.md 복사
+→ relay install @example/contents-team --json 실행 (패키지 다운로드)
+→ 사용자에게 "글로벌 vs 로컬" 선택 질문 → 글로벌
+→ .relay/teams/ 내용을 ~/.claude/에 배치
+→ relay deploy-record @example/contents-team --scope global --files ~/.claude/commands/cardnews.md ...
 → requires 확인: ✓ playwright 설치됨, ✓ sharp 설치됨
-→ "✓ 설치 완료! /cardnews를 사용해볼까요?"
-
-사용자: /relay-install @spaces/bobusan/pm-bot
-→ relay install @spaces/bobusan/pm-bot 실행
-→ Space 멤버 확인 → 정상
-→ 패키지 다운로드 및 배치
-→ "✓ 설치 완료!"`,
+→ "✓ 설치 완료! /cardnews를 사용해볼까요?"`,
     },
     {
         id: 'relay-list',
@@ -218,6 +217,9 @@ ${BUSINESS_CARD_FORMAT}
 ### 특정 팀 업데이트
 - 사용자가 팀 이름을 지정한 경우: \`relay update <@author/slug> --json\` 실행
 - 업데이트 결과를 보여줍니다 (이전 버전 → 새 버전)
+- **재배치 필요 확인**: JSON 출력에 \`needs_redeploy: true\`가 있으면:
+  1. \`previous_deploy_scope\`를 참고하여 같은 범위(글로벌/로컬)로 파일을 다시 배치합니다.
+  2. 배치 후 \`relay deploy-record <slug> --scope <scope> --files <...>\`를 실행하여 기록합니다.
 ${BUSINESS_CARD_FORMAT}
 
 ### 전체 업데이트 확인
@@ -235,18 +237,50 @@ ${BUSINESS_CARD_FORMAT}
 → "  @example/contents-team: v1.2.0 → v1.3.0"
 → "업데이트할까요?"
 → relay update @example/contents-team --json 실행
+→ needs_redeploy: true → 글로벌로 재배치
+→ relay deploy-record @example/contents-team --scope global --files ...
 → "✓ @example/contents-team v1.3.0으로 업데이트 완료"`,
+    },
+    {
+        id: 'relay-spaces',
+        description: '내 Space 목록을 확인합니다',
+        body: `사용자의 Space 목록을 조회하고 보여줍니다.
+
+## 실행 방법
+
+1. \`relay spaces --json\` 명령어를 실행합니다.
+2. 결과를 사용자에게 보기 좋게 정리합니다:
+   - 개인 스페이스
+   - 팀 스페이스 (이름, 역할, 설명)
+3. Space가 있으면 관련 활용법을 안내합니다:
+   - 팀 목록 보기: \`relay list --space <slug>\`
+   - 비공개 팀 설치: \`relay install @spaces/<slug>/<team>\`
+   - Space 관리: www.relayax.com/spaces/<slug>
+${LOGIN_JIT_GUIDE}
+
+## 예시
+
+사용자: /relay-spaces
+→ relay spaces --json 실행
+→ "2개 Space가 있어요:"
+→ "  bobusan — 보부산 (소유자)"
+→ "  design-lab — 디자인 랩 (멤버)"
+→ "💡 Space 팀 보기: relay list --space bobusan"`,
     },
     {
         id: 'relay-uninstall',
         description: '설치된 에이전트 팀을 삭제합니다',
-        body: `설치된 에이전트 팀을 프로젝트에서 제거합니다.
+        body: `설치된 에이전트 팀을 제거합니다. CLI가 패키지와 배치된 파일을 모두 정리합니다.
 
 ## 실행 방법
 
 1. \`relay uninstall <@author/slug> --json\` 명령어를 실행합니다.
-2. 삭제 결과를 보여줍니다 (팀 이름, 제거된 파일 수).
-3. 삭제 완료 후 남아있는 팀 목록을 간단히 안내합니다.
+2. CLI가 자동으로 처리하는 것:
+   - \`.relay/teams/\` 패키지 삭제
+   - \`deployed_files\`에 기록된 배치 파일 삭제 (\`~/.claude/\` 또는 \`.claude/\`)
+   - 빈 상위 디렉토리 정리
+   - installed.json에서 항목 제거 (글로벌/로컬 양쪽)
+3. 삭제 결과를 보여줍니다 (팀 이름, 제거된 파일 수).
 
 ## 예시
 
@@ -265,9 +299,9 @@ exports.BUILDER_COMMANDS = [
 ## 실행 단계
 
 ### 1. 인증 확인 (가장 먼저)
-- \`cat ~/.relay/token\` 또는 환경변수 RELAY_TOKEN으로 토큰 존재 여부를 확인합니다.
-- 미인증이면 즉시 안내: "먼저 \`relay login\`으로 로그인이 필요합니다." → 로그인 후 재실행 안내.
-- 인증되어 있으면 다음 단계로 진행합니다.
+- \`relay status --json\` 명령어를 실행하여 로그인 상태를 확인합니다.
+- 미인증이면 즉시 \`relay login\`을 실행합니다.
+- 로그인 완료 후 다음 단계로 진행합니다.
 ${LOGIN_JIT_GUIDE}
 
 ### 2. 팀 구조 분석
@@ -363,8 +397,9 @@ requires:
 - 각 스킬의 SKILL.md, 에이전트 설정, 커맨드 문서를 분석하여 팀의 파이프라인 흐름을 추론합니다.
 
 #### 5-2. GUIDE.html 생성
-- \`cli/src/lib/guide.ts\`의 \`GUIDE_HTML_PROMPT\`를 읽고, 해당 프롬프트의 콘텐츠 구조와 디자인 규칙을 따라 GUIDE.html을 생성합니다.
-- 5-1에서 분석한 팀 소스 정보를 프롬프트에 반영합니다.
+- 팀의 핵심 기능, 시작 방법, 파이프라인 흐름, Q&A를 포함하는 단일 HTML 가이드를 생성합니다.
+- 디자인: 깔끔한 단일 페이지, 시스템 폰트, 최대 1200px 너비, 라이트 테마.
+- 5-1에서 분석한 팀 소스 정보를 기반으로 콘텐츠를 구성합니다.
 - 파이프라인이 없는 단순한 팀은 시작 방법 + 기능 설명 + Q&A만 포함합니다.
 
 #### 5-3. 미리보기 + 컨펌
@@ -419,6 +454,20 @@ portfolio:
 ### 9. 배포
 - \`relay publish\` 명령어를 실행합니다.
 - 배포 결과와 마켓플레이스 URL을 보여줍니다.
+
+### 10. 공유용 온보딩 가이드 제공
+- \`relay publish\` 출력 끝에 코드블록 형태의 온보딩 가이드가 포함됩니다.
+- 이 코드블록을 사용자에게 그대로 보여줍니다.
+- 출력에 코드블록이 없으면 아래 형태로 직접 생성합니다:
+
+\\\`\\\`\\\`
+npm install -g relayax-cli
+relay login
+relay install <slug>
+\\\`\\\`\\\`
+
+- \`<slug>\`는 배포된 팀의 실제 슬러그로 치환합니다.
+- "이 블록을 팀원에게 공유하면 바로 설치할 수 있습니다"라고 안내합니다.
 ${BUSINESS_CARD_FORMAT}
 
 ## 예시
@@ -432,8 +481,8 @@ ${BUSINESS_CARD_FORMAT}
 → GUIDE.html 생성 → 브라우저에서 미리보기 → 빌더 컨펌
 → GUIDE.html 스크린샷 → gallery 첫 번째 이미지로 등록
 → relay publish 실행
-→ "배포 완료! URL: https://relayax.com/teams/my-team"`,
+→ "배포 완료! URL: https://relayax.com/teams/my-team"
+→ 온보딩 가이드 코드블록 표시
+→ "이 블록을 팀원에게 공유하면 바로 설치할 수 있습니다"`,
     },
 ];
-/** 하위 호환 — 기존 코드에서 RELAY_COMMANDS를 참조하는 경우 */
-exports.RELAY_COMMANDS = [...exports.USER_COMMANDS, ...exports.BUILDER_COMMANDS];

package/dist/lib/config.d.ts

@@ -28,12 +28,16 @@ export declare function saveToken(token: string): void;
  * 4. 갱신 실패 시 undefined (재로그인 필요)
  */
 export declare function getValidToken(): Promise<string | undefined>;
-/** 프로젝트 로컬 installed.json 읽기 (unscoped 키 자동 마이그레이션) */
+/** 프로젝트 로컬 installed.json 읽기 */
 export declare function loadInstalled(): InstalledRegistry;
-/**
- * 비동기 마이그레이션: unscoped 키를 서버 resolve하여 scoped 키로 변환.
- * install/update 등 비동기 커맨드에서 호출.
- */
-export declare function migrateInstalled(): Promise<void>;
 /** 프로젝트 로컬 installed.json 쓰기 */
 export declare function saveInstalled(registry: InstalledRegistry): void;
+/** 글로벌 installed.json 읽기 (~/.relay/installed.json) */
+export declare function loadGlobalInstalled(): InstalledRegistry;
+/** 글로벌 installed.json 쓰기 (~/.relay/installed.json) */
+export declare function saveGlobalInstalled(registry: InstalledRegistry): void;
+/** 글로벌 + 로컬 레지스트리 병합 뷰 */
+export declare function loadMergedInstalled(): {
+    global: InstalledRegistry;
+    local: InstalledRegistry;
+};

package/dist/lib/config.js

@@ -13,13 +13,14 @@ exports.saveTokenData = saveTokenData;
 exports.saveToken = saveToken;
 exports.getValidToken = getValidToken;
 exports.loadInstalled = loadInstalled;
-exports.migrateInstalled = migrateInstalled;
 exports.saveInstalled = saveInstalled;
+exports.loadGlobalInstalled = loadGlobalInstalled;
+exports.saveGlobalInstalled = saveGlobalInstalled;
+exports.loadMergedInstalled = loadMergedInstalled;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
 const ai_tools_js_1 = require("./ai-tools.js");
-const slug_js_1 = require("./slug.js");
 exports.API_URL = 'https://www.relayax.com';
 const GLOBAL_RELAY_DIR = path_1.default.join(os_1.default.homedir(), '.relay');
 /**
@@ -63,7 +64,6 @@ function loadTokenData() {
         const raw = fs_1.default.readFileSync(tokenFile, 'utf-8').trim();
         if (!raw)
             return undefined;
-        // JSON 형식 (새 포맷)
         if (raw.startsWith('{')) {
             return JSON.parse(raw);
         }
@@ -121,76 +121,45 @@ async function getValidToken() {
         return undefined;
     }
 }
-/** 프로젝트 로컬 installed.json 읽기 (unscoped 키 자동 마이그레이션) */
+/** 프로젝트 로컬 installed.json 읽기 */
 function loadInstalled() {
     const file = path_1.default.join(process.cwd(), '.relay', 'installed.json');
     if (!fs_1.default.existsSync(file)) {
         return {};
     }
     try {
-        const raw = fs_1.default.readFileSync(file, 'utf-8');
-        const registry = JSON.parse(raw);
-        return migrateInstalledKeys(registry);
+        return JSON.parse(fs_1.default.readFileSync(file, 'utf-8'));
     }
     catch {
         return {};
     }
 }
-/**
- * unscoped 키를 감지하여 서버 resolve 없이 가능한 마이그레이션을 수행한다.
- * 서버 resolve가 필요한 경우는 마이그레이션 보류 (다음 기회에 재시도).
- */
-function migrateInstalledKeys(registry) {
-    const unscopedKeys = Object.keys(registry).filter((k) => !(0, slug_js_1.isScopedSlug)(k) && k !== 'relay-core');
-    if (unscopedKeys.length === 0)
-        return registry;
-    // 비동기 서버 resolve 없이는 owner를 알 수 없으므로,
-    // loadInstalled는 동기 함수 → 마이그레이션은 비동기 migrateInstalled()로 별도 호출
-    return registry;
-}
-/**
- * 비동기 마이그레이션: unscoped 키를 서버 resolve하여 scoped 키로 변환.
- * install/update 등 비동기 커맨드에서 호출.
- */
-async function migrateInstalled() {
-    const { resolveSlugFromServer } = await import('./api.js');
-    const registry = loadInstalled();
-    const teamsDir = path_1.default.join(process.cwd(), '.relay', 'teams');
-    let changed = false;
-    for (const key of Object.keys(registry)) {
-        if ((0, slug_js_1.isScopedSlug)(key) || key === 'relay-core')
-            continue;
-        try {
-            const results = await resolveSlugFromServer(key);
-            if (results.length !== 1)
-                continue;
-            const { owner, name } = results[0];
-            const scopedKey = `@${owner}/${name}`;
-            // installed.json 키 변환
-            registry[scopedKey] = registry[key];
-            delete registry[key];
-            // 디렉토리 이동
-            const oldDir = path_1.default.join(teamsDir, key);
-            const newDir = path_1.default.join(teamsDir, owner, name);
-            if (fs_1.default.existsSync(oldDir)) {
-                fs_1.default.mkdirSync(path_1.default.dirname(newDir), { recursive: true });
-                fs_1.default.renameSync(oldDir, newDir);
-                // files 배열 업데이트
-                registry[scopedKey].files = registry[scopedKey].files.map((f) => f.replace(`/teams/${key}`, `/teams/${owner}/${name}`));
-            }
-            changed = true;
-        }
-        catch {
-            // 네트워크 오류 등 — 다음 기회에 재시도
-        }
-    }
-    if (changed) {
-        saveInstalled(registry);
-    }
-}
 /** 프로젝트 로컬 installed.json 쓰기 */
 function saveInstalled(registry) {
     ensureProjectRelayDir();
     const file = path_1.default.join(process.cwd(), '.relay', 'installed.json');
     fs_1.default.writeFileSync(file, JSON.stringify(registry, null, 2));
 }
+// ─── 글로벌 레지스트리 ───
+/** 글로벌 installed.json 읽기 (~/.relay/installed.json) */
+function loadGlobalInstalled() {
+    const file = path_1.default.join(GLOBAL_RELAY_DIR, 'installed.json');
+    if (!fs_1.default.existsSync(file))
+        return {};
+    try {
+        return JSON.parse(fs_1.default.readFileSync(file, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+/** 글로벌 installed.json 쓰기 (~/.relay/installed.json) */
+function saveGlobalInstalled(registry) {
+    ensureGlobalRelayDir();
+    const file = path_1.default.join(GLOBAL_RELAY_DIR, 'installed.json');
+    fs_1.default.writeFileSync(file, JSON.stringify(registry, null, 2));
+}
+/** 글로벌 + 로컬 레지스트리 병합 뷰 */
+function loadMergedInstalled() {
+    return { global: loadGlobalInstalled(), local: loadInstalled() };
+}

package/dist/lib/installer.d.ts

@@ -1,2 +1,7 @@
 export declare function installTeam(extractedDir: string, installPath: string): string[];
 export declare function uninstallTeam(files: string[]): string[];
+/**
+ * 빈 상위 디렉토리를 boundary까지 정리한다.
+ * 예: /home/.claude/skills/cardnews/ 가 비었으면 삭제, /home/.claude/skills/는 유지
+ */
+export declare function cleanEmptyParents(filePath: string, boundary: string): void;

package/dist/lib/installer.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.installTeam = installTeam;
 exports.uninstallTeam = uninstallTeam;
+exports.cleanEmptyParents = cleanEmptyParents;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const COPY_DIRS = ['skills', 'agents', 'rules', 'commands'];
@@ -39,10 +40,16 @@ function uninstallTeam(files) {
     const removed = [];
     for (const file of files) {
         try {
-            if (fs_1.default.existsSync(file)) {
+            if (!fs_1.default.existsSync(file))
+                continue;
+            const stat = fs_1.default.statSync(file);
+            if (stat.isDirectory()) {
+                fs_1.default.rmSync(file, { recursive: true, force: true });
+            }
+            else {
                 fs_1.default.unlinkSync(file);
-                removed.push(file);
             }
+            removed.push(file);
         }
         catch {
             // best-effort removal
@@ -50,3 +57,22 @@ function uninstallTeam(files) {
     }
     return removed;
 }
+/**
+ * 빈 상위 디렉토리를 boundary까지 정리한다.
+ * 예: /home/.claude/skills/cardnews/ 가 비었으면 삭제, /home/.claude/skills/는 유지
+ */
+function cleanEmptyParents(filePath, boundary) {
+    let dir = path_1.default.dirname(filePath);
+    while (dir.length > boundary.length && dir.startsWith(boundary)) {
+        try {
+            const entries = fs_1.default.readdirSync(dir);
+            if (entries.length > 0)
+                break;
+            fs_1.default.rmdirSync(dir);
+            dir = path_1.default.dirname(dir);
+        }
+        catch {
+            break;
+        }
+    }
+}

package/dist/lib/preamble.d.ts

@@ -5,7 +5,9 @@ export declare function generatePreamble(slug: string): string;
  */
 export declare function injectPreamble(filePath: string, slug: string): void;
 /**
- * 팀의 루트 SKILL.md와 commands/*.md에 preamble을 주입한다.
- * 서브 스킬의 SKILL.md는 건드리지 않는다 (frontmatter 검색에 영향).
+ * 팀의 사용자 진입점 파일에 preamble을 주입한다.
+ * - 루트 SKILL.md
+ * - user-invocable: true인 서브 스킬 SKILL.md
+ * - commands/*.md
  */
 export declare function injectPreambleToTeam(teamDir: string, slug: string): number;

package/dist/lib/preamble.js

@@ -54,18 +54,40 @@ function injectPreamble(filePath, slug) {
     fs_1.default.writeFileSync(filePath, cleaned);
 }
 /**
- * 팀의 루트 SKILL.md와 commands/*.md에 preamble을 주입한다.
- * 서브 스킬의 SKILL.md는 건드리지 않는다 (frontmatter 검색에 영향).
+ * 팀의 사용자 진입점 파일에 preamble을 주입한다.
+ * - 루트 SKILL.md
+ * - user-invocable: true인 서브 스킬 SKILL.md
+ * - commands/*.md
  */
 function injectPreambleToTeam(teamDir, slug) {
     let count = 0;
-    // 1. 루트 SKILL.md (skills/<slug>/SKILL.md 레벨)
+    // 1. 루트 SKILL.md
     const rootSkill = path_1.default.join(teamDir, 'SKILL.md');
     if (fs_1.default.existsSync(rootSkill)) {
         injectPreamble(rootSkill, slug);
         count++;
     }
-    // 2. commands/*.md
+    // 2. user-invocable 서브 스킬 SKILL.md만 (skills/**/SKILL.md)
+    const skillsDir = path_1.default.join(teamDir, 'skills');
+    if (fs_1.default.existsSync(skillsDir)) {
+        function walkSkills(dir) {
+            for (const entry of fs_1.default.readdirSync(dir, { withFileTypes: true })) {
+                const fullPath = path_1.default.join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    walkSkills(fullPath);
+                }
+                else if (entry.name === 'SKILL.md') {
+                    const content = fs_1.default.readFileSync(fullPath, 'utf-8');
+                    if (/user-invocable:\s*true/i.test(content)) {
+                        injectPreamble(fullPath, slug);
+                        count++;
+                    }
+                }
+            }
+        }
+        walkSkills(skillsDir);
+    }
+    // 3. commands/*.md
     const commandsDir = path_1.default.join(teamDir, 'commands');
     if (fs_1.default.existsSync(commandsDir)) {
         for (const entry of fs_1.default.readdirSync(commandsDir, { withFileTypes: true })) {

package/dist/lib/slug.d.ts

@@ -17,8 +17,3 @@ export declare function isSimpleSlug(input: string): boolean;
  * 단순 slug는 서버에 resolve를 요청한다.
  */
 export declare function resolveSlug(input: string): Promise<ParsedSlug>;
-/**
- * installed.json에서 단순 slug로 매칭되는 scoped 키를 찾는다.
- * 네트워크 없이 로컬에서만 동작.
- */
-export declare function findInstalledByName(installed: Record<string, unknown>, name: string): string | null;

package/dist/lib/slug.js

@@ -4,7 +4,6 @@ exports.parseSlug = parseSlug;
 exports.isScopedSlug = isScopedSlug;
 exports.isSimpleSlug = isSimpleSlug;
 exports.resolveSlug = resolveSlug;
-exports.findInstalledByName = findInstalledByName;
 const api_js_1 = require("./api.js");
 const SCOPED_SLUG_RE = /^@([a-z0-9](?:[a-z0-9-]*[a-z0-9])?)\/([a-z0-9](?:[a-z0-9-]*[a-z0-9])?)$/;
 const SIMPLE_SLUG_RE = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/;
@@ -52,20 +51,3 @@ async function resolveSlug(input) {
     const list = results.map((r) => `  ${r.full}`).join('\n');
     throw new Error(`'${input}'에 해당하는 팀이 여러 개입니다. 전체 slug를 지정해주세요:\n${list}`);
 }
-/**
- * installed.json에서 단순 slug로 매칭되는 scoped 키를 찾는다.
- * 네트워크 없이 로컬에서만 동작.
- */
-function findInstalledByName(installed, name) {
-    // 정확한 키가 있으면 그대로 (하위 호환)
-    if (name in installed)
-        return name;
-    // scoped 키 중 name 부분이 매칭되는 것 찾기
-    const matches = Object.keys(installed).filter((key) => {
-        const parsed = parseSlug(key);
-        return parsed && parsed.name === name;
-    });
-    if (matches.length === 1)
-        return matches[0];
-    return null;
-}

package/dist/types.d.ts

@@ -10,6 +10,10 @@ export interface InstalledTeam {
     type?: 'team' | 'system';
     /** Space 소속 팀인 경우 Space slug */
     space_slug?: string;
+    /** 배치 범위 — 에이전트가 relay deploy-record로 기록 */
+    deploy_scope?: 'global' | 'local';
+    /** 배치된 파일 절대경로 목록 — 에이전트가 relay deploy-record로 기록 */
+    deployed_files?: string[];
 }
 /** 키는 scoped slug 포맷: "@owner/name" */
 export interface InstalledRegistry {

package/package.json

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