relayax-cli 0.3.65 → 0.3.67

package/dist/commands/init.d.ts

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

package/dist/commands/init.js

@@ -36,10 +36,15 @@ function showWelcome() {
         '  에이전트 CLI에 relay 커맨드를 연결합니다.',
         '',
         '  \x1b[2mUser 커맨드 (글로벌)\x1b[0m',
-        '  /relay-install     에이전트 탐색 & 설치',
-        '  /relay-status      설치 현황 & Space',
+        '  /relay-explore     에이전트 탐색 & 추천',
+        '  /relay-create      에이전트 생성 & 배포',
+        '  /relay-status      설치 현황 & Organization',
         '  /relay-uninstall   에이전트 삭제',
         '',
+        '  \x1b[2mCLI 명령어\x1b[0m',
+        '  relay install      에이전트 설치 (CLI 한 줄 완결)',
+        '  relay publish      재배포 (--patch/--minor/--major)',
+        '',
     ];
     console.log(lines.join('\n'));
 }
@@ -65,20 +70,28 @@ async function selectToolsInteractively(detectedIds) {
  * ~/{skillsDir}/commands/relay/ 에 설치.
  * 기존 파일 중 현재 커맨드 목록에 없는 것은 제거한다.
  */
+/** 제거된 레거시 커맨드 → 대체 안내 매핑 */
+const LEGACY_COMMANDS = {
+    'relay-install': 'relay install (CLI) 또는 /relay-explore',
+    'relay-publish': 'relay publish --patch (CLI) 또는 /relay-create',
+};
 function installGlobalUserCommands() {
     const globalCLIs = (0, ai_tools_js_1.detectGlobalCLIs)();
     const currentIds = new Set(command_adapter_js_1.USER_COMMANDS.map((c) => c.id));
     const commands = [];
     const tools = [];
-    // 감지된 CLI가 없으면 설치하지 않음 (사용자가 --tools로 지정하거나 CLI를 먼저 설치해야 함)
+    const removed = [];
     const targetDirs = globalCLIs.map((t) => ({ name: t.name, dir: (0, command_adapter_js_1.getGlobalCommandDirForTool)(t.skillsDir), getPath: (id) => (0, command_adapter_js_1.getGlobalCommandPathForTool)(t.skillsDir, id) }));
     for (const target of targetDirs) {
         fs_1.default.mkdirSync(target.dir, { recursive: true });
-        // 기존 파일 중 현재 목록에 없는 것 제거
+        // 기존 파일 중 현재 목록에 없는 것 제거 + 레거시 안내
         for (const file of fs_1.default.readdirSync(target.dir)) {
             const id = file.replace(/\.md$/, '');
             if (!currentIds.has(id)) {
                 fs_1.default.unlinkSync(path_1.default.join(target.dir, file));
+                if (LEGACY_COMMANDS[id] && !removed.includes(id)) {
+                    removed.push(id);
+                }
             }
         }
         // 현재 커맨드 설치 (덮어쓰기)
@@ -87,11 +100,10 @@ function installGlobalUserCommands() {
         }
         tools.push(target.name);
     }
-    // commands 목록은 한 번만
     for (const cmd of command_adapter_js_1.USER_COMMANDS) {
         commands.push(cmd.id);
     }
-    return { installed: true, commands, tools };
+    return { installed: true, commands, tools, removed };
 }
 /**
  * 글로벌 User 커맨드가 이미 설치되어 있는지 확인한다.
@@ -149,10 +161,12 @@ function registerInit(program) {
         // ── 1. 글로벌 User 커맨드 설치 ──
         let globalStatus = 'already';
         let globalTools = [];
+        let removedCommands = [];
         {
             const result = installGlobalUserCommands();
             globalStatus = hasGlobalUserCommands() ? 'updated' : 'installed';
             globalTools = result.tools;
+            removedCommands = result.removed;
             // Register relay-core in installed.json
             const installed = (0, config_js_1.loadInstalled)();
             installed['relay-core'] = {
@@ -245,6 +259,14 @@ function registerInit(program) {
         }
         else {
             console.log(`\n\x1b[32m✓ relay 초기화 완료\x1b[0m\n`);
+            // 레거시 커맨드 마이그레이션 안내
+            if (removedCommands.length > 0) {
+                console.log(`  \x1b[33m⚠ 변경된 커맨드:\x1b[0m`);
+                for (const id of removedCommands) {
+                    console.log(`    \x1b[31m✗ /${id}\x1b[0m → ${LEGACY_COMMANDS[id]}`);
+                }
+                console.log();
+            }
             // 글로벌
             {
                 const toolNames = globalTools.length > 0 ? globalTools.join(', ') : '(감지된 CLI 없음)';

package/dist/commands/install.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerInstall = registerInstall;
 const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
 const api_js_1 = require("../lib/api.js");
 const storage_js_1 = require("../lib/storage.js");
@@ -15,11 +16,15 @@ const init_js_1 = require("./init.js");
 const paths_js_1 = require("../lib/paths.js");
 const error_report_js_1 = require("../lib/error-report.js");
 const step_tracker_js_1 = require("../lib/step-tracker.js");
+const installer_js_1 = require("../lib/installer.js");
 function registerInstall(program) {
     program
         .command('install <slug>')
         .description('에이전트 패키지를 .relay/agents/에 다운로드합니다')
         .option('--join-code <code>', '초대 코드 (Organization 에이전트 설치 시 자동 가입)')
+        .option('--code <code>', '접근 코드 (private 에이전트 설치 시)')
+        .option('--global', '글로벌 설치 (홈 디렉토리)')
+        .option('--local', '로컬 설치 (프로젝트 디렉토리)')
         .option('--project <dir>', '프로젝트 루트 경로 (기본: cwd, 환경변수: RELAY_PROJECT_PATH)')
         .action(async (slugInput, _opts) => {
         const json = program.opts().json ?? false;
@@ -45,6 +50,39 @@ function registerInstall(program) {
             const actualSlugInput = versionMatch ? versionMatch[1] : slugInput;
             parsed = await (0, slug_js_1.resolveSlug)(actualSlugInput);
             slug = parsed.full;
+            // Helper: ensure a valid token exists, triggering auto-login in TTY if needed.
+            // Returns the token string or null if login failed / not available.
+            async function ensureToken() {
+                let token = await (0, config_js_1.getValidToken)();
+                if (!token) {
+                    const isTTY = Boolean(process.stdin.isTTY);
+                    if (isTTY && !json) {
+                        console.error('\x1b[33m⚙ 이 에이전트는 로그인이 필요합니다. 로그인을 시작합니다...\x1b[0m');
+                        const { runLogin } = await import('./login.js');
+                        await runLogin();
+                        token = await (0, config_js_1.getValidToken)();
+                    }
+                }
+                return token ?? null;
+            }
+            // Pre-fetch auto-login: --join-code and --code always require auth.
+            if (_opts.joinCode || _opts.code) {
+                const token = await ensureToken();
+                if (!token) {
+                    if (json) {
+                        console.error(JSON.stringify({
+                            error: 'LOGIN_REQUIRED',
+                            slug,
+                            message: '이 에이전트는 로그인이 필요합니다. relay login을 먼저 실행하세요.',
+                            fix: 'relay login 실행 후 재시도하세요.',
+                        }));
+                    }
+                    else {
+                        console.error('\x1b[31m이 에이전트는 로그인이 필요합니다. relay login 을 먼저 실행하세요.\x1b[0m');
+                    }
+                    process.exit(1);
+                }
+            }
             try {
                 agent = await (0, api_js_1.fetchAgentInfo)(slug);
             }
@@ -64,15 +102,63 @@ function registerInstall(program) {
                         }
                     }
                     catch { /* ignore parse errors */ }
