relayax-cli 0.4.26 → 0.4.28

package/dist/commands/install.js

@@ -256,7 +256,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);
             for (const w of deploy.warnings) {
                 if (!json)
                     console.error(`\x1b[33m${w}\x1b[0m`);

package/dist/commands/package.js

@@ -315,18 +315,6 @@ function registerPackage(program) {
                     });
                 }
             }
-            // 마운트 경로 스캔 (Cowork/sandbox 환경)
-            for (const { tool, basePath } of (0, ai_tools_js_1.detectMountedCLIs)()) {
-                const items = (0, ai_tools_js_1.scanMountedItems)(basePath, tool);
-                if (items.length > 0) {
-                    sources.push({
-                        path: `${basePath}/${tool.skillsDir}`,
-                        location: 'global',
-                        name: `${tool.name} (mounted)`,
-                        items,
-                    });
-                }
-            }
             // ~/.relay/agents/ 에 기존 에이전트 패키지가 있는지 스캔
             const globalAgentsDir = path_1.default.join(homeDir ?? os_1.default.homedir(), '.relay', 'agents');
             const existingAgents = [];

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

@@ -15,7 +15,6 @@ 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");
-// GUIDE_INSTRUCTION removed — share text now uses npx install command directly
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const cliPkg = require('../../package.json');
 const VALID_DIRS = ['skills', 'agents', 'rules', 'commands', 'bin'];
@@ -46,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,
     };
@@ -269,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 버전 범프')
@@ -471,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;
@@ -529,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;
             }
@@ -692,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 } : {}),
@@ -700,12 +714,6 @@ function registerPublish(program) {
         if (!json) {
             console.error(`패키지 생성 중... (${config.name} v${config.version})`);
         }
-        // GUIDE.html deprecation warning
-        if (fs_1.default.existsSync(path_1.default.join(relayDir, 'GUIDE.html'))) {
-            console.error('\x1b[33m⚠ GUIDE.html은 더 이상 지원되지 않습니다. 상세페이지가 가이드 역할을 합니다.\x1b[0m');
-            console.error('  long_description을 활용하거나 relayax.com에서 에이전트 정보를 편집하세요.\n');
-        }
-        // guide.md는 웹 API route에서 동적 생성 (/api/registry/{owner}/{slug}/guide.md)
         // 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)

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/ai-tools.d.ts

@@ -12,18 +12,6 @@ export declare const AI_TOOLS: AITool[];
  * 프로젝트 디렉토리에서 에이전트 CLI 디렉토리를 감지한다.
  */
 export declare function detectAgentCLIs(projectPath: string): AITool[];
-/**
- * Cowork/sandbox 환경의 마운트 경로 후보를 반환한다.
- * /sessions/<id>/mnt/ 같은 경로에 실제 파일이 마운트됨.
- */
-export declare function detectMountPaths(): string[];
-/**
- * 마운트 경로에서 에이전트 CLI 디렉토리를 감지한다.
- */
-export declare function detectMountedCLIs(): {
-    tool: AITool;
-    basePath: string;
-}[];
 /**
  * 홈 디렉토리에서 글로벌 에이전트 CLI 디렉토리를 감지한다.
  * ~/{skillsDir}/ 가 존재하는 CLI를 반환.
@@ -44,7 +32,3 @@ export declare function scanLocalItems(projectPath: string, tool: AITool): Conte
  * 글로벌 홈 디렉토리 소스의 개별 스킬/에이전트/커맨드/룰 항목을 반환한다.
  */
 export declare function scanGlobalItems(tool: AITool, home?: string): ContentItem[];
-/**
- * 마운트 경로의 개별 스킬/에이전트/커맨드/룰 항목을 반환한다.
- */
-export declare function scanMountedItems(basePath: string, tool: AITool): ContentItem[];

package/dist/lib/ai-tools.js

@@ -5,12 +5,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AI_TOOLS = void 0;
 exports.detectAgentCLIs = detectAgentCLIs;
-exports.detectMountPaths = detectMountPaths;
-exports.detectMountedCLIs = detectMountedCLIs;
 exports.detectGlobalCLIs = detectGlobalCLIs;
 exports.scanLocalItems = scanLocalItems;
 exports.scanGlobalItems = scanGlobalItems;
-exports.scanMountedItems = scanMountedItems;
 const fs_1 = __importDefault(require("fs"));
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
@@ -52,31 +49,6 @@ exports.AI_TOOLS = [
 function detectAgentCLIs(projectPath) {
     return exports.AI_TOOLS.filter((tool) => fs_1.default.existsSync(path_1.default.join(projectPath, tool.skillsDir)));
 }
-/**
- * Cowork/sandbox 환경의 마운트 경로 후보를 반환한다.
- * /sessions/<id>/mnt/ 같은 경로에 실제 파일이 마운트됨.
- */
-function detectMountPaths() {
-    const home = os_1.default.homedir();
-    const mntPath = path_1.default.join(home, 'mnt');
-    if (!fs_1.default.existsSync(mntPath))
-        return [];
-    return [mntPath];
-}
-/**
- * 마운트 경로에서 에이전트 CLI 디렉토리를 감지한다.
- */
-function detectMountedCLIs() {
-    const results = [];
-    for (const mnt of detectMountPaths()) {
-        for (const tool of exports.AI_TOOLS) {
-            if (fs_1.default.existsSync(path_1.default.join(mnt, tool.skillsDir))) {
-                results.push({ tool, basePath: mnt });
-            }
-        }
-    }
-    return results;
-}
 /**
  * 홈 디렉토리에서 글로벌 에이전트 CLI 디렉토리를 감지한다.
  * ~/{skillsDir}/ 가 존재하는 CLI를 반환.
@@ -130,9 +102,3 @@ function scanGlobalItems(tool, home) {
     const basePath = path_1.default.join(home ?? os_1.default.homedir(), tool.skillsDir);
     return scanItemsIn(basePath);
 }
-/**
- * 마운트 경로의 개별 스킬/에이전트/커맨드/룰 항목을 반환한다.
- */
-function scanMountedItems(basePath, tool) {
-    return scanItemsIn(path_1.default.join(basePath, tool.skillsDir));
-}

package/dist/lib/installer.d.ts

@@ -11,7 +11,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): Promise<DeployResult>;
 /**
  * symlink 목록을 기반으로 symlink를 제거한다.
  */

package/dist/lib/installer.js

@@ -26,19 +26,34 @@ 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) {
     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/가 없어도 생성)
