relayax-cli 0.2.29 → 0.2.34

package/dist/commands/install.js

@@ -181,18 +181,19 @@ function registerInstall(program) {
                 return count;
             }
             const fileCount = countFiles(teamDir);
-            // 6. Record in installed.json (space_slug 포함)
+            // 6. Record in installed.json (team_id, space_slug 포함)
             const installed = (0, config_js_1.loadInstalled)();
             installed[slug] = {
+                team_id: team.id,
                 version: team.version,
                 installed_at: new Date().toISOString(),
                 files: [teamDir],
                 ...(spaceTarget ? { space_slug: spaceTarget.spaceSlug } : {}),
             };
             (0, config_js_1.saveInstalled)(installed);
-            // 7. Report install + usage ping (non-blocking)
-            await (0, api_js_1.reportInstall)(slug, team.version);
-            (0, api_js_1.sendUsagePing)(slug, team.version);
+            // 7. Report install + usage ping (non-blocking, team_id 기반)
+            await (0, api_js_1.reportInstall)(team.id, slug, team.version);
+            (0, api_js_1.sendUsagePing)(team.id, slug, team.version);
             const result = {
                 status: 'ok',
                 team: team.name,

package/dist/commands/ping.js

@@ -25,13 +25,16 @@ function registerPing(program) {
             });
             slug = match ?? slugInput;
         }
-        // Resolve version from installed registry
+        // Resolve version and team_id from installed registry
         const local = (0, config_js_1.loadInstalled)();
         const global = (0, config_js_1.loadGlobalInstalled)();
         const entry = local[slug] ?? global[slug];
         const version = entry?.version;
-        // Fire-and-forget ping
-        await (0, api_js_1.sendUsagePing)(slug, version);
+        const teamId = entry?.team_id;
+        // Fire-and-forget ping (team_id 기반, 없으면 skip)
+        if (teamId) {
+            await (0, api_js_1.sendUsagePing)(teamId, slug, version);
+        }
         if (!opts.quiet) {
             console.log(`RELAY_READY: ${slug}`);
         }

package/dist/commands/publish.js

