relayax-cli 0.4.29 → 0.4.31

package/dist/commands/install.js

@@ -199,35 +199,11 @@ function registerInstall(program) {
             const isTTY = Boolean(process.stdin.isTTY);
             const interactive = isTTY && !json;
             const defaultScope = resolvedAgent.recommended_scope ?? (resolvedAgent.type === 'passive' ? 'local' : 'global');
-            // ── Scope 결정: 플래그 > TTY prompt > 자동결정 ──
-            let scope;
-            if (_opts.global) {
-                scope = 'global';
-            }
-            else if (_opts.local) {
-                scope = 'local';
-            }
-            else if (interactive) {
-                const { select } = await import('@inquirer/prompts');
-                scope = await select({
-                    message: '설치 범위를 선택하세요',
-                    choices: [
-                        { name: '글로벌 (~/.relay/agents/) — 모든 프로젝트에서 사용', value: 'global' },
-                        { name: '로컬 (./.relay/agents/) — 이 프로젝트에서만 사용', value: 'local' },
-                    ],
-                    default: defaultScope,
-                });
-            }
-            else {
-                scope = defaultScope;
-            }
-            // ── AI tools 선택: 감지된 건 pre-checked, 나머지는 선택 가능 ──
+            // ── 1. AI tools 선택 (scope 무관, 항상 홈 디렉토리에서 감지) ──
             let selectedTools;
             if (interactive) {
-                const detected = scope === 'global'
-                    ? (0, ai_tools_js_1.detectGlobalCLIs)()
-                    : (0, ai_tools_js_1.detectAgentCLIs)(projectPath);
-                if (scope === 'global' && !detected.some((t) => t.value === 'claude')) {
+                const detected = (0, ai_tools_js_1.detectGlobalCLIs)();
+                if (!detected.some((t) => t.value === 'claude')) {
                     detected.push({ name: 'Claude Code', value: 'claude', skillsDir: '.claude' });
                 }
                 const detectedValues = new Set(detected.map((t) => t.value));
@@ -241,7 +217,7 @@ function registerInstall(program) {
                     })),
                 });
             }
-            // ── init 통합: 선택된 tools에 글로벌 commands 설치 ──
+            // ── 2. 글로벌 slash commands 설치/업데이트 ──
             if (selectedTools) {
                 (0, init_js_1.installGlobalUserCommands)(selectedTools);
             }
@@ -251,6 +227,29 @@ function registerInstall(program) {
                 }
                 (0, init_js_1.installGlobalUserCommands)();
             }
+            // ── 3. Scope 결정: 플래그 > TTY prompt > 자동결정 ──
+            let scope;
+            if (_opts.global) {
+                scope = 'global';
+            }
+            else if (_opts.local) {
+                scope = 'local';
+            }
+            else if (interactive) {
+                const { select } = await import('@inquirer/prompts');
+                const recommendLabel = defaultScope === 'global' ? '글로벌' : '로컬';
+                scope = await select({
+                    message: `설치 범위를 선택하세요 (제작자 권장: ${recommendLabel})`,
+                    choices: [
+                        { name: '글로벌 (~/.relay/agents/) — 모든 프로젝트에서 사용', value: 'global' },
+                        { name: '로컬 (./.relay/agents/) — 이 프로젝트에서만 사용', value: 'local' },
+                    ],
+                    default: defaultScope,
+                });
+            }
+            else {
+                scope = defaultScope;
+            }
             const agentDir = scope === 'global'
                 ? path_1.default.join(os_1.default.homedir(), '.relay', 'agents', parsed.owner, parsed.name)
                 : path_1.default.join(projectPath, '.relay', 'agents', parsed.owner, parsed.name);
@@ -372,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'];
@@ -726,6 +727,13 @@ function registerPublish(program) {
         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);
+        // Generate setup command if requires exist
+        const mainCmd = detectedCommands.find((c) => !c.name.startsWith('setup-'));
+        const setupContent = (0, setup_command_js_1.generateSetupCommand)(config.name, config.requires, mainCmd?.name);
+        if (setupContent) {
+            const setupFileName = `setup-${config.name}.md`;
+            fs_1.default.writeFileSync(path_1.default.join(commandsDir, setupFileName), setupContent);
+        }
         // Check git is available
         try {
             (0, git_operations_js_1.checkGitInstalled)();

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