relayax-cli 0.3.64 → 0.3.66

package/dist/commands/update.js

@@ -1,12 +1,19 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerUpdate = registerUpdate;
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
 const api_js_1 = require("../lib/api.js");
 const storage_js_1 = require("../lib/storage.js");
 const installer_js_1 = require("../lib/installer.js");
 const config_js_1 = require("../lib/config.js");
 const slug_js_1 = require("../lib/slug.js");
 const preamble_js_1 = require("../lib/preamble.js");
+const paths_js_1 = require("../lib/paths.js");
 function registerUpdate(program) {
     program
         .command('update <slug>')
@@ -15,11 +22,12 @@ function registerUpdate(program) {
         .option('--code <code>', '초대 코드 (비공개 에이전트 업데이트 시 필요)')
         .action(async (slugInput, opts) => {
         const json = program.opts().json ?? false;
-        const installPath = (0, config_js_1.getInstallPath)(opts.path);
         const tempDir = (0, storage_js_1.makeTempDir)();
+        const projectPath = (0, paths_js_1.resolveProjectPath)(opts.path);
         try {
-            // Resolve scoped slug (try installed.json first for offline, then server)
-            const installed = (0, config_js_1.loadInstalled)();
+            // Resolve scoped slug
+            const localInstalled = (0, config_js_1.loadInstalled)();
+            const globalInstalled = (0, config_js_1.loadGlobalInstalled)();
             let slug;
             if ((0, slug_js_1.isScopedSlug)(slugInput)) {
                 slug = slugInput;
@@ -28,9 +36,11 @@ function registerUpdate(program) {
                 const parsed = await (0, slug_js_1.resolveSlug)(slugInput);
                 slug = parsed.full;
             }
-            // Check installed.json for current version
-            const currentEntry = installed[slug];
+            // Find current entry (check both registries)
+            const currentEntry = localInstalled[slug] ?? globalInstalled[slug];
             const currentVersion = currentEntry?.version ?? null;
+            const currentScope = globalInstalled[slug] ? 'global'
+                : currentEntry?.deploy_scope ?? 'global';
             // Fetch latest agent metadata
             const agent = await (0, api_js_1.fetchAgentInfo)(slug);
             const latestVersion = agent.version;
@@ -52,39 +62,62 @@ function registerUpdate(program) {
                     process.exit(1);
                 }
             }
-            // Download package
+            // Clean up old symlinks (new) and deployed_files (legacy migration)
+            if (currentEntry?.deployed_symlinks && currentEntry.deployed_symlinks.length > 0) {
+                (0, installer_js_1.removeSymlinks)(currentEntry.deployed_symlinks);
+            }
+            if (currentEntry?.deployed_files && currentEntry.deployed_files.length > 0) {
+                (0, installer_js_1.uninstallAgent)(currentEntry.deployed_files);
+            }
+            // Determine agent directory
+            const parsedSlug = (0, slug_js_1.parseSlug)(slug);
+            const owner = parsedSlug?.owner ?? 'unknown';
+            const name = parsedSlug?.name ?? slug;
+            const agentDir = currentScope === 'global'
+                ? path_1.default.join(os_1.default.homedir(), '.relay', 'agents', owner, name)
+                : path_1.default.join(projectPath, '.relay', 'agents', owner, name);
+            // Download & extract
             const tarPath = await (0, storage_js_1.downloadPackage)(agent.package_url, tempDir);
-            // Extract
-            const extractDir = `${tempDir}/extracted`;
-            await (0, storage_js_1.extractPackage)(tarPath, extractDir);
-            // Inject preamble (update check) before copying
-            (0, preamble_js_1.injectPreambleToAgent)(extractDir, slug);
-            // Copy files to install_path
-            const files = (0, installer_js_1.installAgent)(extractDir, installPath);
-            // Preserve deploy info but clear deployed_files (agent needs to re-deploy)
-            const previousDeployScope = currentEntry?.deploy_scope;
-            const hadDeployedFiles = (currentEntry?.deployed_files?.length ?? 0) > 0;
-            // Update installed.json with new version
-            installed[slug] = {
+            if (fs_1.default.existsSync(agentDir)) {
+                fs_1.default.rmSync(agentDir, { recursive: true, force: true });
+            }
+            fs_1.default.mkdirSync(agentDir, { recursive: true });
+            await (0, storage_js_1.extractPackage)(tarPath, agentDir);
+            // Inject preamble
+            (0, preamble_js_1.injectPreambleToAgent)(agentDir, slug);
+            // Deploy symlinks (always — handles migration from legacy deployed_files)
+            const deploy = (0, installer_js_1.deploySymlinks)(agentDir, currentScope, projectPath);
+            // Update installed.json
+            const installRecord = {
                 agent_id: agent.id,
                 version: latestVersion,
                 installed_at: new Date().toISOString(),
-                files,
-                // Keep deploy_scope so agent knows where to re-deploy
-                ...(previousDeployScope ? { deploy_scope: previousDeployScope } : {}),
-                // Clear deployed_files — agent must re-deploy and call deploy-record
+                files: [agentDir],
+                deploy_scope: currentScope,
+                deployed_symlinks: deploy.symlinks,
             };
-            (0, config_js_1.saveInstalled)(installed);
-            // Report install (non-blocking, agent_id 기반)
+            if (currentScope === 'global') {
+                globalInstalled[slug] = installRecord;
+                (0, config_js_1.saveGlobalInstalled)(globalInstalled);
+                // Clean up local entry if migrating
+                if (localInstalled[slug]) {
+                    delete localInstalled[slug];
+                    (0, config_js_1.saveInstalled)(localInstalled);
+                }
+            }
+            else {
+                localInstalled[slug] = installRecord;
+                (0, config_js_1.saveInstalled)(localInstalled);
+            }
+            // Report
             await (0, api_js_1.reportInstall)(agent.id, slug, latestVersion);
             const result = {
                 status: 'updated',
                 slug,
                 from_version: currentVersion,
                 version: latestVersion,
-                files_installed: files.length,
-                install_path: installPath,
-                ...(hadDeployedFiles ? { needs_redeploy: true, previous_deploy_scope: previousDeployScope } : {}),
+                scope: currentScope,
+                symlinks: deploy.symlinks.length,
             };
             if (json) {
                 console.log(JSON.stringify(result));
@@ -92,9 +125,9 @@ function registerUpdate(program) {
             else {
                 const fromLabel = currentVersion ? `v${currentVersion} → ` : '';
                 console.log(`\n\x1b[32m✓ ${agent.name} ${fromLabel}v${latestVersion} 업데이트 완료\x1b[0m`);
-                console.log(`  설치 위치: \x1b[36m${installPath}\x1b[0m`);
-                console.log(`  파일 수:   ${files.length}개`);
-                // Show changelog for this version
+                console.log(`  위치: \x1b[36m${agentDir}\x1b[0m`);
+                console.log(`  symlink: ${deploy.symlinks.length}개`);
+                // Show changelog
                 try {
                     const versions = await (0, api_js_1.fetchAgentVersions)(slug);
                     const thisVersion = versions.find((v) => v.version === latestVersion);
@@ -107,8 +140,11 @@ function registerUpdate(program) {
                     }
                 }
                 catch {
-                    // Non-critical: skip changelog display
+                    // Non-critical
                 }
+                // Requires check
+                const requiresResults = (0, installer_js_1.checkRequires)(agentDir);
+                (0, installer_js_1.printRequiresCheck)(requiresResults);
             }
         }
         catch (err) {

package/dist/lib/command-adapter.js

@@ -90,14 +90,13 @@ function getGlobalCommandPathForTool(skillsDir, commandId) {
 function formatCommandFile(content) {
     return `---\ndescription: ${content.description}\n---\n\n${content.body}\n`;
 }
-// ─── 프롬프트 조각은 cli/src/prompts/*.md에서 관리 (SSOT) ───
-// REQUIREMENTS_CHECK, ERROR_HANDLING_GUIDE → import from '../prompts/index.js'
+// ─── 프롬프트는 cli/src/prompts/*.md에서 관리 (SSOT) ───
 // ─── User Commands (글로벌 설치) ───
 exports.USER_COMMANDS = [
     {
-        id: 'relay-install',
-        description: 'relay에서 에이전트를 설치합니다',
-        body: ENV_PREAMBLE + index_js_1.INSTALL_PROMPT,
+        id: 'relay-explore',
+        description: 'relay 마켓플레이스를 탐색하고 프로젝트에 맞는 에이전트를 찾습니다',
+        body: index_js_1.EXPLORE_PROMPT,
     },
     {
         id: 'relay-status',
@@ -162,7 +161,7 @@ ${index_js_1.ERROR_HANDLING_GUIDE}
 - \`--org <slug>\` 인자가 있으면: \`relay list --org <org-slug> --json\`으로 해당 Organization의 에이전트 목록도 보여줍니다.
 
 ### 4. 안내
-- 설치된 에이전트가 없으면 \`/relay-install\`로 에이전트를 탐색·설치해보라고 안내합니다.
+- 설치된 에이전트가 없으면 \`/relay-explore\`로 에이전트를 탐색해보라고 안내합니다.
 - Org가 있으면 활용법을 안내합니다:
   - Org 에이전트 설치: \`relay install @<org-slug>/<agent>\`
   - Org 관리: www.relayax.com/orgs/<slug>
@@ -210,9 +209,9 @@ ${index_js_1.ERROR_HANDLING_GUIDE}
 → "✓ @alice/doc-writer 삭제 완료 (12개 파일 제거)"`,
     },
     {
-        id: 'relay-publish',
-        description: '현재 에이전트 패키지를 relay에 배포합니다',
-        body: ENV_PREAMBLE + index_js_1.PUBLISH_PROMPT,
+        id: 'relay-create',
+        description: '에이전트 패키지를 새로 만들어 relay에 배포합니다',
+        body: index_js_1.CREATE_PROMPT,
     },
 ];
 // ─── Builder Commands (로컬 설치) ───

package/dist/lib/guide.d.ts

@@ -8,6 +8,5 @@ export declare function generateGuide(config: {
     name: string;
     description: string;
     version: string;
-    visibility?: string;
 }, commands: CommandEntry[], requires?: Requires): string;
 export {};

package/dist/lib/guide.js

@@ -1,101 +1,51 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateGuide = generateGuide;
-const index_js_1 = require("../prompts/index.js");
-function buildSetupSection(needsLogin) {
-    if (!needsLogin)
-        return index_js_1.SETUP_CLI;
-    return `${index_js_1.SETUP_CLI}\n\n${index_js_1.SETUP_LOGIN}`;
-}
 function buildRequiresSummary(requires) {
     const lines = [];
-    if (requires.cli && requires.cli.length > 0) {
-        for (const cli of requires.cli) {
-            const label = cli.required === false ? '선택' : '필수';
-            lines.push(`- cli: **${cli.name}** (${label})${cli.install ? ` — \`${cli.install}\`` : ''}`);
-        }
+    for (const cli of requires.cli ?? []) {
+        const label = cli.required === false ? '선택' : '필수';
+        lines.push(`- cli: **${cli.name}** (${label})${cli.install ? ` — \`${cli.install}\`` : ''}`);
     }
     if (requires.npm && requires.npm.length > 0) {
-        const pkgNames = requires.npm.map((p) => typeof p === 'string' ? p : p.name);
-        lines.push(`- npm: ${pkgNames.map((n) => `**${n}**`).join(', ')}`);
-    }
-    if (requires.env && requires.env.length > 0) {
-        for (const env of requires.env) {
-            const label = env.required === false ? '선택' : '필수';
-            const desc = env.description ? ` — ${env.description}` : '';
-            lines.push(`- env: **${env.name}** (${label})${desc}`);
-        }
+        const names = requires.npm.map((p) => typeof p === 'string' ? p : p.name);
+        lines.push(`- npm: ${names.map((n) => `**${n}**`).join(', ')}`);
     }
-    if (requires.mcp && requires.mcp.length > 0) {
-        for (const mcp of requires.mcp) {
-            const pkg = mcp.package ? ` — \`${mcp.package}\`` : '';
-            lines.push(`- mcp: **${mcp.name}**${pkg}`);
-        }
+    for (const env of requires.env ?? []) {
+        const label = env.required === false ? '선택' : '필수';
+        const desc = env.description ? ` — ${env.description}` : '';
+        lines.push(`- env: **${env.name}** (${label})${desc}`);
     }
-    if (requires.agents && requires.agents.length > 0) {
-        for (const agent of requires.agents) {
-            lines.push(`- agents: **${agent}**`);
-        }
+    for (const mcp of requires.mcp ?? []) {
+        const pkg = mcp.package ? ` — \`${mcp.package}\`` : '';
+        lines.push(`- mcp: **${mcp.name}**${pkg}`);
     }
-    if (requires.permissions && requires.permissions.length > 0) {
-        lines.push(`- permissions: ${requires.permissions.map((p) => `\`${p}\``).join(', ')}`);
+    for (const agent of requires.agents ?? []) {
+        lines.push(`- agent: **${agent}**`);
     }
     return lines.join('\n');
 }
-function buildRequiresSection(requires) {
-    const summary = buildRequiresSummary(requires);
-    if (!summary)
-        return '';
-    return `## Step 4. 의존성 확인 및 설치
-
-이 에이전트는 아래 의존성이 필요합니다:
-
-${summary}
-
-${index_js_1.REQUIREMENTS_CHECK}
-`;
-}
 function generateGuide(config, commands, requires) {
     const scopedSlug = config.slug.startsWith('@') ? config.slug : `@${config.slug}`;
-    const needsLogin = config.visibility === 'internal' || config.visibility === 'private';
-    const setupSection = buildSetupSection(needsLogin);
-    const installStepNum = needsLogin ? 3 : 2;
-    const requiresSection = requires ? buildRequiresSection(requires) : '';
-    const requiresSectionFinal = requiresSection
-        ? requiresSection.replace('## Step 4.', `## Step ${installStepNum + 1}.`)
-        : '';
-    let usageHint = '';
-    if (commands.length > 0) {
-        usageHint = `## 사용법
-
-설치가 완료되면 아래 커맨드를 사용할 수 있습니다:
-
-${commands.map((cmd) => `- \`/${cmd.name}\`: ${cmd.description}`).join('\n')}
-
-원하는 작업을 말하거나 위 커맨드를 직접 실행하세요.
-`;
-    }
-    return `# ${config.name} — 설치 가이드
+    const installCmd = `npx relayax-cli install ${scopedSlug}`;
+    const requiresSummary = requires ? buildRequiresSummary(requires) : '';
+    return `# ${config.name}
 
 > ${config.description}
 
-이 가이드는 Relay 에이전트를 설치하는 절차입니다.
-각 Step의 명령어를 순서대로 실행하세요. 요약하지 말고 바로 Step 0(환경 감지)부터 시작하세요.
-
-${index_js_1.SETUP_ENVIRONMENT}
+## 설치
 
-${setupSection}
+\`\`\`bash
+${installCmd}
+\`\`\`
 
-## Step ${installStepNum}. 에이전트 설치
+${commands.length > 0 ? `## 포함된 커맨드
 
-감지된 환경에 맞게 실행하세요:
-- 환경 A (터미널): \`relay install ${scopedSlug}\`
-- 환경 B (샌드박스): \`npx relayax-cli install ${scopedSlug}\`
-
-설치 후 아래 의존성을 확인하고 환경을 구성합니다.
+${commands.map((cmd) => `- \`/${cmd.name}\`: ${cmd.description}`).join('\n')}
+` : ''}${requiresSummary ? `## 요구사항
 
-${requiresSectionFinal}${usageHint}---
-*출처: https://relayax.com — Agent Marketplace*
-*설치: \`relay install ${scopedSlug}\`*
+${requiresSummary}
+` : ''}---
+*https://relayax.com — Agent Marketplace*
 `;
 }

package/dist/lib/installer.d.ts

@@ -1,3 +1,34 @@
+export interface DeployResult {
+    symlinks: string[];
+    warnings: string[];
+}
+/**
+ * agentDir 내 skills/, commands/, agents/, rules/ 하위 항목을
+ * 감지된 AI tool의 skillsDir에 symlink로 생성한다.
+ *
+ * @param agentDir  .relay/agents/<owner>/<name>/ 경로
+ * @param slug      @owner/name 형태
+ * @param scope     'global' | 'local'
+ * @param projectPath  프로젝트 루트 경로 (local scope 시 사용)
+ */
+export declare function deploySymlinks(agentDir: string, scope: 'global' | 'local', projectPath: string): DeployResult;
+/**
+ * symlink 목록을 기반으로 symlink를 제거한다.
+ */
+export declare function removeSymlinks(symlinks: string[]): string[];
+interface RequiresCheckResult {
+    label: string;
+    status: 'ok' | 'warn' | 'missing';
+    message: string;
+}
+/**
+ * agentDir의 relay.yaml에서 requires를 읽고 체크 결과를 반환한다.
+ */
+export declare function checkRequires(agentDir: string): RequiresCheckResult[];
+/**
+ * requires 체크 결과를 콘솔에 출력한다.
+ */
+export declare function printRequiresCheck(results: RequiresCheckResult[]): void;
 export declare function installAgent(extractedDir: string, installPath: string): string[];
 export declare function uninstallAgent(files: string[]): string[];
 /**
@@ -5,3 +36,4 @@ export declare function uninstallAgent(files: string[]): string[];
  * 예: /home/.claude/skills/cardnews/ 가 비었으면 삭제, /home/.claude/skills/는 유지
  */
 export declare function cleanEmptyParents(filePath: string, boundary: string): void;
+export {};

package/dist/lib/installer.js

@@ -3,12 +3,277 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.deploySymlinks = deploySymlinks;
+exports.removeSymlinks = removeSymlinks;
+exports.checkRequires = checkRequires;
+exports.printRequiresCheck = printRequiresCheck;
 exports.installAgent = installAgent;
 exports.uninstallAgent = uninstallAgent;
 exports.cleanEmptyParents = cleanEmptyParents;
 const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
+const child_process_1 = require("child_process");
+const ai_tools_js_1 = require("./ai-tools.js");
 const COPY_DIRS = ['skills', 'agents', 'rules', 'commands'];
+const SYMLINK_DIRS = ['skills', 'commands', 'agents', 'rules'];
+/**
+ * agentDir 내 skills/, commands/, agents/, rules/ 하위 항목을
+ * 감지된 AI tool의 skillsDir에 symlink로 생성한다.
+ *
+ * @param agentDir  .relay/agents/<owner>/<name>/ 경로
+ * @param slug      @owner/name 형태
+ * @param scope     'global' | 'local'
+ * @param projectPath  프로젝트 루트 경로 (local scope 시 사용)
+ */
+function deploySymlinks(agentDir, scope, projectPath) {
+    const result = { symlinks: [], warnings: [] };
+    // 감지된 AI tool 목록
+    const tools = scope === 'global'
+        ? (0, ai_tools_js_1.detectGlobalCLIs)()
+        : (0, ai_tools_js_1.detectAgentCLIs)(projectPath);
+    // Claude Code를 기본으로 포함 (글로벌에 .claude/가 없어도 생성)
+    if (scope === 'global') {
+        const hasClaudeCode = tools.some((t) => t.value === 'claude');
+        if (!hasClaudeCode) {
+            tools.push({ name: 'Claude Code', value: 'claude', skillsDir: '.claude' });
+        }
+    }
+    for (const tool of tools) {
+        const baseDir = scope === 'global'
+            ? path_1.default.join(os_1.default.homedir(), tool.skillsDir)
+            : path_1.default.join(projectPath, tool.skillsDir);
+        for (const dir of SYMLINK_DIRS) {
+            const srcDir = path_1.default.join(agentDir, dir);
+            if (!fs_1.default.existsSync(srcDir))
+                continue;
+            const entries = fs_1.default.readdirSync(srcDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.name.startsWith('.'))
+                    continue;
+                const srcPath = path_1.default.join(srcDir, entry.name);
+                const destDir = path_1.default.join(baseDir, dir);
+                const destPath = path_1.default.join(destDir, entry.name);
+                // 대상 디렉토리 생성
+                fs_1.default.mkdirSync(destDir, { recursive: true });
+                // 충돌 처리
+                if (fs_1.default.existsSync(destPath) || isSymlink(destPath)) {
+                    if (isSymlink(destPath)) {
+                        const existingTarget = fs_1.default.readlinkSync(destPath);
+                        if (!existingTarget.includes('.relay/agents/') || existingTarget.startsWith(agentDir)) {
+                            // 같은 에이전트 또는 relay가 아닌 symlink → 조용히 교체
+                        }
+                        else {
+                            // 다른 에이전트의 symlink → 경고
+                            result.warnings.push(`⚠ ${dir}/${entry.name} 가 다른 에이전트에서 교체됩니다`);
+                        }
+                        fs_1.default.unlinkSync(destPath);
+                    }
+                    else {
+                        // 일반 파일/디렉토리 → 보호, 건너뜀
+                        result.warnings.push(`⚠ ${destPath} 는 사용자 파일이므로 건너뜁니다`);
+                        continue;
+                    }
+                }
+                fs_1.default.symlinkSync(srcPath, destPath);
+                result.symlinks.push(destPath);
+            }
+        }
+    }
+    return result;
+}
+function isSymlink(p) {
+    try {
+        return fs_1.default.lstatSync(p).isSymbolicLink();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * symlink 목록을 기반으로 symlink를 제거한다.
+ */
+function removeSymlinks(symlinks) {
+    const removed = [];
+    for (const link of symlinks) {
+        try {
+            if (isSymlink(link)) {
+                fs_1.default.unlinkSync(link);
+                removed.push(link);
+            }
+            else if (fs_1.default.existsSync(link)) {
+                // symlink이 아닌 파일이면 건너뜀 (사용자 파일 보호)
+            }
+        }
+        catch {
+            // best-effort
+        }
+    }
+    return removed;
+}
+/**
+ * agentDir의 relay.yaml에서 requires를 읽고 체크 결과를 반환한다.
+ */
+function checkRequires(agentDir) {
+    const results = [];
+    const yamlPath = path_1.default.join(agentDir, 'relay.yaml');
+    if (!fs_1.default.existsSync(yamlPath))
+        return results;
+    let requires;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const yaml = require('js-yaml');
+        const raw = yaml.load(fs_1.default.readFileSync(yamlPath, 'utf-8'));
+        requires = (raw?.requires ?? undefined);
+    }
+    catch {
+        return results;
+    }
+    if (!requires)
+        return results;
+    // runtime
+    if (requires.runtime?.node) {
+        const ver = getCommandOutput('node --version');
+        if (ver) {
+            const clean = ver.replace(/^v/, '');
+            const required = requires.runtime.node.replace(/^>=?\s*/, '');
+            const ok = compareVersions(clean, required) >= 0;
+            results.push({
+                label: 'runtime',
+                status: ok ? 'ok' : 'warn',
+                message: ok
+                    ? `Node.js >=${required} — ${ver} 확인됨`
+                    : `Node.js >=${required} — ${ver} (업그레이드 필요)`,
+            });
+        }
+    }
+    if (requires.runtime?.python) {
+        const ver = getCommandOutput('python3 --version');
+        if (ver) {
+            const clean = ver.replace(/^Python\s*/, '');
+            const required = requires.runtime.python.replace(/^>=?\s*/, '');
+            const ok = compareVersions(clean, required) >= 0;
+            results.push({
+                label: 'runtime',
+                status: ok ? 'ok' : 'warn',
+                message: ok
+                    ? `Python >=${required} — ${clean} 확인됨`
+                    : `Python >=${required} — ${clean} (업그레이드 필요)`,
+            });
+        }
+    }
+    // cli
+    if (requires.cli) {
+        for (const cli of requires.cli) {
+            if (!isSafeName(cli.name))
+                continue;
+            const found = getCommandOutput('which', [cli.name]);
+            if (found) {
+                results.push({ label: 'cli', status: 'ok', message: `${cli.name} — 설치됨` });
+            }
+            else {
+                const installHint = cli.install ? ` → ${cli.install}` : '';
+                results.push({
+                    label: 'cli',
+                    status: cli.required !== false ? 'missing' : 'warn',
+                    message: `${cli.name} — 미설치${installHint}`,
+                });
+            }
+        }
+    }
+    // env
+    if (requires.env) {
+        for (const env of requires.env) {
+            const val = process.env[env.name];
+            if (val) {
+                results.push({ label: 'env', status: 'ok', message: `${env.name} — 설정됨` });
+            }
+            else {
+                const desc = env.description ? ` (${env.description})` : '';
+                results.push({
+                    label: 'env',
+                    status: env.required !== false ? 'missing' : 'warn',
+                    message: `${env.name} — 미설정${desc}`,
+                });
+            }
+        }
+    }
+    // npm
+    if (requires.npm) {
+        for (const pkg of requires.npm) {
+            const name = typeof pkg === 'string' ? pkg : pkg.name;
+            const isRequired = typeof pkg === 'string' ? true : pkg.required !== false;
+            if (!isSafeName(name))
+                continue;
+            const found = getCommandOutput('npm', ['list', name]);
+            const installed = found ? !found.includes('(empty)') && !found.includes('ERR') : false;
+            if (installed) {
+                results.push({ label: 'npm', status: 'ok', message: `${name} — 설치됨` });
+            }
+            else {
+                results.push({
+                    label: 'npm',
+                    status: isRequired ? 'missing' : 'warn',
+                    message: `${name} — 미설치`,
+                });
+            }
+        }
+    }
+    // mcp
+    if (requires.mcp) {
+        for (const mcp of requires.mcp) {
+            const configStr = mcp.config
+                ? JSON.stringify(mcp.config, null, 2)
+                : mcp.package ?? mcp.name;
+            results.push({
+                label: 'mcp',
+                status: 'warn',
+                message: `${mcp.name} MCP — 설정 필요: ${configStr}`,
+            });
+        }
+    }
+    return results;
+}
+/**
+ * requires 체크 결과를 콘솔에 출력한다.
+ */
+function printRequiresCheck(results) {
+    if (results.length === 0)
+        return;
+    console.log('\n\x1b[1m📋 Requirements\x1b[0m');
+    for (const r of results) {
+        const icon = r.status === 'ok' ? '✅' : r.status === 'warn' ? '⚠️ ' : '❌';
+        console.log(`  ${icon} ${r.message}`);
+    }
+    const hasMissing = results.some((r) => r.status === 'missing');
+    if (hasMissing) {
+        console.log('\n  \x1b[33m⚠️  필수 요구사항이 충족되지 않았습니다. 에이전트 기능이 제한될 수 있습니다.\x1b[0m');
+    }
+}
+function getCommandOutput(cmd, args = []) {
+    try {
+        const full = args.length > 0 ? `${cmd} ${args.map(a => `'${a.replace(/'/g, "'\\''")}'`).join(' ')}` : cmd;
+        return (0, child_process_1.execSync)(full, { encoding: 'utf-8', timeout: 5000 }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+/** relay.yaml에서 온 이름이 안전한 식별자인지 확인 */
+function isSafeName(name) {
+    return /^[a-zA-Z0-9._@/-]+$/.test(name);
+}
+function compareVersions(a, b) {
+    const pa = a.split('.').map(Number);
+    const pb = b.split('.').map(Number);
+    for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const na = pa[i] ?? 0;
+        const nb = pb[i] ?? 0;
+        if (na !== nb)
+            return na - nb;
+    }
+    return 0;
+}
 function copyDirRecursive(src, dest) {
     const copiedFiles = [];
     if (!fs_1.default.existsSync(src))