relayax-cli 0.3.66 → 0.3.67

package/dist/commands/init.d.ts

@@ -1,13 +1,9 @@
 import { Command } from 'commander';
-/**
- * 글로벌 User 커맨드를 감지된 모든 에이전트 CLI에 설치한다.
- * ~/{skillsDir}/commands/relay/ 에 설치.
- * 기존 파일 중 현재 커맨드 목록에 없는 것은 제거한다.
- */
 export declare function installGlobalUserCommands(): {
     installed: boolean;
     commands: string[];
     tools: string[];
+    removed: string[];
 };
 /**
  * 글로벌 User 커맨드가 이미 설치되어 있는지 확인한다.

package/dist/commands/init.js

@@ -36,10 +36,15 @@ function showWelcome() {
         '  에이전트 CLI에 relay 커맨드를 연결합니다.',
         '',
         '  \x1b[2mUser 커맨드 (글로벌)\x1b[0m',
-        '  /relay-install     에이전트 탐색 & 설치',
-        '  /relay-status      설치 현황 & Space',
+        '  /relay-explore     에이전트 탐색 & 추천',
+        '  /relay-create      에이전트 생성 & 배포',
+        '  /relay-status      설치 현황 & Organization',
         '  /relay-uninstall   에이전트 삭제',
         '',
+        '  \x1b[2mCLI 명령어\x1b[0m',
+        '  relay install      에이전트 설치 (CLI 한 줄 완결)',
+        '  relay publish      재배포 (--patch/--minor/--major)',
+        '',
     ];
     console.log(lines.join('\n'));
 }
@@ -65,20 +70,28 @@ async function selectToolsInteractively(detectedIds) {
  * ~/{skillsDir}/commands/relay/ 에 설치.
  * 기존 파일 중 현재 커맨드 목록에 없는 것은 제거한다.
  */
+/** 제거된 레거시 커맨드 → 대체 안내 매핑 */
+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)();
     const currentIds = new Set(command_adapter_js_1.USER_COMMANDS.map((c) => c.id));
     const commands = [];
     const tools = [];
-    // 감지된 CLI가 없으면 설치하지 않음 (사용자가 --tools로 지정하거나 CLI를 먼저 설치해야 함)
+    const removed = [];
     const targetDirs = globalCLIs.map((t) => ({ name: t.name, dir: (0, command_adapter_js_1.getGlobalCommandDirForTool)(t.skillsDir), getPath: (id) => (0, command_adapter_js_1.getGlobalCommandPathForTool)(t.skillsDir, id) }));
     for (const target of targetDirs) {
         fs_1.default.mkdirSync(target.dir, { recursive: true });
-        // 기존 파일 중 현재 목록에 없는 것 제거
+        // 기존 파일 중 현재 목록에 없는 것 제거 + 레거시 안내
         for (const file of fs_1.default.readdirSync(target.dir)) {
             const id = file.replace(/\.md$/, '');
             if (!currentIds.has(id)) {
                 fs_1.default.unlinkSync(path_1.default.join(target.dir, file));
+                if (LEGACY_COMMANDS[id] && !removed.includes(id)) {
+                    removed.push(id);
+                }
             }
         }
         // 현재 커맨드 설치 (덮어쓰기)
@@ -87,11 +100,10 @@ function installGlobalUserCommands() {
         }
         tools.push(target.name);
     }
-    // commands 목록은 한 번만
     for (const cmd of command_adapter_js_1.USER_COMMANDS) {
         commands.push(cmd.id);
     }
