relayax-cli 0.1.992 → 0.1.995

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,9 @@ 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'];
 function resolveTools(toolsArg) {
     const raw = toolsArg.trim().toLowerCase();
@@ -121,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,19 +9,22 @@ 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 preamble_js_1 = require("../lib/preamble.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') {
@@ -62,8 +65,6 @@ function registerInstall(program) {
                 return count;
             }
             const fileCount = countFiles(teamDir);
-            // 5.5. Inject update-check preamble into SKILL.md files
-            (0, preamble_js_1.injectPreambleToTeam)(teamDir, slug);
             // 6. Record in installed.json
             const installed = (0, config_js_1.loadInstalled)();
             installed[slug] = {

package/dist/commands/login.js

@@ -96,7 +96,7 @@ function registerLogin(program) {
         .option('--token <token>', '직접 토큰 입력 (브라우저 없이)')
         .action(async (opts) => {
         const json = program.opts().json ?? false;
-        (0, config_js_1.ensureRelayDir)();
+        (0, config_js_1.ensureGlobalRelayDir)();
         let token = opts.token;
         if (!token) {
             try {

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,20 +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 preamble_js_1 = require("../lib/preamble.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
@@ -55,8 +70,6 @@ function registerUpdate(program) {
             await (0, storage_js_1.extractPackage)(tarPath, extractDir);
             // Copy files to install_path
             const files = (0, installer_js_1.installTeam)(extractDir, installPath);
-            // Inject update-check preamble into SKILL.md files
-            (0, preamble_js_1.injectPreambleToTeam)(installPath, slug);
             // Update installed.json with new version
             installed[slug] = {
                 version: latestVersion,

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,6 +44,15 @@ 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 headers = {

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',
@@ -83,8 +83,14 @@ exports.USER_COMMANDS = [
 
 ## 실행 방법
 
+### 0. 업데이트 확인
+- 먼저 \`relay check-update\` 명령어를 실행합니다.
+- CLI 업데이트가 있으면 사용자에게 안내합니다: "relay v{new} available. Run: npm update -g relayax-cli"
+- 팀 업데이트가 있으면 안내합니다.
+- 업데이트 여부와 관계없이 설치를 계속 진행합니다.
+
 ### 1. 팀 패키지 다운로드
-- \`relay install <slug>\` 명령어를 실행합니다.
+- \`relay install <@author/slug>\` 명령어를 실행합니다.
 - 패키지가 \`.relay/teams/<slug>/\`에 다운로드됩니다.
 
 ### 2. 패키지 내용 확인
@@ -109,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. 완료 안내
@@ -118,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 설치됨
@@ -145,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"`,
     },
     {
@@ -155,15 +161,20 @@ ${LOGIN_JIT_GUIDE}
 
 ## 실행 방법
 
+### 0. CLI 업데이트 확인
+- 먼저 \`relay check-update\` 명령어를 실행합니다.
+- CLI 업데이트가 있으면 사용자에게 안내합니다: "relay v{new} available. Run: npm update -g relayax-cli"
+- 업데이트 여부와 관계없이 팀 업데이트를 계속 진행합니다.
+
 ### 특정 팀 업데이트
-- 사용자가 팀 이름을 지정한 경우: \`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. 모두 최신이면 "모든 팀이 최신 버전입니다"라고 안내합니다.
 
 ## 예시
@@ -171,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',
@@ -183,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 (로컬 설치) ───
@@ -282,7 +293,7 @@ requires:
     - filesystem
     - network
   teams:
-    - contents-team
+    - @example/contents-team
 \`\`\`
 
 ### 4. 포트폴리오 생성 (슬롯 기반)

package/dist/lib/config.d.ts

@@ -7,8 +7,18 @@ export declare const API_URL = "https://www.relayax.com";
  * 3. 감지 안 되면 현재 디렉토리에 직접 설치
  */
 export declare function getInstallPath(override?: string): string;
-export declare function ensureRelayDir(): void;
+/** ~/.relay/ — 글로벌 (token, CLI cache) */
+export declare function ensureGlobalRelayDir(): void;
+/** cwd/.relay/ — 프로젝트 로컬 (installed.json, teams/) */
+export declare function ensureProjectRelayDir(): void;
 export declare function loadToken(): string | undefined;
 export declare function saveToken(token: string): void;
+/** 프로젝트 로컬 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

@@ -5,18 +5,20 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.API_URL = void 0;
 exports.getInstallPath = getInstallPath;
-exports.ensureRelayDir = ensureRelayDir;
+exports.ensureGlobalRelayDir = ensureGlobalRelayDir;
+exports.ensureProjectRelayDir = ensureProjectRelayDir;
 exports.loadToken = loadToken;
 exports.saveToken = saveToken;
 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 RELAY_DIR = path_1.default.join(os_1.default.homedir(), '.relay');
-const INSTALLED_FILE = path_1.default.join(RELAY_DIR, 'installed.json');
+const GLOBAL_RELAY_DIR = path_1.default.join(os_1.default.homedir(), '.relay');
 /**
  * 설치 경로를 결정한다.
  * 1. --path 옵션이 있으면 그대로 사용
@@ -37,13 +39,21 @@ function getInstallPath(override) {
     }
     return cwd;
 }
-function ensureRelayDir() {
-    if (!fs_1.default.existsSync(RELAY_DIR)) {
-        fs_1.default.mkdirSync(RELAY_DIR, { recursive: true });
+/** ~/.relay/ — 글로벌 (token, CLI cache) */
+function ensureGlobalRelayDir() {
+    if (!fs_1.default.existsSync(GLOBAL_RELAY_DIR)) {
+        fs_1.default.mkdirSync(GLOBAL_RELAY_DIR, { recursive: true });
+    }
+}
+/** cwd/.relay/ — 프로젝트 로컬 (installed.json, teams/) */
+function ensureProjectRelayDir() {
+    const dir = path_1.default.join(process.cwd(), '.relay');
+    if (!fs_1.default.existsSync(dir)) {
+        fs_1.default.mkdirSync(dir, { recursive: true });
     }
 }
 function loadToken() {
-    const tokenFile = path_1.default.join(RELAY_DIR, 'token');
+    const tokenFile = path_1.default.join(GLOBAL_RELAY_DIR, 'token');
     if (!fs_1.default.existsSync(tokenFile))
         return undefined;
     try {
@@ -54,22 +64,79 @@ function loadToken() {
     }
 }
 function saveToken(token) {
-    ensureRelayDir();
-    fs_1.default.writeFileSync(path_1.default.join(RELAY_DIR, 'token'), token);
+    ensureGlobalRelayDir();
+    fs_1.default.writeFileSync(path_1.default.join(GLOBAL_RELAY_DIR, 'token'), token);
 }
+/** 프로젝트 로컬 installed.json 읽기 (unscoped 키 자동 마이그레이션) */
 function loadInstalled() {
-    if (!fs_1.default.existsSync(INSTALLED_FILE)) {
+    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(INSTALLED_FILE, 'utf-8');
-        return JSON.parse(raw);
+        const raw = fs_1.default.readFileSync(file, 'utf-8');
+        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) {
-    ensureRelayDir();
-    fs_1.default.writeFileSync(INSTALLED_FILE, JSON.stringify(registry, null, 2));
+    ensureProjectRelayDir();
+    const file = path_1.default.join(process.cwd(), '.relay', 'installed.json');
+    fs_1.default.writeFileSync(file, JSON.stringify(registry, null, 2));
 }

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

@@ -2,11 +2,14 @@ export interface InstalledTeam {
     version: string;
     installed_at: string;
     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;
@@ -16,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>;
@@ -38,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.992",
+  "version": "0.1.995",
   "description": "RelayAX Agent Team Marketplace CLI - Install and manage agent teams",
   "main": "dist/index.js",
   "bin": {