@@ -249,10 +249,13 @@ function resolveLongDescription(teamDir, yamlValue) {
 async function createTarball(teamDir) {
     const tmpFile = path_1.default.join(os_1.default.tmpdir(), `relay-publish-${Date.now()}.tar.gz`);
     const dirsToInclude = VALID_DIRS.filter((d) => fs_1.default.existsSync(path_1.default.join(teamDir, d)));
-    // Include GUIDE.html if it exists (root SKILL.md is replaced by entry command)
+    // Include root-level files if they exist
     const entries = [...dirsToInclude];
-    if (fs_1.default.existsSync(path_1.default.join(teamDir, 'GUIDE.html'))) {
-        entries.push('GUIDE.html');
+    const rootFiles = ['relay.yaml', 'GUIDE.html', 'SKILL.md'];
+    for (const file of rootFiles) {
+        if (fs_1.default.existsSync(path_1.default.join(teamDir, file))) {
+            entries.push(file);
+        }
     }
     await (0, tar_1.create)({
         gzip: true,
@@ -435,6 +438,30 @@ function registerPublish(program) {
             }));
             process.exit(1);
         }
+        // Version bump suggestion for republishing
+        if (isTTY) {
+            const { select: promptVersion } = await import('@inquirer/prompts');
+            const [major, minor, patch] = config.version.split('.').map(Number);
+            const bumpPatch = `${major}.${minor}.${patch + 1}`;
+            const bumpMinor = `${major}.${minor + 1}.0`;
+            const bumpMajor = `${major + 1}.0.0`;
+            const newVersion = await promptVersion({
+                message: `버전 (현재 v${config.version}):`,
+                choices: [
+                    { name: `v${bumpPatch} — patch (버그 수정)`, value: bumpPatch },
+                    { name: `v${bumpMinor} — minor (기능 추가)`, value: bumpMinor },
+                    { name: `v${bumpMajor} — major (큰 변경)`, value: bumpMajor },
+                    { name: `v${config.version} — 유지`, value: config.version },
+                ],
+            });
+            if (newVersion !== config.version) {
+                config.version = newVersion;
+                const yamlData = js_yaml_1.default.load(fs_1.default.readFileSync(relayYamlPath, 'utf-8'));
+                yamlData.version = newVersion;
+                fs_1.default.writeFileSync(relayYamlPath, js_yaml_1.default.dump(yamlData, { lineWidth: 120 }), 'utf-8');
+                console.error(`  → relay.yaml에 version: ${newVersion} 저장됨\n`);
+            }
+        }
         // Visibility validation: must be explicitly set
         if (!config.visibility) {
             if (isTTY) {
@@ -480,12 +507,27 @@ function registerPublish(program) {
                 process.exit(1);
             }
         }
-        // Confirm visibility before publish
+        // Confirm visibility before publish (재배포 시 변경 기회 제공)
         if (isTTY) {
+            const { select: promptConfirmVis } = await import('@inquirer/prompts');
             const visLabel = config.visibility === 'public'
                 ? '\x1b[32m공개\x1b[0m (마켓플레이스에 누구나 검색·설치)'
                 : '\x1b[33m비공개\x1b[0m (Space 멤버만 접근)';
-            console.error(`공개 범위: ${visLabel}`);
+            const visAction = await promptConfirmVis({
+                message: `공개 범위: ${config.visibility === 'public' ? '공개' : '비공개'} — 유지할까요?`,
+                choices: [
+                    { name: `유지 — ${visLabel}`, value: 'keep' },
+                    { name: '변경', value: 'change' },
+                ],
+            });
+            if (visAction === 'change') {
+                config.visibility = config.visibility === 'public' ? 'private' : 'public';
+                const yamlData = js_yaml_1.default.load(fs_1.default.readFileSync(relayYamlPath, 'utf-8'));
+                yamlData.visibility = config.visibility;
+                fs_1.default.writeFileSync(relayYamlPath, js_yaml_1.default.dump(yamlData, { lineWidth: 120 }), 'utf-8');
+                const newLabel = config.visibility === 'public' ? '공개' : '비공개';
+                console.error(`  → relay.yaml에 visibility: ${config.visibility} 저장됨 (${newLabel})\n`);
+            }
         }
         // Profile hint
         if (isTTY) {

package/dist/commands/update.js

@@ -67,6 +67,7 @@ function registerUpdate(program) {
             const hadDeployedFiles = (currentEntry?.deployed_files?.length ?? 0) > 0;
             // Update installed.json with new version
             installed[slug] = {
+                team_id: team.id,
                 version: latestVersion,
                 installed_at: new Date().toISOString(),
                 files,
@@ -75,8 +76,8 @@ function registerUpdate(program) {
                 // Clear deployed_files — agent must re-deploy and call deploy-record
             };
             (0, config_js_1.saveInstalled)(installed);
-            // Report install (non-blocking)
-            await (0, api_js_1.reportInstall)(slug);
+            // Report install (non-blocking, team_id 기반)
+            await (0, api_js_1.reportInstall)(team.id, slug, latestVersion);
             const result = {
                 status: 'updated',
                 slug,

package/dist/lib/api.d.ts

@@ -7,7 +7,7 @@ export interface TeamVersionInfo {
     created_at: string;
 }
 export declare function fetchTeamVersions(slug: string): Promise<TeamVersionInfo[]>;
-export declare function reportInstall(slug: string, version?: string): Promise<void>;
+export declare function reportInstall(teamId: string, slug: string, version?: string): Promise<void>;
 /**
  * Space 팀 설치: 멤버십 검증 + install count 증가 + 팀 메타데이터 반환을 한 번에 처리.
  * POST /api/spaces/{spaceSlug}/teams/{teamSlug}/install
@@ -19,5 +19,5 @@ export interface ResolvedSlug {
     full: string;
 }
 export declare function resolveSlugFromServer(name: string): Promise<ResolvedSlug[]>;
-export declare function sendUsagePing(slug: string, version?: string): Promise<void>;
+export declare function sendUsagePing(teamId: string, slug: string, version?: string): Promise<void>;
 export declare function followBuilder(username: string): Promise<void>;

package/dist/lib/api.js

@@ -42,26 +42,30 @@ async function fetchTeamVersions(slug) {
     }
     return res.json();
 }
-async function reportInstall(slug, version) {
-    const registrySlug = slug.startsWith('@') ? slug.slice(1) : slug;
-    const url = `${config_js_1.API_URL}/api/registry/${registrySlug}/install`;
-    const headers = {};
-    const body = {};
-    if (version) {
-        headers['Content-Type'] = 'application/json';
+async function reportInstall(teamId, slug, version) {
+    const url = `${config_js_1.API_URL}/api/teams/${teamId}/install`;
+    const headers = { 'Content-Type': 'application/json' };
+    const body = { slug };
+    if (version)
         body.version = version;
-    }
     const token = await (0, config_js_1.getValidToken)();
     if (token) {
         headers['Authorization'] = `Bearer ${token}`;
     }
-    await fetch(url, {
-        method: 'POST',
-        headers: Object.keys(headers).length > 0 ? headers : undefined,
-        body: Object.keys(body).length > 0 ? JSON.stringify(body) : undefined,
-    }).catch(() => {
-        // non-critical: ignore errors
-    });
+    try {
+        const res = await fetch(url, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => '');
+            console.error(`\x1b[33m⚠ 설치 카운트 업데이트 실패 (${res.status}): ${text}\x1b[0m`);
+        }
+    }
+    catch {
+        // network error: ignore silently
+    }
 }
 /**
  * Space 팀 설치: 멤버십 검증 + install count 증가 + 팀 메타데이터 반환을 한 번에 처리.
@@ -97,15 +101,14 @@ async function resolveSlugFromServer(name) {
     const data = (await res.json());
     return data.results;
 }
-async function sendUsagePing(slug, version) {
-    const registrySlug = slug.startsWith('@') ? slug.slice(1) : slug;
+async function sendUsagePing(teamId, slug, version) {
     const { createHash } = await import('crypto');
     const { hostname, userInfo } = await import('os');
     const deviceHash = createHash('sha256')
         .update(`${hostname()}:${userInfo().username}`)
         .digest('hex');
-    const url = `${config_js_1.API_URL}/api/registry/${registrySlug}/ping`;
-    const payload = { device_hash: deviceHash };
+    const url = `${config_js_1.API_URL}/api/teams/${teamId}/ping`;
+    const payload = { device_hash: deviceHash, slug };
     if (version)
         payload.installed_version = version;
     const headers = { 'Content-Type': 'application/json' };

package/dist/lib/command-adapter.js

@@ -183,11 +183,28 @@ slug가 직접 주어지면 (\`/relay-install @alice/doc-writer\`) 이 단계를
 - CLI가 init과 login을 자동으로 처리합니다 (사용자가 별도 실행할 필요 없음).
 - JSON 출력에서 \`install_path\` (패키지 경로)를 확인합니다.
 
-#### 2-2. 배치 범위 선택
+#### 2-2. 배치 범위 선택 (추천 포함)
+
+팀의 성격을 분석하여 글로벌/로컬 중 적합한 쪽을 추천합니다.
+
+**추천 로직:**
+- **글로벌 추천** — 범용 유틸리티 팀: 코드 리뷰, 문서 생성, 테스트, 번역 등 프로젝트에 무관하게 사용하는 도구성 팀
+- **로컬 추천** — 프로젝트 특화 팀: 특정 프레임워크/스택 전용, 프로젝트별 워크플로우, 팀 내부 컨벤션에 의존하는 팀
+
+판단 기준 (다운로드된 패키지의 relay.yaml과 콘텐츠를 분석):
+1. \`tags\`에 특정 프레임워크/스택 키워드가 있으면 (nextjs, supabase, react 등) → 로컬 추천
+2. \`requires\`에 프로젝트 종속 의존성이 있으면 (npm 패키지, 특정 파일 구조) → 로컬 추천
+3. rules/ 파일이 있으면 (프로젝트 컨벤션 주입) → 로컬 추천
+4. 범용 키워드 (utility, review, docs, testing 등) → 글로벌 추천
+5. 판단이 어려우면 → 글로벌 추천 (기본값)
 
 **AskUserQuestion 호출:**
-- question: "어디에 설치할까요?"
-- options: \`["글로벌 (모든 프로젝트)", "로컬 (이 프로젝트만)"]\`
+- question: "{추천 이유}. {추천}에 설치할까요?"
+- options: \`["글로벌 (모든 프로젝트) ✓ 추천", "로컬 (이 프로젝트만)"]\` 또는 \`["글로벌 (모든 프로젝트)", "로컬 (이 프로젝트만) ✓ 추천"]\`
+
+예시:
+- "범용 코드 리뷰 도구입니다. 글로벌에 설치할까요?" → \`["글로벌 (모든 프로젝트) ✓ 추천", "로컬 (이 프로젝트만)"]\`
+- "Next.js + Supabase 전용 팀입니다. 이 프로젝트에 설치할까요?" → \`["글로벌 (모든 프로젝트)", "로컬 (이 프로젝트만) ✓ 추천"]\`
 
 **응답 처리:**
 - "글로벌" → \`~/.claude/\`에 배치
@@ -206,14 +223,65 @@ slug가 직접 주어지면 (\`/relay-install @alice/doc-writer\`) 이 단계를
 relay deploy-record <slug> --scope <global|local> --files <배치된_파일1> <배치된_파일2> ...
 \`\`\`
 
-#### 2-5. Requirements 확인 및 설치
-\`<install_path>/relay.yaml\`의 \`requires\` 섹션을 읽고 처리합니다:
-- **cli**: \`which <name>\`으로 확인 → 없으면 install 명령 실행 또는 안내
-- **npm**: \`npm list <package>\`로 확인 → 없으면 \`npm install\`
-- **env**: 환경변수 확인 → required이면 설정 안내, optional이면 알림
-- **mcp**: MCP 서버 설정 — 에이전트의 MCP 설정에 추가 안내
-- **runtime**: Node.js/Python 버전 확인
-- **teams**: 의존하는 다른 팀 → \`relay install <@author/team>\`으로 재귀 설치
+#### 2-5. Requirements 체크리스트 (필수 — 항목이 있으면 반드시 수행)
+
+\`<install_path>/relay.yaml\`의 \`requires\` 섹션을 읽고, **각 항목을 하나씩 확인하여 체크리스트로 표시**합니다.
+requires 섹션이 없거나 비어있으면 이 단계를 건너뜁니다.
+
+**출력 형식** (반드시 이 형식으로 사용자에게 보여줍니다):
+\`\`\`
+📋 Requirements 확인
+
+[runtime]
+  ✅ Node.js >=18 — v20.11.0 확인됨
+  ❌ Python >=3.10 — v3.8.5 (업그레이드 필요)
+
+[cli]
+  ✅ playwright — 설치됨
+  ❌ ffmpeg — 미설치 → 설치 명령: brew install ffmpeg
+
+[npm]
+  ✅ sharp — 설치됨
+  ❌ puppeteer — 미설치 → 설치 중...
+
+[env]
+  ✅ OPENAI_API_KEY — 설정됨
+  ❌ SLACK_WEBHOOK_URL (선택) — 미설정. 알림 전송에 필요
+
+[mcp]
+  ⚙️  supabase — MCP 서버 설정 필요 (아래 안내 참고)
+
+[teams]
+  ✅ @alice/doc-writer — 이미 설치됨
+  📦 @bob/utils — 미설치 → 설치 중...
+\`\`\`
+
+**처리 규칙 (각 카테고리별):**
+
+1. **runtime**: \`node --version\`, \`python3 --version\`으로 확인. 버전 미달이면 ❌ 표시 후 업그레이드 안내.
+2. **cli**: \`which <name>\`으로 확인.
+   - 설치됨 → ✅
+   - 미설치 + \`install\` 필드 있음 → 사용자에게 설치할지 물어본 후 실행
+   - 미설치 + \`install\` 필드 없음 → ❌ 표시 후 수동 설치 안내
+3. **npm**: \`npm list <package> 2>/dev/null\`으로 확인.
+   - 설치됨 → ✅
+   - 미설치 + required → \`npm install <package>\` 실행
+   - 미설치 + optional → ❌ 표시 후 안내만
+4. **env**: \`echo $<NAME>\`으로 확인.
+   - 설정됨 → ✅
+   - 미설정 + required → ❌ 표시 후 \`description\`과 함께 설정 방법 안내
+   - 미설정 + optional → ⚠️ 표시 후 용도 안내
+5. **mcp**: MCP 서버 설정이 필요한 경우 ⚙️ 표시 후 설정 방법을 상세히 안내.
+   - \`config\` 필드가 있으면 settings.json에 추가할 JSON 블록을 보여줍니다.
+   - \`env\` 필드가 있으면 필요한 환경변수도 함께 안내합니다.
+6. **teams**: \`relay list --json\`으로 설치 여부 확인.
+   - 설치됨 → ✅
+   - 미설치 → \`relay install <@author/team> --json\` 실행하여 재귀 설치
+
+**중요**: 모든 required 항목이 ❌인 경우, 체크리스트 끝에 경고를 표시합니다:
+\`\`\`
+⚠️  필수 요구사항이 충족되지 않았습니다. 팀 기능이 제한될 수 있습니다.
+\`\`\`
 ${LOGIN_JIT_GUIDE}
 
 ### Step 3. 완료 & 팔로우 제안
@@ -401,7 +469,21 @@ ${LOGIN_JIT_GUIDE}
 
 ## 인터랙션 플로우
 
-이 커맨드는 5단계 인터랙션으로 진행됩니다. 각 단계에서 반드시 AskUserQuestion 도구를 사용하세요.
+이 커맨드는 6단계 인터랙션으로 진행됩니다. 각 단계에서 반드시 AskUserQuestion 도구를 사용하세요.
+
+### Step 0. 버전 범프
+
+relay.yaml의 현재 \`version\`을 읽고 semver 범프를 제안합니다.
+
+**AskUserQuestion 호출:**
+- question: "버전을 올릴까요? (현재 v{version})"
+- options: \`["v{patch} — patch (버그 수정)", "v{minor} — minor (기능 추가)", "v{major} — major (큰 변경)", "v{version} — 유지"]\`
+
+예시: 현재 v1.0.0이면 → \`["v1.0.1 — patch", "v1.1.0 — minor", "v2.0.0 — major", "v1.0.0 — 유지"]\`
+
+**응답 처리:**
+- 유지 외 선택 → relay.yaml의 version을 선택된 값으로 업데이트
+- 유지 → 그대로 진행
 
 ### Step 1. 공개 범위 선택
 
@@ -604,7 +686,7 @@ requires: env 2개, cli 1개
 - options: \`["배포", "취소"]\`
 
 **응답 처리:**
-- "배포" → \`relay publish\` 실행
+- "배포" → \`relay publish --json\` 실행 (슬래시 커맨드에서 이미 버전/visibility를 relay.yaml에 저장했으므로 --json으로 인터랙티브 프롬프트 생략)
 - "취소" → 중단
 
 #### 5-3. 배포 완료 & 온보딩 가이드

package/dist/lib/version-check.js

@@ -43,7 +43,10 @@ async function checkTeamVersion(slug, force) {
         const team = await (0, api_js_1.fetchTeamInfo)(slug);
         (0, update_cache_js_1.updateCacheTimestamp)(slug);
         // Fire-and-forget usage ping (only when cache expired = actual API call happened)
-        (0, api_js_1.sendUsagePing)(slug, entry.version);
+        const teamId = entry.team_id ?? team.id;
+        if (teamId) {
+            (0, api_js_1.sendUsagePing)(teamId, slug, entry.version);
+        }
         if (team.version !== entry.version) {
             return {
                 type: 'team',

package/dist/types.d.ts

@@ -4,6 +4,8 @@ export interface ContactItem {
     value: string;
 }
 export interface InstalledTeam {
+    /** team UUID — 설치 카운트/핑 등 서버 통신에 사용 */
+    team_id?: string;
     version: string;
     installed_at: string;
     files: string[];
@@ -20,6 +22,8 @@ export interface InstalledRegistry {
     [scopedSlug: string]: InstalledTeam;
 }
 export interface TeamRegistryInfo {
+    /** team UUID */
+    id: string;
     /** scoped slug 포맷: "@owner/name" */
     slug: string;
     name: string;

package/package.json

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