relayax-cli 0.1.994 → 0.1.996

package/dist/commands/check-update.js

@@ -2,6 +2,8 @@
 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]')
@@ -24,7 +26,28 @@ function registerCheckUpdate(program) {
         }
         // Team version check
         if (slug) {
-            const teamResult = await (0, version_check_js_1.checkTeamVersion)(slug, force);
+            // Resolve to scoped slug
+            let scopedSlug;
+            if ((0, slug_js_1.isScopedSlug)(slug)) {
+                scopedSlug = slug;
+            }
+            else {
+                const installed = (0, config_js_1.loadInstalled)();
+                const found = (0, slug_js_1.findInstalledByName)(installed, slug);
+                if (found) {
+                    scopedSlug = found;
+                }
+                else {
+                    try {
+                        const parsed = await (0, slug_js_1.resolveSlug)(slug);
+                        scopedSlug = parsed.full;
+                    }
+                    catch {
+                        scopedSlug = slug; // fallback to original
+                    }
+                }
+            }
+            const teamResult = await (0, version_check_js_1.checkTeamVersion)(scopedSlug, force);
             if (teamResult) {
                 if (quiet) {
                     const byAuthor = teamResult.author ? ` ${teamResult.author}` : '';

package/dist/commands/init.js

@@ -8,6 +8,7 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const ai_tools_js_1 = require("../lib/ai-tools.js");
 const command_adapter_js_1 = require("../lib/command-adapter.js");
+const config_js_1 = require("../lib/config.js");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const pkg = require('../../package.json');
 const VALID_TEAM_DIRS = ['skills', 'agents', 'rules', 'commands'];
@@ -123,8 +124,17 @@ function registerInit(program) {
         // ── 1. 글로벌 User 커맨드 설치 ──
         let globalStatus = 'already';
         if (opts.update || !hasGlobalUserCommands()) {
-            installGlobalUserCommands();
+            const { commands } = installGlobalUserCommands();
             globalStatus = opts.update ? 'updated' : 'installed';
+            // Register relay-core in installed.json
+            const installed = (0, config_js_1.loadInstalled)();
+            installed['relay-core'] = {
+                version: pkg.version,
+                installed_at: new Date().toISOString(),
+                files: commands.map((c) => (0, command_adapter_js_1.getGlobalCommandPath)(c)),
+                type: 'system',
+            };
+            (0, config_js_1.saveInstalled)(installed);
         }
         // ── 2. 로컬 Builder 커맨드 (팀 프로젝트인 경우) ──
         const localResults = [];

package/dist/commands/install.js

@@ -9,22 +9,26 @@ const path_1 = __importDefault(require("path"));
 const api_js_1 = require("../lib/api.js");
 const storage_js_1 = require("../lib/storage.js");
 const config_js_1 = require("../lib/config.js");
+const slug_js_1 = require("../lib/slug.js");
 function registerInstall(program) {
     program
         .command('install <slug>')
         .description('에이전트 팀 패키지를 .relay/teams/에 다운로드합니다')
-        .action(async (slug) => {
+        .action(async (slugInput) => {
         const json = program.opts().json ?? false;
         const projectPath = process.cwd();
-        const teamDir = path_1.default.join(projectPath, '.relay', 'teams', slug);
         const tempDir = (0, storage_js_1.makeTempDir)();
         try {
+            // 0. Resolve scoped slug
+            const parsed = await (0, slug_js_1.resolveSlug)(slugInput);
+            const slug = parsed.full;
             // 1. Fetch team metadata
             const team = await (0, api_js_1.fetchTeamInfo)(slug);
+            const teamDir = path_1.default.join(projectPath, '.relay', 'teams', parsed.owner, parsed.name);
             // 2. Visibility check
             const visibility = team.visibility ?? 'public';
             if (visibility === 'login-only' || visibility === 'invite-only') {
-                const token = (0, config_js_1.loadToken)();
+                const token = await (0, config_js_1.getValidToken)();
                 if (!token) {
                     console.error(JSON.stringify({
                         error: 'LOGIN_REQUIRED',
@@ -119,7 +123,7 @@ function registerInstall(program) {
                     console.log(`  \x1b[90m└${'─'.repeat(44)}┘\x1b[0m`);
                 }
                 // Follow prompt (only when logged in)
-                const token = (0, config_js_1.loadToken)();
+                const token = await (0, config_js_1.getValidToken)();
                 if (authorUsername && token) {
                     try {
                         const { confirm } = await import('@inquirer/prompts');

package/dist/commands/login.js

@@ -43,6 +43,9 @@ function waitForToken(port) {
             const url = new URL(req.url ?? '/', `http://localhost:${port}`);
             if (url.pathname === '/callback') {
                 const token = url.searchParams.get('token');
+                const refresh_token = url.searchParams.get('refresh_token') ?? undefined;
+                const expires_at_raw = url.searchParams.get('expires_at');
+                const expires_at = expires_at_raw ? Number(expires_at_raw) : undefined;
                 res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
                 res.end(`<!DOCTYPE html>
 <html><head><title>RelayAX</title></head>
@@ -55,7 +58,7 @@ function waitForToken(port) {
 </body></html>`);
                 server.close();
                 if (token) {
-                    resolve(token);
+                    resolve({ token, refresh_token, expires_at });
                 }
                 else {
                     reject(new Error('토큰이 전달되지 않았습니다'));
@@ -97,14 +100,19 @@ function registerLogin(program) {
         .action(async (opts) => {
         const json = program.opts().json ?? false;
         (0, config_js_1.ensureGlobalRelayDir)();
-        let token = opts.token;
-        if (!token) {
+        let accessToken = opts.token;
+        let refreshToken;
+        let expiresAt;
+        if (!accessToken) {
             try {
                 const port = await findAvailablePort();
                 const loginUrl = `${config_js_1.API_URL}/auth/cli-login?port=${port}`;
                 console.error('브라우저에서 로그인을 진행합니다...');
                 openBrowser(loginUrl);
-                token = await waitForToken(port);
+                const loginResult = await waitForToken(port);
+                accessToken = loginResult.token;
+                refreshToken = loginResult.refresh_token;
+                expiresAt = loginResult.expires_at;
             }
             catch (err) {
                 const msg = err instanceof Error ? err.message : '로그인 실패';
@@ -112,8 +120,12 @@ function registerLogin(program) {
                 process.exit(1);
             }
         }
-        const user = await verifyToken(token);
-        (0, config_js_1.saveToken)(token);
+        const user = await verifyToken(accessToken);
+        (0, config_js_1.saveTokenData)({
+            access_token: accessToken,
+            ...(refreshToken ? { refresh_token: refreshToken } : {}),
+            ...(expiresAt ? { expires_at: expiresAt } : {}),
+        });
         const result = {
             status: 'ok',
             message: '로그인 성공',

package/dist/commands/publish.js

@@ -379,7 +379,7 @@ function registerPublish(program) {
             process.exit(1);
         }
         // Get token (checked before tarball creation)
-        const token = opts.token ?? process.env.RELAY_TOKEN ?? (0, config_js_1.loadToken)();
+        const token = opts.token ?? process.env.RELAY_TOKEN ?? await (0, config_js_1.getValidToken)();
         if (!token) {
             console.error(JSON.stringify({
                 error: 'NO_TOKEN',

package/dist/commands/status.js

@@ -31,7 +31,7 @@ function registerStatus(program) {
         const json = program.opts().json ?? false;
         const projectPath = process.cwd();
         // 1. 로그인 상태
-        const token = (0, config_js_1.loadToken)();
+        const token = await (0, config_js_1.getValidToken)();
         let username;
         if (token) {
             username = await resolveUsername(token);

package/dist/commands/uninstall.js

@@ -3,15 +3,25 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerUninstall = registerUninstall;
 const config_js_1 = require("../lib/config.js");
 const installer_js_1 = require("../lib/installer.js");
+const slug_js_1 = require("../lib/slug.js");
 function registerUninstall(program) {
     program
         .command('uninstall <slug>')
         .description('에이전트 팀 제거')
-        .action((slug) => {
+        .action((slugInput) => {
         const json = program.opts().json ?? false;
         const installed = (0, config_js_1.loadInstalled)();
+        // Resolve slug from installed.json
+        let slug;
+        if ((0, slug_js_1.isScopedSlug)(slugInput)) {
+            slug = slugInput;
+        }
+        else {
+            const found = (0, slug_js_1.findInstalledByName)(installed, slugInput);
+            slug = found ?? slugInput;
+        }
         if (!installed[slug]) {
-            const msg = { error: 'NOT_INSTALLED', message: `'${slug}'는 설치되어 있지 않습니다.` };
+            const msg = { error: 'NOT_INSTALLED', message: `'${slugInput}'는 설치되어 있지 않습니다.` };
             if (json) {
                 console.error(JSON.stringify(msg));
             }

package/dist/commands/update.js

@@ -5,19 +5,35 @@ const api_js_1 = require("../lib/api.js");
 const storage_js_1 = require("../lib/storage.js");
 const installer_js_1 = require("../lib/installer.js");
 const config_js_1 = require("../lib/config.js");
+const slug_js_1 = require("../lib/slug.js");
 function registerUpdate(program) {
     program
         .command('update <slug>')
         .description('설치된 에이전트 팀을 최신 버전으로 업데이트합니다')
         .option('--path <install_path>', '설치 경로 지정 (기본: ./.claude)')
         .option('--code <code>', '초대 코드 (invite-only 팀 업데이트 시 필요)')
-        .action(async (slug, opts) => {
+        .action(async (slugInput, opts) => {
         const json = program.opts().json ?? false;
         const installPath = (0, config_js_1.getInstallPath)(opts.path);
         const tempDir = (0, storage_js_1.makeTempDir)();
         try {
-            // Check installed.json for current version
+            // Resolve scoped slug (try installed.json first for offline, then server)
             const installed = (0, config_js_1.loadInstalled)();
+            let slug;
+            if ((0, slug_js_1.isScopedSlug)(slugInput)) {
+                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;
+                }
+            }
+            // Check installed.json for current version
             const currentEntry = installed[slug];
             const currentVersion = currentEntry?.version ?? null;
             // Fetch latest team metadata
@@ -35,7 +51,7 @@ function registerUpdate(program) {
             // Visibility check
             const visibility = team.visibility ?? 'public';
             if (visibility === 'login-only') {
-                const token = (0, config_js_1.loadToken)();
+                const token = await (0, config_js_1.getValidToken)();
                 if (!token) {
                     console.error('이 팀은 로그인이 필요합니다. `relay login`을 먼저 실행하세요.');
                     process.exit(1);

package/dist/lib/api.d.ts

@@ -8,4 +8,10 @@ export interface TeamVersionInfo {
 }
 export declare function fetchTeamVersions(slug: string): Promise<TeamVersionInfo[]>;
 export declare function reportInstall(slug: string): Promise<void>;
+export interface ResolvedSlug {
+    owner: string;
+    name: string;
+    full: string;
+}
+export declare function resolveSlugFromServer(name: string): Promise<ResolvedSlug[]>;
 export declare function followBuilder(username: string): Promise<void>;

package/dist/lib/api.js

@@ -4,6 +4,7 @@ exports.fetchTeamInfo = fetchTeamInfo;
 exports.searchTeams = searchTeams;
 exports.fetchTeamVersions = fetchTeamVersions;
 exports.reportInstall = reportInstall;
+exports.resolveSlugFromServer = resolveSlugFromServer;
 exports.followBuilder = followBuilder;
 const config_js_1 = require("./config.js");
 async function fetchTeamInfo(slug) {
@@ -43,8 +44,17 @@ async function reportInstall(slug) {
         // non-critical: ignore errors
     });
 }
+async function resolveSlugFromServer(name) {
+    const url = `${config_js_1.API_URL}/api/registry/resolve?name=${encodeURIComponent(name)}`;
+    const res = await fetch(url, { signal: AbortSignal.timeout(5000) });
+    if (!res.ok) {
+        throw new Error(`slug resolve 실패 (${res.status})`);
+    }
+    const data = (await res.json());
+    return data.results;
+}
 async function followBuilder(username) {
-    const token = (0, config_js_1.loadToken)();
+    const token = await (0, config_js_1.getValidToken)();
     const headers = {
         'Content-Type': 'application/json',
     };

package/dist/lib/command-adapter.js

@@ -66,7 +66,7 @@ exports.USER_COMMANDS = [
    - 팀 이름과 설명
    - 제공하는 커맨드 목록
    - 왜 이 팀이 지금 프로젝트에 맞는지 설명
-4. 관심 있는 팀이 있다면 \`/relay-install <slug>\`로 바로 설치할 수 있다고 안내합니다.
+4. 관심 있는 팀이 있다면 \`/relay-install <@author/slug>\`로 바로 설치할 수 있다고 안내합니다.
 
 ## 예시
 
@@ -74,7 +74,7 @@ exports.USER_COMMANDS = [
 → relay search 콘텐츠 실행
 → 결과 해석: "contents-team이 카드뉴스, PDF, PPT를 만들 수 있어요"
 → 프로젝트 맥락 기반 추천
-→ "/relay-install contents-team으로 설치할 수 있어요"`,
+→ "/relay-install @example/contents-team으로 설치할 수 있어요"`,
     },
     {
         id: 'relay-install',
@@ -90,7 +90,7 @@ exports.USER_COMMANDS = [
 - 업데이트 여부와 관계없이 설치를 계속 진행합니다.
 
 ### 1. 팀 패키지 다운로드
-- \`relay install <slug>\` 명령어를 실행합니다.
+- \`relay install <@author/slug>\` 명령어를 실행합니다.
 - 패키지가 \`.relay/teams/<slug>/\`에 다운로드됩니다.
 
 ### 2. 패키지 내용 확인
@@ -115,7 +115,7 @@ exports.USER_COMMANDS = [
 - **env**: 환경변수 확인 → required이면 설정 안내, optional이면 알림
 - **mcp**: MCP 서버 설정 — 에이전트의 MCP 설정에 추가 안내
 - **runtime**: Node.js/Python 버전 확인
-- **teams**: 의존하는 다른 팀 → \`relay install <team>\`으로 재귀 설치
+- **teams**: 의존하는 다른 팀 → \`relay install <@author/team>\`으로 재귀 설치
 ${LOGIN_JIT_GUIDE}
 
 ### 5. 완료 안내
@@ -124,9 +124,9 @@ ${LOGIN_JIT_GUIDE}
 
 ## 예시
 
-사용자: /relay-install contents-team
-→ relay install contents-team 실행 (패키지 다운로드)
-→ .relay/teams/contents-team/ 내용 확인
+사용자: /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 복사
 → requires 확인: ✓ playwright 설치됨, ✓ sharp 설치됨
@@ -151,7 +151,7 @@ ${LOGIN_JIT_GUIDE}
 사용자: /relay-list
 → relay list --json 실행
 → "2개 팀이 설치되어 있어요:"
-→ "  contents-team v1.2.0 (2일 전 설치) - /cardnews, /pdf-report"
+→ "  @example/contents-team v1.2.0 (2일 전 설치) - /cardnews, /pdf-report"
 → "  qa-team v0.5.1 (1주 전 설치) - /qa, /qa-only"`,
     },
     {
@@ -167,14 +167,14 @@ ${LOGIN_JIT_GUIDE}
 - 업데이트 여부와 관계없이 팀 업데이트를 계속 진행합니다.
 
 ### 특정 팀 업데이트
-- 사용자가 팀 이름을 지정한 경우: \`relay update <slug> --json\` 실행
+- 사용자가 팀 이름을 지정한 경우: \`relay update <@author/slug> --json\` 실행
 - 업데이트 결과를 보여줍니다 (이전 버전 → 새 버전)
 
 ### 전체 업데이트 확인
 - 팀 이름을 지정하지 않은 경우:
   1. \`relay outdated --json\`으로 업데이트 가능한 팀 목록을 확인합니다.
   2. 업데이트 가능한 팀이 있으면 목록을 보여주고 어떤 팀을 업데이트할지 물어봅니다.
-  3. 선택된 팀에 대해 \`relay update <slug> --json\`을 실행합니다.
+  3. 선택된 팀에 대해 \`relay update <@author/slug> --json\`을 실행합니다.
   4. 모두 최신이면 "모든 팀이 최신 버전입니다"라고 안내합니다.
 
 ## 예시
@@ -182,10 +182,10 @@ ${LOGIN_JIT_GUIDE}
 사용자: /relay-update
 → relay outdated --json 실행
 → "1개 팀 업데이트 가능:"
-→ "  contents-team: v1.2.0 → v1.3.0"
+→ "  @example/contents-team: v1.2.0 → v1.3.0"
 → "업데이트할까요?"
-→ relay update contents-team --json 실행
-→ "✓ contents-team v1.3.0으로 업데이트 완료"`,
+→ relay update @example/contents-team --json 실행
+→ "✓ @example/contents-team v1.3.0으로 업데이트 완료"`,
     },
     {
         id: 'relay-uninstall',
@@ -194,15 +194,15 @@ ${LOGIN_JIT_GUIDE}
 
 ## 실행 방법
 
-1. \`relay uninstall <slug> --json\` 명령어를 실행합니다.
+1. \`relay uninstall <@author/slug> --json\` 명령어를 실행합니다.
 2. 삭제 결과를 보여줍니다 (팀 이름, 제거된 파일 수).
 3. 삭제 완료 후 남아있는 팀 목록을 간단히 안내합니다.
 
 ## 예시
 
-사용자: /relay-uninstall contents-team
-→ relay uninstall contents-team --json 실행
-→ "✓ contents-team 삭제 완료 (12개 파일 제거)"`,
+사용자: /relay-uninstall @example/contents-team
+→ relay uninstall @example/contents-team --json 실행
+→ "✓ @example/contents-team 삭제 완료 (12개 파일 제거)"`,
     },
 ];
 // ─── Builder Commands (로컬 설치) ───
@@ -293,7 +293,7 @@ requires:
     - filesystem
     - network
   teams:
-    - contents-team
+    - @example/contents-team
 \`\`\`
 
 ### 4. 포트폴리오 생성 (슬롯 기반)

package/dist/lib/config.d.ts

@@ -11,9 +11,29 @@ export declare function getInstallPath(override?: string): string;
 export declare function ensureGlobalRelayDir(): void;
 /** cwd/.relay/ — 프로젝트 로컬 (installed.json, teams/) */
 export declare function ensureProjectRelayDir(): void;
+export interface TokenData {
+    access_token: string;
+    refresh_token?: string;
+    expires_at?: number;
+}
+export declare function loadTokenData(): TokenData | undefined;
 export declare function loadToken(): string | undefined;
+export declare function saveTokenData(data: TokenData): void;
 export declare function saveToken(token: string): void;
-/** 프로젝트 로컬 installed.json 읽기 */
+/**
+ * 유효한 access_token을 반환한다.
+ * 1. 저장된 토큰이 없으면 undefined
+ * 2. expires_at이 아직 유효하면 access_token 반환
+ * 3. 만료되었으면 refresh_token으로 갱신 시도
+ * 4. 갱신 실패 시 undefined (재로그인 필요)
+ */
+export declare function getValidToken(): Promise<string | undefined>;
+/** 프로젝트 로컬 installed.json 읽기 (unscoped 키 자동 마이그레이션) */
 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;

package/dist/lib/config.js

@@ -7,14 +7,19 @@ exports.API_URL = void 0;
 exports.getInstallPath = getInstallPath;
 exports.ensureGlobalRelayDir = ensureGlobalRelayDir;
 exports.ensureProjectRelayDir = ensureProjectRelayDir;
+exports.loadTokenData = loadTokenData;
 exports.loadToken = loadToken;
+exports.saveTokenData = saveTokenData;
 exports.saveToken = saveToken;
+exports.getValidToken = getValidToken;
 exports.loadInstalled = loadInstalled;
+exports.migrateInstalled = migrateInstalled;
 exports.saveInstalled = saveInstalled;
 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');
 /**
@@ -50,22 +55,71 @@ function ensureProjectRelayDir() {
         fs_1.default.mkdirSync(dir, { recursive: true });
     }
 }
-function loadToken() {
+function loadTokenData() {
     const tokenFile = path_1.default.join(GLOBAL_RELAY_DIR, 'token');
     if (!fs_1.default.existsSync(tokenFile))
         return undefined;
     try {
-        return fs_1.default.readFileSync(tokenFile, 'utf-8').trim() || undefined;
+        const raw = fs_1.default.readFileSync(tokenFile, 'utf-8').trim();
+        if (!raw)
+            return undefined;
+        // JSON 형식 (새 포맷)
+        if (raw.startsWith('{')) {
+            return JSON.parse(raw);
+        }
+        // plain text (기존 포맷) — 호환성 유지
+        return { access_token: raw };
     }
     catch {
         return undefined;
     }
 }
+function loadToken() {
+    return loadTokenData()?.access_token;
+}
+function saveTokenData(data) {
+    ensureGlobalRelayDir();
+    fs_1.default.writeFileSync(path_1.default.join(GLOBAL_RELAY_DIR, 'token'), JSON.stringify(data));
+}
 function saveToken(token) {
     ensureGlobalRelayDir();
-    fs_1.default.writeFileSync(path_1.default.join(GLOBAL_RELAY_DIR, 'token'), token);
+    fs_1.default.writeFileSync(path_1.default.join(GLOBAL_RELAY_DIR, 'token'), JSON.stringify({ access_token: token }));
+}
+/**
+ * 유효한 access_token을 반환한다.
+ * 1. 저장된 토큰이 없으면 undefined
+ * 2. expires_at이 아직 유효하면 access_token 반환
+ * 3. 만료되었으면 refresh_token으로 갱신 시도
+ * 4. 갱신 실패 시 undefined (재로그인 필요)
+ */
+async function getValidToken() {
+    const data = loadTokenData();
+    if (!data)
+        return undefined;
+    // expires_at이 없거나 아직 유효하면 (30초 여유) 그대로 사용
+    if (!data.expires_at || data.expires_at > Date.now() / 1000 + 30) {
+        return data.access_token;
+    }
+    // 만료됨 — refresh 시도
+    if (!data.refresh_token)
+        return undefined;
+    try {
+        const res = await fetch(`${exports.API_URL}/api/auth/refresh`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ refresh_token: data.refresh_token }),
+        });
+        if (!res.ok)
+            return undefined;
+        const refreshed = (await res.json());
+        saveTokenData(refreshed);
+        return refreshed.access_token;
+    }
+    catch {
+        return undefined;
+    }
 }
-/** 프로젝트 로컬 installed.json 읽기 */
+/** 프로젝트 로컬 installed.json 읽기 (unscoped 키 자동 마이그레이션) */
 function loadInstalled() {
     const file = path_1.default.join(process.cwd(), '.relay', 'installed.json');
     if (!fs_1.default.existsSync(file)) {
@@ -73,12 +127,65 @@ function loadInstalled() {
     }
     try {
         const raw = fs_1.default.readFileSync(file, 'utf-8');
-        return JSON.parse(raw);
+        const registry = JSON.parse(raw);
+        return migrateInstalledKeys(registry);
     }
     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();

package/dist/lib/preamble.js

@@ -25,19 +25,16 @@ ${PREAMBLE_END}`;
 function injectPreamble(filePath, slug) {
     const content = fs_1.default.readFileSync(filePath, 'utf-8');
     const preamble = generatePreamble(slug);
-    // Replace existing preamble or prepend
     const startIdx = content.indexOf(PREAMBLE_START);
     const endIdx = content.indexOf(PREAMBLE_END);
     let newContent;
     if (startIdx !== -1 && endIdx !== -1) {
-        // Replace existing
         newContent =
             content.slice(0, startIdx) +
                 preamble +
                 content.slice(endIdx + PREAMBLE_END.length);
     }
     else {
-        // Prepend
         newContent = preamble + '\n\n' + content;
     }
     fs_1.default.writeFileSync(filePath, newContent);

package/dist/lib/slug.d.ts

@@ -0,0 +1,24 @@
+export interface ParsedSlug {
+    owner: string;
+    name: string;
+    full: string;
+}
+/**
+ * Scoped slug(`@owner/name`)를 동기적으로 파싱한다.
+ * 단순 slug는 파싱할 수 없으므로 null을 반환한다.
+ */
+export declare function parseSlug(input: string): ParsedSlug | null;
+/** input이 scoped slug인지 확인 */
+export declare function isScopedSlug(input: string): boolean;
+/** input이 단순 slug인지 확인 */
+export declare function isSimpleSlug(input: string): boolean;
+/**
+ * Scoped 또는 단순 slug를 받아 ParsedSlug를 반환한다.
+ * 단순 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

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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])?$/;
+/**
+ * Scoped slug(`@owner/name`)를 동기적으로 파싱한다.
+ * 단순 slug는 파싱할 수 없으므로 null을 반환한다.
+ */
+function parseSlug(input) {
+    const m = input.match(SCOPED_SLUG_RE);
+    if (!m)
+        return null;
+    return { owner: m[1], name: m[2], full: input };
+}
+/** input이 scoped slug인지 확인 */
+function isScopedSlug(input) {
+    return SCOPED_SLUG_RE.test(input);
+}
+/** input이 단순 slug인지 확인 */
+function isSimpleSlug(input) {
+    return SIMPLE_SLUG_RE.test(input);
+}
+/**
+ * Scoped 또는 단순 slug를 받아 ParsedSlug를 반환한다.
+ * 단순 slug는 서버에 resolve를 요청한다.
+ */
+async function resolveSlug(input) {
+    // scoped slug면 바로 파싱
+    const parsed = parseSlug(input);
+    if (parsed)
+        return parsed;
+    // 단순 slug인지 검증
+    if (!isSimpleSlug(input)) {
+        throw new Error(`잘못된 slug 형식입니다: '${input}'. @owner/name 또는 name 형태로 입력하세요.`);
+    }
+    // 서버에 resolve 요청
+    const results = await (0, api_js_1.resolveSlugFromServer)(input);
+    if (results.length === 0) {
+        throw new Error(`'${input}' 팀을 찾을 수 없습니다.`);
+    }
+    if (results.length === 1) {
+        const r = results[0];
+        return { owner: r.owner, name: r.name, full: r.full };
+    }
+    // 여러 개 매칭
+    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/lib/version-check.js

@@ -6,7 +6,6 @@ exports.checkAllTeams = checkAllTeams;
 const config_js_1 = require("./config.js");
 const api_js_1 = require("./api.js");
 const update_cache_js_1 = require("./update-cache.js");
-const device_hash_js_1 = require("./device-hash.js");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const pkg = require('../../package.json');
 async function checkCliVersion(force) {
@@ -37,15 +36,12 @@ async function checkTeamVersion(slug, force) {
         const entry = installed[slug];
         if (!entry?.version)
             return null;
+        // system 타입(relay-core)은 CLI 버전 체크로 대체
+        if (entry.type === 'system') {
+            return null;
+        }
         const team = await (0, api_js_1.fetchTeamInfo)(slug);
         (0, update_cache_js_1.updateCacheTimestamp)(slug);
-        // Send usage ping (fire-and-forget)
-        fetch(`${config_js_1.API_URL}/api/registry/${slug}/ping`, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({ device_hash: (0, device_hash_js_1.getDeviceHash)() }),
-            signal: AbortSignal.timeout(3000),
-        }).catch(() => { });
         if (team.version !== entry.version) {
             return {
                 type: 'team',

package/dist/types.d.ts

@@ -4,10 +4,12 @@ export interface InstalledTeam {
     files: string[];
     type?: 'team' | 'system';
 }
+/** 키는 scoped slug 포맷: "@owner/name" */
 export interface InstalledRegistry {
-    [slug: string]: InstalledTeam;
+    [scopedSlug: string]: InstalledTeam;
 }
 export interface TeamRegistryInfo {
+    /** scoped slug 포맷: "@owner/name" */
     slug: string;
     name: string;
     description?: string;
@@ -17,11 +19,9 @@ export interface TeamRegistryInfo {
         name: string;
         description: string;
     }[];
-    components: {
-        agents: number;
-        rules: number;
-        skills: number;
-    };
+    component_agents: number;
+    component_rules: number;
+    component_skills: number;
     tags?: string[];
     install_count?: number;
     requires?: Record<string, unknown>;
@@ -39,6 +39,7 @@ export interface TeamRegistryInfo {
     } | null;
 }
 export interface SearchResult {
+    /** scoped slug 포맷: "@owner/name" */
     slug: string;
     name: string;
     description: string;

package/package.json

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