-                    // Private agent: show purchase info + relay access hint
-                    if (errorVisibility === 'private' || purchaseInfo) {
+                    // Task 2.1: --join-code provided and not yet a member → join org then retry
+                    if (_opts.joinCode && membershipStatus !== 'member') {
+                        if (!json) {
+                            console.error('\x1b[33m⚙ 초대 코드로 Organization에 가입합니다...\x1b[0m');
+                        }
+                        const { joinOrg } = await import('./join.js');
+                        await joinOrg(parsed.owner, _opts.joinCode);
+                        agent = await (0, api_js_1.fetchAgentInfo)(slug);
+                    }
+                    // Task 2.2: --code provided and agent is private → claim access then retry
+                    else if (_opts.code && (errorVisibility === 'private' || purchaseInfo)) {
+                        if (!json) {
+                            console.error('\x1b[33m⚙ 접근 코드로 에이전트 접근 권한을 요청합니다...\x1b[0m');
+                        }
+                        const token = await (0, config_js_1.getValidToken)();
+                        if (!token) {
+                            if (json) {
+                                console.error(JSON.stringify({
+                                    error: 'LOGIN_REQUIRED',
+                                    slug,
+                                    message: '이 에이전트는 로그인이 필요합니다. relay login을 먼저 실행하세요.',
+                                    fix: 'relay login 실행 후 재시도하세요.',
+                                }));
+                            }
+                            else {
+                                console.error('\x1b[31m이 에이전트는 로그인이 필요합니다. relay login 을 먼저 실행하세요.\x1b[0m');
+                            }
+                            process.exit(1);
+                        }
+                        const claimRes = await fetch(`${config_js_1.API_URL}/api/agents/${slug}/claim-access`, {
+                            method: 'POST',
+                            headers: {
+                                'Content-Type': 'application/json',
+                                Authorization: `Bearer ${token}`,
+                            },
+                            body: JSON.stringify({ code: _opts.code }),
+                            signal: AbortSignal.timeout(10000),
+                        });
+                        if (!claimRes.ok) {
+                            const claimBody = (await claimRes.json().catch(() => ({})));
+                            const claimErrCode = claimBody.error ?? String(claimRes.status);
+                            if (claimErrCode === 'INVALID_LINK')
+                                throw new Error('초대 링크가 유효하지 않거나 만료되었습니다.');
+                            throw new Error(claimBody.message ?? `접근 권한 요청 실패 (${claimRes.status})`);
+                        }
+                        agent = await (0, api_js_1.fetchAgentInfo)(slug);
+                    }
+                    // No code provided: show appropriate error messages
+                    else if (errorVisibility === 'private' || purchaseInfo) {
+                        // Private agent: show purchase info + relay access hint
                         if (json) {
                             console.error(JSON.stringify({
                                 error: 'ACCESS_REQUIRED',
                                 message: '이 에이전트는 접근 권한이 필요합니다.',
                                 slug,
                                 purchase_info: purchaseInfo ?? null,
-                                fix: '접근 링크 코드가 있으면: relay access <slug> --code <코드>',
+                                fix: '접근 링크 코드가 있으면: relay install ' + slugInput + ' --code <코드>',
                             }));
                         }
                         else {
@@ -83,18 +169,18 @@ function registerInstall(program) {
                             if (purchaseInfo?.url) {
                                 console.error(`  \x1b[36m${purchaseInfo.url}\x1b[0m`);
                             }
-                            console.error(`\n\x1b[33m접근 링크 코드가 있으면: relay access ${slugInput} --code <코드>\x1b[0m`);
+                            console.error(`\n\x1b[33m접근 링크 코드가 있으면: relay install ${slugInput} --code <코드>\x1b[0m`);
                         }
                         process.exit(1);
                     }
-                    if (membershipStatus === 'member') {
+                    else if (membershipStatus === 'member') {
                         // Member but no access to this specific agent
                         if (json) {
                             console.error(JSON.stringify({
                                 error: 'NO_ACCESS',
                                 message: '이 에이전트에 대한 접근 권한이 없습니다.',
                                 slug,
-                                fix: '이 에이전트의 접근 링크 코드가 있으면 `relay access ' + slugInput + ' --code <코드>`로 접근 권한을 얻으세요. 없으면 에이전트 제작자에게 문의하세요.',
+                                fix: '이 에이전트의 접근 링크 코드가 있으면 `relay install ' + slugInput + ' --code <코드>`로 접근 권한을 얻으세요. 없으면 에이전트 제작자에게 문의하세요.',
                             }));
                         }
                         else {
@@ -108,12 +194,12 @@ function registerInstall(program) {
                                 error: 'ACCESS_REQUIRED',
                                 message: '이 에이전트는 접근 권한이 필요합니다.',
                                 slug,
-                                fix: '초대 코드가 있으면 `relay join <org-slug> --code <코드>`로 가입하세요.',
+                                fix: '초대 코드가 있으면 `relay install ' + slugInput + ' --join-code <코드>`로 가입하세요.',
                             }));
                         }
                         else {
                             console.error('\x1b[31m이 에이전트는 접근 권한이 필요합니다.\x1b[0m');
-                            console.error('\x1b[33m초대 코드가 있으면 `relay join <org-slug> --code <코드>`로 가입하세요.\x1b[0m');
+                            console.error('\x1b[33m초대 코드가 있으면 `relay install ' + slugInput + ' --join-code <코드>`로 가입하세요.\x1b[0m');
                         }
                         process.exit(1);
                     }
@@ -126,35 +212,32 @@ function registerInstall(program) {
                 throw new Error('에이전트 정보를 가져오지 못했습니다.');
             // Re-bind as non-optional so TypeScript tracks the narrowing through nested scopes
             let resolvedAgent = agent;
-            const agentDir = path_1.default.join(projectPath, '.relay', 'agents', parsed.owner, parsed.name);
-            // 2. Visibility check + auto-login
+            // Scope 자동결정: --global/--local 플래그 > agent_type 기반
+            const scope = _opts.global ? 'global'
+                : _opts.local ? 'local'
+                    : resolvedAgent.type === 'passive' ? 'local'
+                        : 'global';
+            const agentDir = scope === 'global'
+                ? path_1.default.join(os_1.default.homedir(), '.relay', 'agents', parsed.owner, parsed.name)
+                : path_1.default.join(projectPath, '.relay', 'agents', parsed.owner, parsed.name);
+            // 2. Visibility check + auto-login (internal agents always require a token)
             const visibility = resolvedAgent.visibility ?? 'public';
             if (visibility === 'internal') {
-                let token = await (0, config_js_1.getValidToken)();
+                const token = await ensureToken();
                 if (!token) {
-                    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)();
+                    if (json) {
+                        console.error(JSON.stringify({
+                            error: 'LOGIN_REQUIRED',
+                            visibility,
+                            slug,
+                            message: '이 에이전트는 로그인이 필요합니다. relay login을 먼저 실행하세요.',
+                            fix: 'relay login 실행 후 재시도하세요.',
+                        }));
                     }
-                    if (!token) {
-                        if (json) {
-                            console.error(JSON.stringify({
-                                error: 'LOGIN_REQUIRED',
-                                visibility,
-                                slug,
-                                message: '이 에이전트는 로그인이 필요합니다. relay login을 먼저 실행하세요.',
-                                fix: 'relay login 실행 후 재시도하세요.',
-                            }));
-                        }
-                        else {
-                            console.error('\x1b[31m이 에이전트는 로그인이 필요합니다. relay login 을 먼저 실행하세요.\x1b[0m');
-                        }
-                        process.exit(1);
+                    else {
+                        console.error('\x1b[31m이 에이전트는 로그인이 필요합니다. relay login 을 먼저 실행하세요.\x1b[0m');
                     }
+                    process.exit(1);
                 }
             }
             // 3. Download package (retry once if signed URL expired)
@@ -184,7 +267,13 @@ function registerInstall(program) {
             await (0, storage_js_1.extractPackage)(tarPath, agentDir);
             // 4.5. Inject preamble (update check) into SKILL.md and commands
             (0, preamble_js_1.injectPreambleToAgent)(agentDir, slug);
-            // 5. Count extracted files
+            // 5. Deploy symlinks to detected AI tool directories
+            const deploy = (0, installer_js_1.deploySymlinks)(agentDir, scope, projectPath);
+            for (const w of deploy.warnings) {
+                if (!json)
+                    console.error(`\x1b[33m${w}\x1b[0m`);
+            }
+            // 6. Count extracted files
             function countFiles(dir) {
                 let count = 0;
                 if (!fs_1.default.existsSync(dir))
@@ -200,16 +289,26 @@ function registerInstall(program) {
                 return count;
             }
             const fileCount = countFiles(agentDir);
-            // 6. Record in installed.json
-            const installed = (0, config_js_1.loadInstalled)();
-            installed[slug] = {
+            // 7. Record in installed.json (scope-aware)
+            const installRecord = {
                 agent_id: resolvedAgent.id,
                 version: resolvedAgent.version,
                 installed_at: new Date().toISOString(),
                 files: [agentDir],
+                deploy_scope: scope,
+                deployed_symlinks: deploy.symlinks,
             };
-            (0, config_js_1.saveInstalled)(installed);
-            // 7. Report install + usage ping (non-blocking, agent_id 기반)
+            if (scope === 'global') {
+                const globalInstalled = (0, config_js_1.loadGlobalInstalled)();
+                globalInstalled[slug] = installRecord;
+                (0, config_js_1.saveGlobalInstalled)(globalInstalled);
+            }
+            else {
+                const installed = (0, config_js_1.loadInstalled)();
+                installed[slug] = installRecord;
+                (0, config_js_1.saveInstalled)(installed);
+            }
+            // 8. Report install + usage ping (non-blocking, agent_id 기반)
             await (0, api_js_1.reportInstall)(resolvedAgent.id, slug, resolvedAgent.version);
             (0, api_js_1.sendUsagePing)(resolvedAgent.id, slug, resolvedAgent.version);
             const result = {
@@ -220,6 +319,8 @@ function registerInstall(program) {
                 commands: resolvedAgent.commands,
                 files: fileCount,
                 install_path: agentDir,
+                scope,
+                symlinks: deploy.symlinks,
                 author: resolvedAgent.author ? {
                     username: resolvedAgent.author.username,
                     display_name: resolvedAgent.author.display_name ?? null,
@@ -233,9 +334,11 @@ function registerInstall(program) {
             else {
                 const authorUsername = resolvedAgent.author?.username;
                 const authorSuffix = authorUsername ? `  \x1b[90mby @${authorUsername}\x1b[0m` : '';
-                console.log(`\n\x1b[32m✓ ${resolvedAgent.name} 다운로드 완료\x1b[0m  v${resolvedAgent.version}${authorSuffix}`);
+                const scopeLabel = scope === 'global' ? '글로벌' : '로컬';
+                console.log(`\n\x1b[32m✓ ${resolvedAgent.name} 설치 완료\x1b[0m  v${resolvedAgent.version}${authorSuffix}`);
                 console.log(`  위치: \x1b[36m${agentDir}\x1b[0m`);
-                console.log(`  파일: ${fileCount}개`);
+                console.log(`  범위: ${scopeLabel}`);
+                console.log(`  파일: ${fileCount}개, symlink: ${deploy.symlinks.length}개`);
                 if (resolvedAgent.commands.length > 0) {
                     console.log('\n  포함된 커맨드:');
                     for (const cmd of resolvedAgent.commands) {
@@ -256,7 +359,9 @@ function registerInstall(program) {
                 else {
                     console.log(`\n\x1b[33m💡 설치 완료! AI 에이전트에서 사용할 수 있습니다.\x1b[0m`);
                 }
-                console.log('\n  \x1b[90m에이전트가 /relay-install로 환경을 구성합니다.\x1b[0m');
+                // Requires check
+                const requiresResults = (0, installer_js_1.checkRequires)(agentDir);
+                (0, installer_js_1.printRequiresCheck)(requiresResults);
             }
         }
         catch (err) {