relayax-cli 0.2.26 → 0.2.28

package/README.md

@@ -6,11 +6,11 @@ Agent Team Marketplace CLI - 에이전트 팀을 검색하고 설치하세요.
 
 ```bash
 # 글로벌 설치 없이 바로 사용
-npx relay-cli install contents-team
+npx relay-cli install @author/team-name
 
 # 또는 글로벌 설치
 npm install -g relayax-cli
-relay install contents-team
+relay install @author/team-name
 ```
 
 ## Commands
@@ -34,9 +34,9 @@ relay CLI는 에이전트가 1차 사용자입니다. 모든 출력은 JSON 기
 
 ```bash
 # 에이전트가 팀 검색
-relay search "콘텐츠" | jq '.results[].slug'
+relay search "keyword" | jq '.results[].slug'
 
 # 에이전트가 팀 설치
-relay install contents-team
-# → {"status":"ok","team":"Contents Team","commands":[...]}
+relay install @author/team-name
+# → {"status":"ok","team":"Team Name","commands":[...]}
 ```

package/dist/commands/create.js

@@ -9,19 +9,15 @@ const path_1 = __importDefault(require("path"));
 const js_yaml_1 = __importDefault(require("js-yaml"));
 const ai_tools_js_1 = require("../lib/ai-tools.js");
 const command_adapter_js_1 = require("../lib/command-adapter.js");