+    // 글로벌: Claude Code를 기본으로 포함
     if (scope === 'global') {
         const hasClaudeCode = tools.some((t) => t.value === 'claude');
         if (!hasClaudeCode) {
             tools.push({ name: 'Claude Code', value: 'claude', skillsDir: '.claude' });
         }
     }
+    // 로컬: AI tool 디렉토리가 없으면 TTY에서 선택
+    if (scope === 'local' && tools.length === 0) {
+        if (process.stdout.isTTY) {
+            const { checkbox } = await import('@inquirer/prompts');
+            const selected = 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 })),
+            });
+            tools.push(...selected);
+        }
+        else {
+            // Non-TTY (JSON 모드 등): Claude Code 기본
+            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)
@@ -75,7 +90,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/lib/preamble.d.ts

@@ -1,8 +1,8 @@
 /**
  * bin/relay-preamble.sh 스크립트를 생성한다.
- * relay CLI가 있으면 사용, 없으면 curl fallback.
+ * bash 실행 가능 환경을 전제로, relay CLI를 직접 호출한다.
  */
-export declare function generatePreambleScript(slug: string, apiUrl: string): string;
+export declare function generatePreambleScript(slug: string, _apiUrl: string): string;
 /**
  * SKILL.md / command에 삽입할 preamble 마크다운.
  * agentDir: 설치된 에이전트의 절대 경로 (install 시점에 결정)

package/dist/lib/preamble.js

@@ -14,54 +14,16 @@ const PREAMBLE_START = '<!-- RELAY_PREAMBLE_START - DO NOT EDIT -->';
 const PREAMBLE_END = '<!-- RELAY_PREAMBLE_END -->';
 /**
  * bin/relay-preamble.sh 스크립트를 생성한다.
- * relay CLI가 있으면 사용, 없으면 curl fallback.
+ * bash 실행 가능 환경을 전제로, relay CLI를 직접 호출한다.
  */
-function generatePreambleScript(slug, apiUrl) {
-    // slug format: @owner/agent → extract agent slug for ping
-    const stripped = slug.startsWith('@') ? slug.slice(1) : slug;
-    const slashIdx = stripped.indexOf('/');
-    const agentSlug = slashIdx !== -1 ? stripped.slice(slashIdx + 1) : stripped;
+function generatePreambleScript(slug, _apiUrl) {
     return `#!/usr/bin/env bash
 # relay-preamble.sh — auto-generated by relay publish
 set +e
 
-# Device hash (shasum → sha256sum → openssl fallback)
-_RAW="$(hostname):$(whoami)"
-if command -v shasum &>/dev/null; then
-  DEVICE_HASH=$(printf '%s' "$_RAW" | shasum -a 256 | cut -d' ' -f1)
-elif command -v sha256sum &>/dev/null; then
-  DEVICE_HASH=$(printf '%s' "$_RAW" | sha256sum | cut -d' ' -f1)
-elif command -v openssl &>/dev/null; then
-  DEVICE_HASH=$(printf '%s' "$_RAW" | openssl dgst -sha256 | awk '{print $NF}')
-else
-  DEVICE_HASH="unknown"
-fi
-
-# Read relay token (for user identification in usage ping)
-_RELAY_TOKEN=""
-if [ -f "$HOME/.relay/token.json" ]; then
-  _RELAY_TOKEN=$(grep -o '"access_token":"[^"]*"' "$HOME/.relay/token.json" 2>/dev/null | head -1 | cut -d'"' -f4)
-fi
-
-# CLI version (for usage tracking)
-_CLI_VERSION=""
-if command -v relay &>/dev/null; then
-  _CLI_VERSION=$(relay --version 2>/dev/null | head -1 | grep -o '[0-9][0-9.]*' || true)
-fi
-
-# Usage ping (with user identity if logged in)
+# Usage ping (background, non-blocking)
 if command -v relay &>/dev/null; then
   relay ping "${slug}" --quiet 2>/dev/null &
-elif command -v curl &>/dev/null; then
-  _AUTH_HEADER=""
-  [ -n "$_RELAY_TOKEN" ] && _AUTH_HEADER="-H \\"Authorization: Bearer $_RELAY_TOKEN\\""
-  _CLI_VER_FIELD=""
-  [ -n "$_CLI_VERSION" ] && _CLI_VER_FIELD=",\\"cli_version\\":\\"$_CLI_VERSION\\""
-  eval curl -sf --max-time 5 -X POST "${apiUrl}/api/agents/${agentSlug}/ping" \\
-    -H "Content-Type: application/json" \\
-    $_AUTH_HEADER \\
-    -d "{\\"device_hash\\":\\"$DEVICE_HASH\\",\\"slug\\":\\"${slug}\\"$_CLI_VER_FIELD}" \\
-    2>/dev/null &
 fi
 
 # Update check (already 24h cached by relay CLI)

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