relayax-cli 0.2.22 → 0.2.24

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

@@ -17,6 +17,8 @@ const check_update_js_1 = require("./commands/check-update.js");
 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();
@@ -40,4 +42,6 @@ program
 (0, follow_js_1.registerFollow)(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. 미리보기 + 컨펌
@@ -391,7 +426,17 @@ requires:
 - tags: 팀 특성에 맞는 태그를 추천합니다.
 - 사용자에게 확인: "이대로 배포할까요?"
 
-### 7. .relay/relay.yaml 업데이트
+### 7. 공개 범위 확인 (필수)
+- .relay/relay.yaml에 \`visibility\`가 반드시 설정되어 있어야 합니다.
+- 설정되어 있지 않으면 빌더에게 반드시 물어봅니다:
+  - "공개 (마켓플레이스에 누구나 검색·설치 가능)" vs "비공개 (Space 멤버만 접근)"
+- 선택 결과를 relay.yaml에 저장합니다.
+- 이미 설정되어 있으면 현재 값을 확인합니다:
+  - 공개인 경우: "⚠ 이 팀은 **공개**로 설정되어 있어 마켓플레이스에 노출됩니다. 맞나요?"
+  - 비공개인 경우: "이 팀은 **비공개**로 설정되어 Space 멤버만 접근 가능합니다."
+- 빌더가 변경을 원하면 relay.yaml을 업데이트합니다.
+
+### 8. .relay/relay.yaml 업데이트
 - 메타데이터, requires, 포트폴리오 슬롯을 .relay/relay.yaml에 반영합니다.
 
 \`\`\`yaml
@@ -406,9 +451,23 @@ portfolio:
       title: "카드뉴스 예시"
 \`\`\`
 
-### 8. 배포
+### 9. 배포
 - \`relay publish\` 명령어를 실행합니다.
 - 배포 결과와 마켓플레이스 URL을 보여줍니다.
+
+### 10. 공유용 온보딩 가이드 제공
+- \`relay publish\` 출력 끝에 코드블록 형태의 온보딩 가이드가 포함됩니다.
+- 이 코드블록을 사용자에게 그대로 보여줍니다.
+- 출력에 코드블록이 없으면 아래 형태로 직접 생성합니다:
+
+\\\`\\\`\\\`
+npm install -g relayax-cli
+relay login
+relay install <slug>
+\\\`\\\`\\\`
+
+- \`<slug>\`는 배포된 팀의 실제 슬러그로 치환합니다.
+- "이 블록을 팀원에게 공유하면 바로 설치할 수 있습니다"라고 안내합니다.
 ${BUSINESS_CARD_FORMAT}
 
 ## 예시
@@ -422,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;
+        }
+    }
+}