+const init_js_1 = require("./init.js");
 const DEFAULT_DIRS = ['.relay/skills', '.relay/commands'];
 /**
  * 글로벌 User 커맨드가 없으면 설치한다.
  */
 function ensureGlobalUserCommands() {
-    const allExist = command_adapter_js_1.USER_COMMANDS.every((cmd) => fs_1.default.existsSync((0, command_adapter_js_1.getGlobalCommandPath)(cmd.id)));
-    if (allExist)
+    if ((0, init_js_1.hasGlobalUserCommands)())
         return false;
-    const globalDir = (0, command_adapter_js_1.getGlobalCommandDir)();
-    fs_1.default.mkdirSync(globalDir, { recursive: true });
-    for (const cmd of command_adapter_js_1.USER_COMMANDS) {
-        fs_1.default.writeFileSync((0, command_adapter_js_1.getGlobalCommandPath)(cmd.id), (0, command_adapter_js_1.formatCommandFile)(cmd));
-    }
+    (0, init_js_1.installGlobalUserCommands)();
     return true;
 }
 function registerCreate(program) {

package/dist/commands/init.d.ts

@@ -1,11 +1,13 @@
 import { Command } from 'commander';
 /**
- * 글로벌 User 커맨드를 ~/.claude/commands/relay/에 설치한다.
+ * 글로벌 User 커맨드를 감지된 모든 에이전트 CLI에 설치한다.
+ * ~/{skillsDir}/commands/relay/ 에 설치.
  * 기존 파일 중 현재 커맨드 목록에 없는 것은 제거한다.
  */
 export declare function installGlobalUserCommands(): {
     installed: boolean;
     commands: string[];
+    tools: string[];
 };
 /**
  * 글로벌 User 커맨드가 이미 설치되어 있는지 확인한다.

package/dist/commands/init.js

@@ -35,10 +35,8 @@ function showWelcome() {
         '  에이전트 CLI에 relay 커맨드를 연결합니다.',
         '',
         '  \x1b[2mUser 커맨드 (글로벌)\x1b[0m',
-        '  /relay-explore     마켓플레이스 탐색',
-        '  /relay-install     팀 설치',
-        '  /relay-list        설치된 팀 목록',
-        '  /relay-update      팀 업데이트',
+        '  /relay-install     팀 탐색 & 설치',
+        '  /relay-status      설치 현황 & Space',
         '  /relay-uninstall   팀 삭제',
         '',
     ];
@@ -62,31 +60,39 @@ async function selectToolsInteractively(detectedIds) {
     return selected;
 }
 /**
- * 글로벌 User 커맨드를 ~/.claude/commands/relay/에 설치한다.
+ * 글로벌 User 커맨드를 감지된 모든 에이전트 CLI에 설치한다.
+ * ~/{skillsDir}/commands/relay/ 에 설치.
  * 기존 파일 중 현재 커맨드 목록에 없는 것은 제거한다.
  */
 function installGlobalUserCommands() {
-    const globalDir = (0, command_adapter_js_1.getGlobalCommandDir)();
-    fs_1.default.mkdirSync(globalDir, { recursive: true });
-    // 현재 커맨드 ID 세트
+    const globalCLIs = (0, ai_tools_js_1.detectGlobalCLIs)();
     const currentIds = new Set(command_adapter_js_1.USER_COMMANDS.map((c) => c.id));
-    // 기존 파일 중 현재 목록에 없는 것 제거
-    if (fs_1.default.existsSync(globalDir)) {
-        for (const file of fs_1.default.readdirSync(globalDir)) {
+    const commands = [];
+    const tools = [];
+    // 감지된 CLI가 없으면 Claude Code에만 설치 (기본)
+    const targetDirs = globalCLIs.length > 0
+        ? globalCLIs.map((t) => ({ name: t.name, dir: (0, command_adapter_js_1.getGlobalCommandDirForTool)(t.skillsDir), getPath: (id) => (0, command_adapter_js_1.getGlobalCommandPathForTool)(t.skillsDir, id) }))
+        : [{ name: 'Claude Code', dir: (0, command_adapter_js_1.getGlobalCommandDir)(), getPath: (id) => (0, command_adapter_js_1.getGlobalCommandPath)(id) }];
+    for (const target of targetDirs) {
+        fs_1.default.mkdirSync(target.dir, { recursive: true });
+        // 기존 파일 중 현재 목록에 없는 것 제거
+        for (const file of fs_1.default.readdirSync(target.dir)) {
             const id = file.replace(/\.md$/, '');
             if (!currentIds.has(id)) {
-                fs_1.default.unlinkSync(path_1.default.join(globalDir, file));
+                fs_1.default.unlinkSync(path_1.default.join(target.dir, file));
             }
         }
+        // 현재 커맨드 설치 (덮어쓰기)
+        for (const cmd of command_adapter_js_1.USER_COMMANDS) {
+            fs_1.default.writeFileSync(target.getPath(cmd.id), (0, command_adapter_js_1.formatCommandFile)(cmd));
+        }
+        tools.push(target.name);
     }
-    // 현재 커맨드 설치 (덮어쓰기)
-    const commands = [];
+    // commands 목록은 한 번만
     for (const cmd of command_adapter_js_1.USER_COMMANDS) {
-        const filePath = (0, command_adapter_js_1.getGlobalCommandPath)(cmd.id);
-        fs_1.default.writeFileSync(filePath, (0, command_adapter_js_1.formatCommandFile)(cmd));
         commands.push(cmd.id);
     }
-    return { installed: true, commands };
+    return { installed: true, commands, tools };
 }
 /**
  * 글로벌 User 커맨드가 이미 설치되어 있는지 확인한다.
@@ -128,15 +134,17 @@ function registerInit(program) {
         const isBuilder = isTeamProject(projectPath);
         // ── 1. 글로벌 User 커맨드 설치 ──
         let globalStatus = 'already';
+        let globalTools = [];
         if (opts.update || !hasGlobalUserCommands()) {
-            const { commands } = installGlobalUserCommands();
+            const result = installGlobalUserCommands();
             globalStatus = opts.update ? 'updated' : 'installed';
+            globalTools = result.tools;
             // 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)),
+                files: result.commands.map((c) => (0, command_adapter_js_1.getGlobalCommandPath)(c)),
                 type: 'system',
             };
             (0, config_js_1.saveInstalled)(installed);
@@ -234,8 +242,9 @@ function registerInit(program) {
             console.log(`\n\x1b[32m✓ relay ${opts.update ? '업데이트' : '초기화'} 완료\x1b[0m\n`);
             // 글로벌
             if (globalStatus !== 'already') {
+                const toolNames = globalTools.length > 0 ? globalTools.join(', ') : 'Claude Code';
                 console.log(`  \x1b[36mUser 커맨드 (글로벌)\x1b[0m — ${globalStatus === 'updated' ? '업데이트됨' : '설치됨'}`);
-                console.log(`  ${(0, command_adapter_js_1.getGlobalCommandDir)()}`);
+                console.log(`  감지된 CLI: \x1b[36m${toolNames}\x1b[0m`);
                 for (const cmd of command_adapter_js_1.USER_COMMANDS) {
                     console.log(`    /${cmd.id}`);
                 }

package/dist/commands/install.js

@@ -190,8 +190,9 @@ function registerInstall(program) {
                 ...(spaceTarget ? { space_slug: spaceTarget.spaceSlug } : {}),
             };
             (0, config_js_1.saveInstalled)(installed);
-            // 7. Report install (non-blocking)
+            // 7. Report install + usage ping (non-blocking)
             await (0, api_js_1.reportInstall)(slug, team.version);
+            (0, api_js_1.sendUsagePing)(slug, team.version);
             const result = {
                 status: 'ok',
                 team: team.name,

package/dist/commands/ping.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerPing(program: Command): void;

package/dist/commands/ping.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPing = registerPing;
+const api_js_1 = require("../lib/api.js");
+const config_js_1 = require("../lib/config.js");
+const slug_js_1 = require("../lib/slug.js");
+function registerPing(program) {
+    program
+        .command('ping <slug>')
+        .description('사용 현황을 기록합니다 (preamble용 경량 명령)')
+        .option('--quiet', '출력 없이 실행')
+        .action(async (slugInput, opts) => {
+        // Resolve slug
+        let slug;
+        if ((0, slug_js_1.isScopedSlug)(slugInput)) {
+            slug = slugInput;
+        }
+        else {
+            const localRegistry = (0, config_js_1.loadInstalled)();
+            const globalRegistry = (0, config_js_1.loadGlobalInstalled)();
+            const allKeys = [...Object.keys(localRegistry), ...Object.keys(globalRegistry)];
+            const match = allKeys.find((key) => {
+                const parsed = (0, slug_js_1.parseSlug)(key);
+                return parsed && parsed.name === slugInput;
+            });
+            slug = match ?? slugInput;
+        }
+        // Resolve version 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);
+        if (!opts.quiet) {
+            console.log(`RELAY_READY: ${slug}`);
+        }
+    });
+}

package/dist/commands/publish.js

@@ -15,7 +15,7 @@ const preamble_js_1 = require("../lib/preamble.js");
 const version_check_js_1 = require("../lib/version-check.js");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const cliPkg = require('../../package.json');
-const VALID_DIRS = ['skills', 'agents', 'rules', 'commands'];
+const VALID_DIRS = ['skills', 'agents', 'rules', 'commands', 'bin'];
 const IMAGE_EXTS = ['.png', '.jpg', '.jpeg', '.webp'];
 /** 개별 포트폴리오 이미지 최대 크기 (2 MB) */
 const MAX_IMAGE_SIZE = 2 * 1024 * 1024;
@@ -125,20 +125,28 @@ function detectSkills(teamDir) {
     }
     return entries;
 }
-function generateRootSkillMd(config, commands, skills, scopedSlug) {
+/**
+ * 팀 진입점 커맨드(commands/{author}-{name}.md)를 생성한다.
+ * root SKILL.md를 대체하여 팀의 얼굴 역할을 한다.
+ */
+function generateEntryCommand(config, commands, skills, scopedSlug) {
     const lines = [];
     // Frontmatter
     lines.push('---');
-    lines.push(`name: ${config.name}`);
     lines.push(`description: ${config.description}`);
     lines.push('---');
     lines.push('');
     // Preamble
     lines.push((0, preamble_js_1.generatePreamble)(scopedSlug));
     lines.push('');
+    // Team header
+    lines.push(`## ${config.name}`);
+    lines.push('');
+    lines.push(`v${config.version} — ${scopedSlug}`);
+    lines.push('');
     // Skills
     if (skills.length > 0) {
-        lines.push('## 포함된 스킬');
+        lines.push('### 사용 가능한 스킬');
         lines.push('');
         for (const s of skills) {
             lines.push(`- **${s.name}**: ${s.description}`);
@@ -147,68 +155,17 @@ function generateRootSkillMd(config, commands, skills, scopedSlug) {
     }
     // Commands
     if (commands.length > 0) {
-        lines.push('## 포함된 커맨드');
+        lines.push('### 사용 가능한 커맨드');
         lines.push('');
         for (const c of commands) {
             lines.push(`- **/${c.name}**: ${c.description}`);
         }
         lines.push('');
     }
-    // Requires
-    const req = config.requires;
-    if (req) {
-        lines.push('## 요구사항');
-        lines.push('');
-        if (req.env && req.env.length > 0) {
-            lines.push('### 환경변수');
-            for (const e of req.env) {
-                const name = typeof e === 'string' ? e : e.name;
-                const desc = typeof e === 'string' ? '' : e.description ?? '';
-                const required = typeof e === 'string' ? true : e.required !== false;
-                lines.push(`- \`${name}\` ${required ? '(필수)' : '(선택)'}${desc ? ' — ' + desc : ''}`);
-            }
-            lines.push('');
-        }
-        if (req.cli && req.cli.length > 0) {
-            lines.push('### CLI 도구');
-            for (const c of req.cli) {
-                const install = c.install ? ` — 설치: \`${c.install}\`` : '';
-                lines.push(`- \`${c.name}\`${install}`);
-            }
-            lines.push('');
-        }
-        if (req.npm && req.npm.length > 0) {
-            lines.push('### npm 패키지');
-            for (const n of req.npm) {
-                const name = typeof n === 'string' ? n : n.name;
-                lines.push(`- \`${name}\``);
-            }
-            lines.push('');
-        }
-        if (req.mcp && req.mcp.length > 0) {
-            lines.push('### MCP 서버');
-            for (const m of req.mcp) {
-                const pkg = m.package ? ` (\`${m.package}\`)` : '';
-                lines.push(`- **${m.name}**${pkg}`);
-            }
-            lines.push('');
-        }
-        if (req.runtime) {
-            lines.push('### 런타임');
-            if (req.runtime.node)
-                lines.push(`- Node.js ${req.runtime.node}`);
-            if (req.runtime.python)
-                lines.push(`- Python ${req.runtime.python}`);
-            lines.push('');
-        }
-        if (req.teams && req.teams.length > 0) {
-            lines.push('### 의존 팀');
-            for (const t of req.teams) {
-                lines.push(`- \`${t}\``);
-            }
-            lines.push('');
-        }
-    }
+    lines.push('### 시작');
+    lines.push('');
+    lines.push('원하는 작업을 말하거나 위 커맨드를 직접 실행하세요.');
+    lines.push('');
     return lines.join('\n');
 }
 function countDir(teamDir, dirName) {
@@ -292,11 +249,8 @@ 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 root SKILL.md and GUIDE.html if they exist
+    // Include GUIDE.html if it exists (root SKILL.md is replaced by entry command)
     const entries = [...dirsToInclude];
-    if (fs_1.default.existsSync(path_1.default.join(teamDir, 'SKILL.md'))) {
-        entries.push('SKILL.md');
-    }
     if (fs_1.default.existsSync(path_1.default.join(teamDir, 'GUIDE.html'))) {
         entries.push('GUIDE.html');
     }
@@ -591,10 +545,19 @@ function registerPublish(program) {
                 console.error(`포트폴리오 이미지: ${portfolioEntries.length}개`);
             }
         }
-        // Generate root SKILL.md for skill discovery and update checks
+        // Generate bin/relay-preamble.sh (self-contained tracking + update check)
+        (0, preamble_js_1.generatePreambleBin)(relayDir, config.slug, config_js_1.API_URL);
+        // Generate entry command (commands/{author}-{name}.md)
         const detectedSkills = detectSkills(relayDir);
-        const rootSkillContent = generateRootSkillMd(config, detectedCommands, detectedSkills, config.slug);
-        fs_1.default.writeFileSync(path_1.default.join(relayDir, 'SKILL.md'), rootSkillContent);
+        const entryContent = generateEntryCommand(config, detectedCommands, detectedSkills, config.slug);
+        const commandsDir = path_1.default.join(relayDir, 'commands');
+        if (!fs_1.default.existsSync(commandsDir)) {
+            fs_1.default.mkdirSync(commandsDir, { recursive: true });
+        }
+        // slug: @alice/cardnews → alice-cardnews.md
+        const entrySlug = config.slug.startsWith('@') ? config.slug.slice(1) : config.slug;
+        const entryFileName = entrySlug.replace('/', '-') + '.md';
+        fs_1.default.writeFileSync(path_1.default.join(commandsDir, entryFileName), entryContent);
         let tarPath = null;
         try {
             tarPath = await createTarball(relayDir);
@@ -602,13 +565,14 @@ function registerPublish(program) {
                 console.error(`업로드 중...`);
             }
             const result = await publishToApi(token, tarPath, metadata, relayDir, portfolioEntries);
-            // Update local SKILL.md preamble with scoped slug from server (non-fatal)
+            // Update entry command preamble with scoped slug from server (non-fatal)
             try {
                 if (result.slug && result.slug !== config.slug) {
-                    const localSkillMd = path_1.default.join(relayDir, 'SKILL.md');
-                    if (fs_1.default.existsSync(localSkillMd)) {
+                    const serverSlug = result.slug.startsWith('@') ? result.slug.slice(1) : result.slug;
+                    const entryFile = path_1.default.join(relayDir, 'commands', serverSlug.replace('/', '-') + '.md');
+                    if (fs_1.default.existsSync(entryFile)) {
                         const { injectPreamble } = await import('../lib/preamble.js');
-                        injectPreamble(localSkillMd, result.slug);
+                        injectPreamble(entryFile, result.slug);
                     }
                 }
             }

package/dist/index.js

@@ -19,6 +19,7 @@ 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");
+const ping_js_1 = require("./commands/ping.js");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const pkg = require('../package.json');
 const program = new commander_1.Command();
@@ -44,4 +45,5 @@ program
 (0, join_js_1.registerJoin)(program);
 (0, spaces_js_1.registerSpaces)(program);
 (0, deploy_record_js_1.registerDeployRecord)(program);
+(0, ping_js_1.registerPing)(program);
 program.parse();

package/dist/lib/ai-tools.d.ts

@@ -12,3 +12,8 @@ export declare const AI_TOOLS: AITool[];
  * 프로젝트 디렉토리에서 에이전트 CLI 디렉토리를 감지한다.
  */
 export declare function detectAgentCLIs(projectPath: string): AITool[];
+/**
+ * 홈 디렉토리에서 글로벌 에이전트 CLI 디렉토리를 감지한다.
+ * ~/{skillsDir}/ 가 존재하는 CLI를 반환.
+ */
+export declare function detectGlobalCLIs(): AITool[];

package/dist/lib/ai-tools.js

@@ -5,7 +5,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AI_TOOLS = void 0;
 exports.detectAgentCLIs = detectAgentCLIs;
+exports.detectGlobalCLIs = detectGlobalCLIs;
 const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
 /**
  * Agent Skills 표준을 지원하는 에이전트 CLI 목록.
@@ -43,3 +45,11 @@ exports.AI_TOOLS = [
 function detectAgentCLIs(projectPath) {
     return exports.AI_TOOLS.filter((tool) => fs_1.default.existsSync(path_1.default.join(projectPath, tool.skillsDir)));
 }
+/**
+ * 홈 디렉토리에서 글로벌 에이전트 CLI 디렉토리를 감지한다.
+ * ~/{skillsDir}/ 가 존재하는 CLI를 반환.
+ */
+function detectGlobalCLIs() {
+    const home = path_1.default.join(os_1.default.homedir());
+    return exports.AI_TOOLS.filter((tool) => fs_1.default.existsSync(path_1.default.join(home, tool.skillsDir)));
+}

package/dist/lib/command-adapter.d.ts

@@ -15,14 +15,23 @@ export interface ToolCommandAdapter {
  */
 export declare function createAdapter(tool: AITool): ToolCommandAdapter;
 /**
- * 글로벌 슬래시 커맨드 파일 경로.
+ * 글로벌 슬래시 커맨드 파일 경로 (Claude Code 기본).
  * ~/.claude/commands/relay/{id}.md
  */
 export declare function getGlobalCommandPath(commandId: string): string;
 /**
- * 글로벌 슬래시 커맨드 디렉토리.
+ * 글로벌 슬래시 커맨드 디렉토리 (Claude Code 기본).
  */
 export declare function getGlobalCommandDir(): string;
+/**
+ * 특정 AI 도구의 글로벌 커맨드 디렉토리.
+ * ~/{skillsDir}/commands/relay/
+ */
+export declare function getGlobalCommandDirForTool(skillsDir: string): string;
+/**
+ * 특정 AI 도구의 글로벌 커맨드 파일 경로.
+ */
+export declare function getGlobalCommandPathForTool(skillsDir: string, commandId: string): string;
 /**
  * 커맨드 콘텐츠를 파일 형식으로 포맷.
  */