-    return { installed: true, commands, tools };
+    return { installed: true, commands, tools, removed };
 }
 /**
  * 글로벌 User 커맨드가 이미 설치되어 있는지 확인한다.
@@ -149,10 +161,12 @@ function registerInit(program) {
         // ── 1. 글로벌 User 커맨드 설치 ──
         let globalStatus = 'already';
         let globalTools = [];
+        let removedCommands = [];
         {
             const result = installGlobalUserCommands();
             globalStatus = hasGlobalUserCommands() ? 'updated' : 'installed';
             globalTools = result.tools;
+            removedCommands = result.removed;
             // Register relay-core in installed.json
             const installed = (0, config_js_1.loadInstalled)();
             installed['relay-core'] = {
@@ -245,6 +259,14 @@ function registerInit(program) {
         }
         else {
             console.log(`\n\x1b[32m✓ relay 초기화 완료\x1b[0m\n`);
+            // 레거시 커맨드 마이그레이션 안내
+            if (removedCommands.length > 0) {
+                console.log(`  \x1b[33m⚠ 변경된 커맨드:\x1b[0m`);
+                for (const id of removedCommands) {
+                    console.log(`    \x1b[31m✗ /${id}\x1b[0m → ${LEGACY_COMMANDS[id]}`);
+                }
+                console.log();
+            }
             // 글로벌
             {
                 const toolNames = globalTools.length > 0 ? globalTools.join(', ') : '(감지된 CLI 없음)';

package/dist/commands/publish.js

@@ -552,26 +552,31 @@ function registerPublish(program) {
         // Visibility default
         const defaultVisibility = 'public';
         // Visibility validation: must be explicitly set
+        // internal은 org가 선택된 경우에만 옵션으로 표시
+        const hasOrg = !!selectedOrgId;
         if (!config.visibility) {
             if (isTTY) {
                 const { select: promptSelect } = await import('@inquirer/prompts');
                 console.error(`\n\x1b[33m⚠ relay.yaml에 visibility가 설정되지 않았습니다.\x1b[0m  (기본값: ${defaultVisibility === 'public' ? '공개' : '비공개'})`);
+                const visChoices = [
+                    {
+                        name: `공개 — 누구나 설치${defaultVisibility === 'public' ? '  ✓ 추천' : ''}`,
+                        value: 'public',
+                    },
+                    {
+                        name: '링크 공유 — 접근 링크가 있는 사람만 설치',
+                        value: 'private',
+                    },
+                ];
+                if (hasOrg) {
+                    visChoices.push({
+                        name: '비공개 — Org 멤버만 접근',
+                        value: 'internal',
+                    });
+                }
                 config.visibility = await promptSelect({
                     message: '공개 범위를 선택하세요:',
-                    choices: [
-                        {
-                            name: `공개 — 누구나 설치${defaultVisibility === 'public' ? '  ✓ 추천' : ''}`,
-                            value: 'public',
-                        },
-                        {
-                            name: '링크 공유 — 접근 링크가 있는 사람만 설치',
-                            value: 'private',
-                        },
-                        {
-                            name: `비공개 — Org 멤버만 접근`,
-                            value: 'internal',
-                        },
-                    ],
+                    choices: visChoices,
                     default: defaultVisibility,
                 });
                 // Save back to relay.yaml
@@ -582,14 +587,17 @@ function registerPublish(program) {
             }
             else {
                 (0, error_report_js_1.reportCliError)('publish', 'MISSING_VISIBILITY', 'visibility not set in relay.yaml');
+                const visOptions = [
+                    { value: 'public', label: '공개 — 누구나 설치' },
+                    { value: 'private', label: '링크 공유 — 접근 링크가 있는 사람만 설치' },
+                ];
+                if (hasOrg) {
+                    visOptions.push({ value: 'internal', label: '비공개 — Org 멤버만 접근' });
+                }
                 console.error(JSON.stringify({
                     error: 'MISSING_VISIBILITY',
                     message: 'relay.yaml에 visibility를 설정해주세요.',
-                    options: [
-                        { value: 'public', label: '공개 — 누구나 설치' },
-                        { value: 'private', label: '링크 공유 — 접근 링크가 있는 사람만 설치' },
-                        { value: 'internal', label: '비공개 — Org 멤버만 접근' },
-                    ],
+                    options: visOptions,
                     fix: 'relay.yaml의 visibility 필드를 위 옵션 중 하나로 설정하세요.',
                 }));
                 process.exit(1);
@@ -605,22 +613,25 @@ function registerPublish(program) {
                 internal: '비공개',
             };
             const currentVisLabel = visLabelMap[config.visibility ?? 'public'] ?? config.visibility;
+            const confirmVisChoices = [
+                {
+                    name: `공개 — 누구나 설치${defaultVisibility === 'public' ? '  ✓ 추천' : ''}`,
+                    value: 'public',
+                },
+                {
+                    name: '링크공유 — 접근 링크가 있는 사람만 설치',
+                    value: 'private',
+                },
+            ];
+            if (hasOrg) {
+                confirmVisChoices.push({
+                    name: '비공개 — Org 멤버만 접근',
+                    value: 'internal',
+                });
+            }
             const newVisibility = await promptConfirmVis({
                 message: `공개 범위: ${currentVisLabel} — 유지하거나 변경하세요`,
-                choices: [
-                    {
-                        name: `공개 — 누구나 설치${defaultVisibility === 'public' ? '  ✓ 추천' : ''}`,
-                        value: 'public',
-                    },
-                    {
-                        name: '링크공유 — 접근 링크가 있는 사람만 설치',
-                        value: 'private',
-                    },
-                    {
-                        name: `비공개 — Org 멤버만 접근`,
-                        value: 'internal',
-                    },
-                ],
+                choices: confirmVisChoices,
                 default: config.visibility ?? defaultVisibility,
             });
             if (newVisibility !== config.visibility) {

package/dist/lib/command-adapter.js

@@ -210,7 +210,7 @@ ${index_js_1.ERROR_HANDLING_GUIDE}
     },
     {
         id: 'relay-create',
-        description: '에이전트 패키지를 새로 만들어 relay에 배포합니다',
+        description: '에이전트를 만들거나 업데이트하여 relay에 배포합니다',
         body: index_js_1.CREATE_PROMPT,
     },
 ];

package/dist/prompts/create.md

@@ -1,9 +1,20 @@
-에이전트 패키지를 새로 만듭니다.
-콘텐츠를 분석하고, 포지셔닝하고, relay.yaml을 작성한 뒤 배포합니다.
+에이전트를 만들거나 업데이트하여 relay에 배포합니다.
+relay.yaml이 없으면 새로 만들고, 있으면 변경사항을 반영합니다.
 
 > 빌더는 터미널 환경에서 작업합니다. CLI 명령어를 직접 실행하세요.
 
-## 1. 콘텐츠 파악
+## 분기: 최초 생성 vs 업데이트
+
+`.relay/relay.yaml`이 있는지 확인합니다.
+
+- **없음** → 아래 "최초 생성" 플로우
+- **있음** → 아래 "업데이트" 플로우
+
+---
+
+## 최초 생성 (relay.yaml 없음)
+
+### 1. 콘텐츠 파악
 
 `relay package --init --json`으로 소스를 스캔합니다.
 결과의 `sources[]`에서 사용자에게 어떤 콘텐츠를 포함할지 물어봅니다.
@@ -12,7 +23,7 @@
 - SKILL.md, 에이전트 파일, 커맨드 파일의 내용
 - 참조하는 스킬/에이전트 의존성
 
-## 2. 포지셔닝
+### 2. 포지셔닝
 
 콘텐츠 분석을 기반으로 에이전트를 하나의 "제품"으로 포지셔닝합니다.
 
@@ -24,7 +35,7 @@
 이름(name)은 한국어 가능. slug는 영문 소문자+하이픈.
 설명은 설치자 관점으로 ("~를 자동화합니다").
 
-## 3. requires 판단
+### 3. requires 판단 + 보안 점검
 
 콘텐츠 파일을 읽고 requires를 판단합니다:
 
@@ -37,26 +48,61 @@
 - **runtime**: Node.js/Python 최소 버전
 - **agents**: 의존하는 다른 relay 에이전트
 
-## 4. 보안 점검
-
-콘텐츠 파일에서 시크릿/개인정보를 확인합니다:
+보안 점검:
 - 하드코딩된 API 키, 토큰 (sk-*, ghp_*, AKIA* 등)
-- 이메일, 전화번호 등 개인정보
-- 발견 시 **반드시 경고**하고 환경변수 대체 안내
 - 파일 컨텍스트를 읽어 실제 시크릿 vs 예시 코드를 구분
+- 발견 시 **반드시 경고**하고 환경변수 대체 안내
 
-## 5. relay.yaml 작성 & 배포
+### 4. relay.yaml 작성 & 배포
 
 판단 결과를 relay.yaml에 반영합니다:
 - name, slug, description, version, tags
 - requires (판단 결과)
-- visibility, org (사용자에게 확인)
+- org: `relay orgs list --json`으로 Org 목록을 조회합니다.
+  - Org가 있으면: 개인 배포 vs Org 배포를 사용자에게 물어봅니다.
+  - Org가 없으면: 개인 배포로 진행합니다.
+- visibility: Org 선택 결과에 따라 옵션이 달라집니다:
+  - **Org 없이 배포**: `public`, `private` (2개)
+  - **Org에 배포**: `public`, `private`, `internal` (3개)
+  - `public` — 누구나 설치
+  - `private` — 접근 링크가 있는 사람만 설치
+  - `internal` — Org 멤버만 설치 (Org 배포 시에만 선택 가능)
 
 `relay publish --json`으로 배포합니다.
 
-## 6. 공유 문구
+---
+
+## 업데이트 (relay.yaml 있음)
+
+### 1. 변경 사항 확인
+
+`relay package --json`으로 현재 상태를 확인합니다.
+- 변경된 콘텐츠 (modified)
+- 새로 추가된 콘텐츠 (new_items)
+
+사용자에게 어떤 부분을 변경하려는지 물어봅니다:
+- 콘텐츠 변경 반영 (sync)
+- 새 스킬/커맨드 추가
+- 설명/태그 개선
+- requires 재분석
+
+### 2. 필요한 부분만 업데이트
+
+사용자 요청에 따라:
+- **콘텐츠 추가**: 새 콘텐츠의 파일을 읽고 기능 파악 → relay.yaml의 contents에 추가
+- **requires 변경**: 콘텐츠를 다시 읽고 requires 재판단
+- **설명 개선**: 현재 포지셔닝을 분석하고 개선안 제안
+- **보안 재점검**: 시크릿/개인정보 확인
+
+### 3. 배포
+
+`relay publish --json`으로 배포합니다.
+버전 범프가 필요하면 사용자에게 patch/minor/major 중 확인합니다.
+
+---
+
+## 공유 문구
 
 배포 완료 후 `relay publish` 출력에 포함된 공유 문구를 보여줍니다.
-CLI가 이미 설치된 사용자를 위한 짧은 버전도 함께 표시합니다.
 
 {{ERROR_HANDLING_GUIDE}}

package/package.json

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