relayax-cli 0.2.30 → 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,

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

@@ -223,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. 완료 & 팔로우 제안

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.30",
+  "version": "0.2.34",
   "description": "RelayAX Agent Team Marketplace CLI - Install and manage agent teams",
   "main": "dist/index.js",
   "bin": {