relayax-cli 0.4.27 → 0.4.29

package/dist/commands/init.d.ts

@@ -1,5 +1,6 @@
 import { Command } from 'commander';
-export declare function installGlobalUserCommands(): {
+import { type AITool } from '../lib/ai-tools.js';
+export declare function installGlobalUserCommands(overrideTools?: AITool[]): {
     installed: boolean;
     commands: string[];
     tools: string[];
@@ -8,5 +9,5 @@ export declare function installGlobalUserCommands(): {
 /**
  * 글로벌 User 커맨드가 이미 설치되어 있는지 확인한다.
  */
-export declare function hasGlobalUserCommands(): boolean;
+export declare function hasGlobalUserCommands(overrideTools?: AITool[]): boolean;
 export declare function registerInit(program: Command): void;

package/dist/commands/init.js

@@ -44,8 +44,8 @@ const LEGACY_COMMANDS = {
     'relay-install': 'relay install (CLI) 또는 /relay-explore',
     'relay-publish': 'relay publish --patch (CLI) 또는 /relay-create',
 };
-function installGlobalUserCommands() {
-    const globalCLIs = (0, ai_tools_js_1.detectGlobalCLIs)();
+function installGlobalUserCommands(overrideTools) {
+    const globalCLIs = overrideTools ?? (0, ai_tools_js_1.detectGlobalCLIs)();
     const currentIds = new Set(command_adapter_js_1.USER_COMMANDS.map((c) => c.id));
     const commands = [];
     const tools = [];
@@ -77,7 +77,10 @@ function installGlobalUserCommands() {
 /**
  * 글로벌 User 커맨드가 이미 설치되어 있는지 확인한다.
  */
-function hasGlobalUserCommands() {
+function hasGlobalUserCommands(overrideTools) {
+    if (overrideTools) {
+        return overrideTools.every((tool) => command_adapter_js_1.USER_COMMANDS.every((cmd) => fs_1.default.existsSync((0, command_adapter_js_1.getGlobalCommandPathForTool)(tool.skillsDir, cmd.id))));
+    }
     return command_adapter_js_1.USER_COMMANDS.every((cmd) => fs_1.default.existsSync((0, command_adapter_js_1.getGlobalCommandPath)(cmd.id)));
 }
 function registerInit(program) {

package/dist/commands/install.js

@@ -18,6 +18,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 installer_js_1 = require("../lib/installer.js");
+const ai_tools_js_1 = require("../lib/ai-tools.js");
 function registerInstall(program) {
     program
         .command('install <slug>')
@@ -30,13 +31,6 @@ function registerInstall(program) {
         const json = program.opts().json ?? false;
         const projectPath = (0, paths_js_1.resolveProjectPath)(_opts.project);
         const tempDir = (0, storage_js_1.makeTempDir)();
-        // Auto-init: 글로벌 커맨드가 없으면 자동 설치
-        if (!(0, init_js_1.hasGlobalUserCommands)()) {
-            if (!json) {
-                console.error('\x1b[33m⚙ 글로벌 커맨드를 자동 설치합니다...\x1b[0m');
-            }
-            (0, init_js_1.installGlobalUserCommands)();
-        }
         (0, step_tracker_js_1.trackCommand)('install', { slug: slugInput });
         try {
             // Resolve scoped slug and fetch agent metadata
@@ -202,10 +196,61 @@ function registerInstall(program) {
                 throw new Error('에이전트 정보를 가져오지 못했습니다.');
             // Re-bind as non-optional so TypeScript tracks the narrowing through nested scopes
             let resolvedAgent = agent;
-            // Scope 자동결정: --global/--local 플래그 > recommended_scope > agent_type 기반
-            const scope = _opts.global ? 'global'
-                : _opts.local ? 'local'
-                    : resolvedAgent.recommended_scope ?? (resolvedAgent.type === 'passive' ? 'local' : 'global');
+            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, 나머지는 선택 가능 ──
+            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')) {
+                    detected.push({ name: 'Claude Code', value: 'claude', skillsDir: '.claude' });
+                }
+                const detectedValues = new Set(detected.map((t) => t.value));
+                const { checkbox } = await import('@inquirer/prompts');
+                selectedTools = await checkbox({
+                    message: '설치할 AI 도구를 선택하세요 (감지된 도구는 자동 선택됨)',
+                    choices: ai_tools_js_1.AI_TOOLS.map((t) => ({
+                        name: t.name,
+                        value: t,
+                        checked: detectedValues.has(t.value),
+                    })),
+                });
+            }
+            // ── init 통합: 선택된 tools에 글로벌 commands 설치 ──
+            if (selectedTools) {
+                (0, init_js_1.installGlobalUserCommands)(selectedTools);
+            }
+            else if (!(0, init_js_1.hasGlobalUserCommands)()) {
+                if (!json) {
+                    console.error('\x1b[33m⚙ 글로벌 커맨드를 자동 설치합니다...\x1b[0m');
+                }
+                (0, init_js_1.installGlobalUserCommands)();
+            }
             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);
@@ -256,7 +301,7 @@ function registerInstall(program) {
             // 4.5. Inject preamble (update check) into SKILL.md and commands
             (0, preamble_js_1.injectPreambleToAgent)(agentDir, slug);
             // 5. Deploy symlinks to detected AI tool directories
-            const deploy = (0, installer_js_1.deploySymlinks)(agentDir, scope, projectPath);
+            const deploy = await (0, installer_js_1.deploySymlinks)(agentDir, scope, projectPath, selectedTools);
             for (const w of deploy.warnings) {
                 if (!json)
                     console.error(`\x1b[33m${w}\x1b[0m`);

package/dist/commands/publish.d.ts

@@ -68,6 +68,7 @@ export interface PublishMetadata {
     requires?: Requires;
     visibility?: 'public' | 'private' | 'internal';
     type?: 'command' | 'passive' | 'hybrid';
+    recommended_scope?: 'global' | 'local';
     cli_version?: string;
     agent_names?: string[];
     skill_names?: string[];

package/dist/commands/publish.js

@@ -45,6 +45,7 @@ function parseRelayYaml(content) {
         requires,
         visibility,
         type,
+        recommended_scope: raw.recommended_scope === 'global' ? 'global' : raw.recommended_scope === 'local' ? 'local' : undefined,
         source: raw.source ? String(raw.source) : undefined,
         org_slug: raw.org_slug ? String(raw.org_slug) : undefined,
     };
@@ -268,6 +269,7 @@ function registerPublish(program) {
         .option('--token <token>', '인증 토큰')
         .option('--space <slug>', '배포할 Space 지정')
         .option('--org <slug>', 'Organization slug 지정')
+        .option('--no-org', '개인 계정으로 배포 (Organization 무시)')
         .option('--version <version>', '배포 버전 지정 (relay.yaml 업데이트)')
         .option('--patch', 'patch 버전 범프')
         .option('--minor', 'minor 버전 범프')
@@ -470,10 +472,18 @@ function registerPublish(program) {
         try {
             const { fetchMyOrgs } = await import('./orgs.js');
             const orgs = await fetchMyOrgs(token);
+            // --no-org: skip org selection entirely (personal deployment)
+            const skipOrg = opts.noOrg === true;
             // Determine explicit org slug: --org > --space (legacy) > relay.yaml org_slug
-            const explicitOrgSlug = opts.org ?? opts.space ?? config.org_slug;
+            const explicitOrgSlug = skipOrg ? undefined : (opts.org ?? opts.space ?? config.org_slug);
             // --org / --space / relay.yaml org_slug: resolve Org by slug
-            if (explicitOrgSlug) {
+            if (skipOrg) {
+                // Personal deployment — no org
+                if (!json) {
+                    console.error('\x1b[2m  개인 계정으로 배포합니다.\x1b[0m\n');
+                }
+            }
+            else if (explicitOrgSlug) {
                 const matched = orgs.find((o) => o.slug === explicitOrgSlug);
                 if (matched) {
                     selectedOrgId = matched.id;
@@ -528,18 +538,22 @@ function registerPublish(program) {
                     console.error(`  → Organization: ${chosenLabel}\n`);
                 }
             }
-            else if (orgs.length > 1 && json) {
-                // --json 모드 + 여러 Org: 에이전트가 선택할 수 있도록 에러 반환
-                (0, error_report_js_1.reportCliError)('publish', 'MISSING_ORG', 'multiple orgs, none selected');
+            else if (orgs.length > 0 && json) {
+                // --json 모드 + Org 있음: 에이전트가 선택할 수 있도록 에러 반환
+                (0, error_report_js_1.reportCliError)('publish', 'MISSING_ORG', `${orgs.length} orgs, none selected`);
                 console.error(JSON.stringify({
                     error: 'MISSING_ORG',
-                    message: '배포할 Organization을 선택하세요.',
-                    fix: `relay publish --org <slug> --json`,
-                    options: orgs.map((o) => ({ value: o.slug, label: `${o.name} (${o.slug})` })),
+                    message: '배포 대상을 선택하세요.',
+                    fix: `개인 배포: relay publish --no-org --json / Org 배포: relay publish --org <slug> --json`,
+                    options: [
+                        { value: '__personal__', label: '개인 계정으로 배포' },
+                        ...orgs.map((o) => ({ value: o.slug, label: `${o.name} (${o.slug})` })),
+                    ],
                 }));
                 process.exit(1);
             }
             else if (orgs.length > 0) {
+                // non-json, non-TTY fallback (rare) — auto-select first org
                 selectedOrgId = orgs[0].id;
                 selectedOrgSlug = orgs[0].slug;
             }
@@ -691,6 +705,7 @@ function registerPublish(program) {
             agent_names: listDir(relayDir, 'agents'),
             skill_names: listDir(relayDir, 'skills'),
             type: config.type ?? 'hybrid',
+            recommended_scope: config.recommended_scope,
             agent_details: detectedAgents,
             skill_details: detectedSkills,
             ...(selectedOrgId ? { org_id: selectedOrgId } : {}),

package/dist/commands/update.js

@@ -98,7 +98,7 @@ function registerUpdate(program) {
             // 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);
+            const deploy = await (0, installer_js_1.deploySymlinks)(agentDir, currentScope, projectPath);
             // Update installed.json
             const installRecord = {
                 agent_id: agent.id,

package/dist/lib/installer.d.ts

@@ -1,3 +1,4 @@
+import type { AITool } from './ai-tools.js';
 export interface DeployResult {
     symlinks: string[];
     warnings: string[];
@@ -11,7 +12,7 @@ export interface DeployResult {
  * @param scope     'global' | 'local'
  * @param projectPath  프로젝트 루트 경로 (local scope 시 사용)
  */
-export declare function deploySymlinks(agentDir: string, scope: 'global' | 'local', projectPath: string): DeployResult;
+export declare function deploySymlinks(agentDir: string, scope: 'global' | 'local', projectPath: string, overrideTools?: AITool[]): Promise<DeployResult>;
 /**
  * symlink 목록을 기반으로 symlink를 제거한다.
  */

package/dist/lib/installer.js

@@ -26,18 +26,31 @@ const SYMLINK_DIRS = ['skills', 'commands', 'agents', 'rules'];
  * @param scope     'global' | 'local'
  * @param projectPath  프로젝트 루트 경로 (local scope 시 사용)
  */
-function deploySymlinks(agentDir, scope, projectPath) {
+async function deploySymlinks(agentDir, scope, projectPath, overrideTools) {
     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) {
+    let tools;
+    if (overrideTools) {
+        tools = overrideTools;
+    }
+    else {
+        tools = scope === 'global'
+            ? (0, ai_tools_js_1.detectGlobalCLIs)()
+            : (0, ai_tools_js_1.detectAgentCLIs)(projectPath);
+        if (scope === 'global' && !tools.some((t) => t.value === 'claude')) {
             tools.push({ name: 'Claude Code', value: 'claude', skillsDir: '.claude' });
         }
+        if (scope === 'local' && tools.length === 0) {
+            if (process.stdout.isTTY) {
+                const { checkbox } = await import('@inquirer/prompts');
+                tools = await checkbox({
+                    message: `Select tools to set up (${ai_tools_js_1.AI_TOOLS.length} available)`,
+                    choices: ai_tools_js_1.AI_TOOLS.map((t) => ({ name: t.name, value: t })),
+                });
+            }
+            else {
+                tools = [{ name: 'Claude Code', value: 'claude', skillsDir: '.claude' }];
+            }
+        }
     }
     for (const tool of tools) {
         const baseDir = scope === 'global'
@@ -75,7 +88,8 @@ function deploySymlinks(agentDir, scope, projectPath) {
                         continue;
                     }
                 }
-                fs_1.default.symlinkSync(srcPath, destPath);
+                const relativeSrc = path_1.default.relative(path_1.default.dirname(destPath), srcPath);
+                fs_1.default.symlinkSync(relativeSrc, destPath);
                 result.symlinks.push(destPath);
             }
         }

package/dist/prompts/create.md

@@ -110,8 +110,17 @@ relay.yaml이 없으면 새로 만들고, 있으면 변경사항을 반영합니
 - name, slug, description, version, tags
 - requires (판단 결과)
 - org, visibility
+- **recommended_scope** — 설치 시 기본 배치 범위:
+  - `local` — rules/ 디렉토리가 있거나 프레임워크 특화 태그(nextjs, react, vue, angular, svelte, nuxt, remix, astro, django, rails, laravel, spring, express, fastapi, flask)가 있을 때
+  - `global` — 그 외 범용 도구
 
-**사용자에게 질문하여 최종 확인** 후 `relay publish --json`으로 배포합니다.
+**사용자에게 질문하여 최종 확인** 후 배포합니다.
+
+배포 명령어는 사용자의 선택에 따라 다릅니다:
+- **개인 배포**: `relay publish --no-org --json`
+- **Org 배포**: `relay publish --org {org_slug} --json`
+
+⚠️ `relay publish --json`만 실행하면 org 선택 에러가 발생합니다. 반드시 `--no-org` 또는 `--org`를 명시하세요.
 
 ---
 
@@ -140,7 +149,10 @@ relay.yaml이 없으면 새로 만들고, 있으면 변경사항을 반영합니
 ### 3. 배포
 
 변경 요약을 보여주고 **사용자에게 질문하여 최종 확인** 후 배포합니다.
-`relay publish --json`으로 배포합니다.
+
+배포 명령어는 사용자의 선택(또는 기존 relay.yaml 설정)에 따라:
+- **개인 배포**: `relay publish --no-org --json`
+- **Org 배포**: `relay publish --org {org_slug} --json`
 버전 범프가 필요하면 사용자에게 질문하여 patch/minor/major 중 확인합니다.
 
 ---

package/package.json

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