relayax-cli 0.4.30 → 0.4.32

package/dist/commands/install.js

@@ -209,7 +209,7 @@ function registerInstall(program) {
                 const detectedValues = new Set(detected.map((t) => t.value));
                 const { checkbox } = await import('@inquirer/prompts');
                 selectedTools = await checkbox({
-                    message: '설치할 AI 도구를 선택하��요 (감지된 도구는 자동 선���됨)',
+                    message: '설치할 AI 도구를 선택하세요 (감지된 도구는 자동 선택됨)',
                     choices: ai_tools_js_1.AI_TOOLS.map((t) => ({
                         name: t.name,
                         value: t,
@@ -237,12 +237,12 @@ function registerInstall(program) {
             }
             else if (interactive) {
                 const { select } = await import('@inquirer/prompts');
-                const recommendLabel = defaultScope === 'global' ? '글로벌' : '로���';
+                const recommendLabel = defaultScope === 'global' ? '글로벌' : '로컬';
                 scope = await select({
                     message: `설치 범위를 선택하세요 (제작자 권장: ${recommendLabel})`,
                     choices: [
-                        { name: '글로벌 (~/.relay/agents/) — 모든 프���젝트에서 사��', value: 'global' },
-                        { name: '로컬 (./.relay/agents/) — 이 프로젝트에서만 사���', value: 'local' },
+                        { name: '글로벌 (~/.relay/agents/) — 모든 프로젝트에서 사용', value: 'global' },
+                        { name: '로컬 (./.relay/agents/) — 이 프로젝트에서만 사용', value: 'local' },
                     ],
                     default: defaultScope,
                 });
@@ -371,29 +371,35 @@ function registerInstall(program) {
                 console.log(`  위치: \x1b[36m${agentDir}\x1b[0m`);
                 console.log(`  범위: ${scopeLabel}`);
                 console.log(`  파일: ${fileCount}개, symlink: ${deploy.symlinks.length}개`);
-                if (resolvedAgent.commands.length > 0) {
+                const userCommands = resolvedAgent.commands.filter((c) => !c.name.startsWith('setup-'));
+                if (userCommands.length > 0) {
                     console.log('\n  포함된 커맨드:');
-                    for (const cmd of resolvedAgent.commands) {
+                    for (const cmd of userCommands) {
                         console.log(`    \x1b[33m/${cmd.name}\x1b[0m - ${cmd.description}`);
                     }
                 }
-                // Usage hint (type-aware)
+                // Usage hint (type-aware, setup command 제외)
                 const agentType = resolvedAgent.type;
+                const mainCommand = userCommands[0];
                 if (agentType === 'passive') {
                     console.log(`\n\x1b[33m💡 자동 적용됩니다. 별도 실행 없이 동작합니다.\x1b[0m`);
                 }
-                else if (agentType === 'hybrid' && resolvedAgent.commands && resolvedAgent.commands.length > 0) {
-                    console.log(`\n\x1b[33m💡 자동 적용 + \x1b[1m/${resolvedAgent.commands[0].name}\x1b[0m\x1b[33m 으로 추가 기능을 사용할 수 있습니다.\x1b[0m`);
+                else if (agentType === 'hybrid' && mainCommand) {
+                    console.log(`\n\x1b[33m💡 자동 적용 + \x1b[1m/${mainCommand.name}\x1b[0m\x1b[33m 으로 추가 기능을 사용할 수 있습니다.\x1b[0m`);
                 }
-                else if (resolvedAgent.commands && resolvedAgent.commands.length > 0) {
-                    console.log(`\n\x1b[33m💡 사용법: \x1b[1m/${resolvedAgent.commands[0].name}\x1b[0m`);
+                else if (mainCommand) {
+                    console.log(`\n\x1b[33m💡 사용법: \x1b[1m/${mainCommand.name}\x1b[0m`);
                 }
                 else {
                     console.log(`\n\x1b[33m💡 설치 완료! AI 에이전트에서 사용할 수 있습니다.\x1b[0m`);
                 }
-                // Requires check
+                // Requires check + setup CTA
                 const requiresResults = (0, installer_js_1.checkRequires)(agentDir);
                 (0, installer_js_1.printRequiresCheck)(requiresResults);
+                const setupCmd = resolvedAgent.commands.find((c) => c.name.startsWith('setup-'));
+                if (setupCmd && requiresResults.some((r) => r.status === 'missing' || r.status === 'warn')) {
+                    console.log(`\n  \x1b[36m👉 설정이 필요합니다: \x1b[1m/${setupCmd.name}\x1b[0m\x1b[36m 을 실행하세요\x1b[0m`);
+                }
             }
         }
         catch (err) {

package/dist/commands/publish.js

@@ -15,6 +15,7 @@ const paths_js_1 = require("../lib/paths.js");
 const error_report_js_1 = require("../lib/error-report.js");
 const step_tracker_js_1 = require("../lib/step-tracker.js");
 const git_operations_js_1 = require("../lib/git-operations.js");
+const setup_command_js_1 = require("../lib/setup-command.js");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const cliPkg = require('../../package.json');
 const VALID_DIRS = ['skills', 'agents', 'rules', 'commands', 'bin'];
@@ -680,6 +681,19 @@ function registerPublish(program) {
                 console.error(`  → relay.yaml에 visibility: ${config.visibility} 저장됨 (${visLabelMap[config.visibility]})\n`);
             }
         }
+        // Generate setup command BEFORE detectCommands so it's included in metadata
+        {
+            const commandsDir = path_1.default.join(relayDir, 'commands');
+            if (!fs_1.default.existsSync(commandsDir)) {
+                fs_1.default.mkdirSync(commandsDir, { recursive: true });
+            }
+            const slugName = config.slug.split('/').pop() ?? config.name;
+            const setupContent = (0, setup_command_js_1.generateSetupCommand)(config.name, config.requires, slugName);
+            if (setupContent) {
+                const setupFileName = `setup-${slugName}.md`;
+                fs_1.default.writeFileSync(path_1.default.join(commandsDir, setupFileName), setupContent);
+            }
+        }
         const detectedCommands = detectCommands(relayDir);
         const components = {
             agents: countDir(relayDir, 'agents'),

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

@@ -0,0 +1,6 @@
+import type { Requires } from '../commands/publish.js';
+/**
+ * relay.yaml의 requires를 기반으로 setup slash command .md 내용을 생성한다.
+ * requires가 없거나 빈 객체이면 null을 반환한다.
+ */
+export declare function generateSetupCommand(agentName: string, requires: Requires | undefined, mainCommandName?: string): string | null;

package/dist/lib/setup-command.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateSetupCommand = generateSetupCommand;
+/**
+ * relay.yaml의 requires를 기반으로 setup slash command .md 내용을 생성한다.
+ * requires가 없거나 빈 객체이면 null을 반환한다.
+ */
+function generateSetupCommand(agentName, requires, mainCommandName) {
+    if (!requires)
+        return null;
+    const sections = [];
+    // runtime
+    if (requires.runtime) {
+        const items = [];
+        if (requires.runtime.node)
+            items.push(`- Node.js \`>=${requires.runtime.node}\``);
+        if (requires.runtime.python)
+            items.push(`- Python \`>=${requires.runtime.python}\``);
+        if (items.length > 0) {
+            sections.push(`### 런타임\n${items.join('\n')}`);
+        }
+    }
+    // cli
+    if (requires.cli && requires.cli.length > 0) {
+        const items = requires.cli.map((c) => {
+            const req = c.required !== false ? '필수' : '선택';
+            const install = c.install ? ` — 설치: \`${c.install}\`` : '';
+            return `- \`${c.name}\` (${req})${install}`;
+        });
+        sections.push(`### CLI 도구\n${items.join('\n')}`);
+    }
+    // env
+    if (requires.env && requires.env.length > 0) {
+        const items = requires.env.map((e) => {
+            const req = e.required !== false ? '필수' : '선택';
+            const desc = e.description ? ` — ${e.description}` : '';
+            const hint = e.setup_hint ? `\n  설정 방법:\n${e.setup_hint.split('\n').map((l) => `    ${l}`).join('\n')}` : '';
+            return `- \`${e.name}\` (${req})${desc}${hint}`;
+        });
+        sections.push(`### 환경변수\n${items.join('\n')}`);
+    }
+    // npm
+    if (requires.npm && requires.npm.length > 0) {
+        const items = requires.npm.map((n) => {
+            const name = typeof n === 'string' ? n : n.name;
+            const req = typeof n === 'string' ? '필수' : (n.required !== false ? '필수' : '선택');
+            return `- \`${name}\` (${req})`;
+        });
+        sections.push(`### npm 패키지\n${items.join('\n')}`);
+    }
+    // mcp
+    if (requires.mcp && requires.mcp.length > 0) {
+        const items = requires.mcp.map((m) => {
+            const req = m.required !== false ? '필수' : '선택';
+            const pkg = m.package ? ` — 패키지: \`${m.package}\`` : '';
+            const envList = m.env && m.env.length > 0 ? `\n  필요한 환경변수: ${m.env.map((e) => `\`${e}\``).join(', ')}` : '';
+            const config = m.config ? `\n  설정: \`${JSON.stringify(m.config)}\`` : '';
+            return `- \`${m.name}\` MCP 서버 (${req})${pkg}${envList}${config}`;
+        });
+        sections.push(`### MCP 서버\n${items.join('\n')}`);
+    }
+    if (sections.length === 0)
+        return null;
+    const body = `# ${agentName} 설정 가이드
+
+아래 요구사항을 각각 체크하고, 미충족 항목이 있으면 사용자가 설정할 수 있도록 안내하세요.
+모든 항목이 충족될 때까지 멈추지 말고 끝까지 진행하세요.
+${mainCommandName ? `\n모든 설정이 완료되면 \`/${mainCommandName}\`으로 에이전트를 사용할 수 있다고 안내하세요.` : ''}
+
+${sections.join('\n\n')}`;
+    return `---\ndescription: ${agentName} 설정 가이드 — 필수 요구사항을 확인하고 설정합니다\n---\n\n${body}\n`;
+}

package/package.json

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