relayax-cli 0.3.66 → 0.4.12

package/dist/lib/manifest-generator.js

@@ -0,0 +1,144 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SUPPORTED_PLATFORMS = void 0;
+exports.generateManifests = generateManifests;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+exports.SUPPORTED_PLATFORMS = ['claude-code', 'codex', 'antigravity'];
+// ─── Claude Code Generator ───
+function generateClaudeCodeManifest(yaml, agentDir) {
+    const files = [];
+    // .claude-plugin/plugin.json
+    const pluginJson = {
+        name: yaml.slug.replace(/^@/, ''),
+        description: yaml.description,
+        version: yaml.version,
+    };
+    if (yaml.source) {
+        pluginJson.repository = yaml.source;
+    }
+    if (yaml.org_slug) {
+        pluginJson.author = { name: yaml.org_slug };
+    }
+    files.push({
+        relativePath: '.claude-plugin/plugin.json',
+        content: JSON.stringify(pluginJson, null, 2),
+    });
+    // marketplace.json (self-contained marketplace with single plugin entry)
+    const slug = yaml.slug.startsWith('@') ? yaml.slug.slice(1) : yaml.slug;
+    const parts = slug.split('/');
+    const owner = parts[0] ?? slug;
+    const pluginName = parts[1] ?? slug;
+    const marketplaceJson = {
+        name: `@${slug}`,
+        owner: { name: owner },
+        plugins: [
+            {
+                name: pluginName,
+                source: {
+                    source: 'url',
+                    url: './',
+                },
+                version: yaml.version,
+            },
+        ],
+    };
+    files.push({
+        relativePath: 'marketplace.json',
+        content: JSON.stringify(marketplaceJson, null, 2),
+    });
+    return files;
+}
+// ─── Codex Generator ───
+function generateCodexManifest(yaml, agentDir) {
+    const pluginJson = {
+        name: yaml.slug.replace(/^@/, ''),
+        description: yaml.description,
+        version: yaml.version,
+    };
+    // Check if skills/ directory exists
+    const skillsDir = path_1.default.join(agentDir, 'skills');
+    if (fs_1.default.existsSync(skillsDir)) {
+        pluginJson.skills = './skills/';
+    }
+    return [
+        {
+            relativePath: '.codex-plugin/plugin.json',
+            content: JSON.stringify(pluginJson, null, 2),
+        },
+    ];
+}
+// ─── Antigravity Generator ───
+function generateAntigravityManifest(yaml, agentDir) {
+    // Antigravity uses .agent/skills/ structure
+    // Only generate if skills/ directory exists
+    const skillsDir = path_1.default.join(agentDir, 'skills');
+    if (!fs_1.default.existsSync(skillsDir)) {
+        return [];
+    }
+    // Map skills/ to .agent/skills/ — no content changes, just path mapping
+    const files = [];
+    const skillEntries = fs_1.default.readdirSync(skillsDir, { withFileTypes: true });
+    for (const entry of skillEntries) {
+        if (entry.isDirectory()) {
+            const skillMd = path_1.default.join(skillsDir, entry.name, 'SKILL.md');
+            if (fs_1.default.existsSync(skillMd)) {
+                const content = fs_1.default.readFileSync(skillMd, 'utf-8');
+                files.push({
+                    relativePath: `.agent/skills/${entry.name}/SKILL.md`,
+                    content,
+                });
+            }
+        }
+    }
+    return files;
+}
+// ─── Platform Registry ───
+const GENERATORS = {
+    'claude-code': generateClaudeCodeManifest,
+    'codex': generateCodexManifest,
+    'antigravity': generateAntigravityManifest,
+};
+// ─── Public API ───
+/**
+ * Generate platform-native manifests from relay.yaml metadata.
+ * Used by both `relay publish` and `relay export`.
+ */
+function generateManifests(yaml, agentDir) {
+    const platforms = resolvePlatforms(yaml.platforms);
+    const files = [];
+    for (const platform of platforms) {
+        const generator = GENERATORS[platform];
+        if (generator) {
+            try {
+                files.push(...generator(yaml, agentDir));
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.error(`\x1b[33m⚠ ${platform} 매니페스트 생성 실패: ${msg}\x1b[0m`);
+            }
+        }
+    }
+    return files;
+}
+/**
+ * Resolve platforms list: filter valid platforms, warn on invalid ones.
+ */
+function resolvePlatforms(platforms) {
+    if (!platforms || platforms.length === 0) {
+        return [...exports.SUPPORTED_PLATFORMS];
+    }
+    const valid = [];
+    for (const p of platforms) {
+        if (exports.SUPPORTED_PLATFORMS.includes(p)) {
+            valid.push(p);
+        }
+        else {
+            console.error(`\x1b[33m⚠ 지원하지 않는 플랫폼: ${p} (지원: ${exports.SUPPORTED_PLATFORMS.join(', ')})\x1b[0m`);
+        }
+    }
+    return valid;
+}

package/dist/lib/storage.d.ts

@@ -2,3 +2,8 @@ export declare function downloadPackage(url: string, destDir: string): Promise<s
 export declare function extractPackage(tarPath: string, destDir: string): Promise<void>;
 export declare function makeTempDir(): string;
 export declare function removeTempDir(dir: string): void;
+/**
+ * Clone an agent from git URL to destination directory.
+ * Replaces downloadPackage() + extractPackage() for git-based agents.
+ */
+export declare function clonePackage(gitUrl: string, destDir: string, version?: string): Promise<void>;

package/dist/lib/storage.js

@@ -7,6 +7,7 @@ exports.downloadPackage = downloadPackage;
 exports.extractPackage = extractPackage;
 exports.makeTempDir = makeTempDir;
 exports.removeTempDir = removeTempDir;
+exports.clonePackage = clonePackage;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
@@ -14,6 +15,7 @@ const fs_2 = require("fs");
 const promises_1 = require("stream/promises");
 const stream_1 = require("stream");
 const tar_1 = require("tar");
+const git_operations_js_1 = require("./git-operations.js");
 async function downloadPackage(url, destDir) {
     const res = await fetch(url);
     if (!res.ok) {
@@ -41,3 +43,10 @@ function makeTempDir() {
 function removeTempDir(dir) {
     fs_1.default.rmSync(dir, { recursive: true, force: true });
 }
+/**
+ * Clone an agent from git URL to destination directory.
+ * Replaces downloadPackage() + extractPackage() for git-based agents.
+ */
+async function clonePackage(gitUrl, destDir, version) {
+    await (0, git_operations_js_1.gitInstall)(gitUrl, destDir, version);
+}

package/dist/mcp/server.js

@@ -12,6 +12,7 @@ const config_js_1 = require("../lib/config.js");
 const api_js_1 = require("../lib/api.js");
 const slug_js_1 = require("../lib/slug.js");
 const storage_js_1 = require("../lib/storage.js");
+const git_operations_js_1 = require("../lib/git-operations.js");
 const ai_tools_js_1 = require("../lib/ai-tools.js");
 const preamble_js_1 = require("../lib/preamble.js");
 const installer_js_1 = require("../lib/installer.js");
@@ -124,38 +125,56 @@ function createMcpServer() {
             }
             const tempDir = (0, storage_js_1.makeTempDir)();
             try {
-                const tarPath = await (0, storage_js_1.downloadPackage)(agent.package_url, tempDir);
                 const agentDir = path_1.default.join(projectPath, '.relay', 'agents', parsed.owner, parsed.name);
-                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);
+                if (agent.git_url) {
+                    // Git clone path
+                    (0, git_operations_js_1.checkGitInstalled)();
+                    await (0, storage_js_1.clonePackage)(agent.git_url, agentDir);
+                }
+                else {
+                    // Legacy tar.gz path
+                    const tarPath = await (0, storage_js_1.downloadPackage)(agent.package_url, tempDir);
+                    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);
+                }
                 (0, preamble_js_1.injectPreambleToAgent)(agentDir, fullSlug);
                 const installed = (0, config_js_1.loadInstalled)();
                 installed[fullSlug] = { agent_id: agent.id, version: agent.version, installed_at: new Date().toISOString(), files: [agentDir] };
                 (0, config_js_1.saveInstalled)(installed);
                 await (0, api_js_1.reportInstall)(agent.id, fullSlug, agent.version);
                 (0, api_js_1.sendUsagePing)(agent.id, fullSlug, agent.version);
-                // relay.yaml에서 tags, requires 읽기 (scope 판단용)
+                // relay.yaml에서 tags, requires, recommended_scope 읽기
                 let agentTags = [];
                 let agentRequires = null;
                 let hasRules = false;
+                let recommendedScope;
                 try {
                     const relayYamlPath = path_1.default.join(agentDir, 'relay.yaml');
                     if (fs_1.default.existsSync(relayYamlPath)) {
                         const cfg = js_yaml_1.default.load(fs_1.default.readFileSync(relayYamlPath, 'utf-8'));
                         agentTags = cfg.tags ?? [];
                         agentRequires = cfg.requires ?? null;
+                        if (cfg.recommended_scope === 'global' || cfg.recommended_scope === 'local') {
+                            recommendedScope = cfg.recommended_scope;
+                        }
                     }
                     hasRules = fs_1.default.existsSync(path_1.default.join(agentDir, 'rules')) && fs_1.default.readdirSync(path_1.default.join(agentDir, 'rules')).length > 0;
                 }
                 catch { /* non-critical */ }
+                // recommended_scope가 relay.yaml에 없으면 휴리스틱으로 추론
+                if (!recommendedScope) {
+                    const frameworkTags = ['nextjs', 'react', 'vue', 'angular', 'svelte', 'nuxt', 'remix', 'astro', 'django', 'rails', 'laravel', 'spring', 'express', 'fastapi', 'flask'];
+                    recommendedScope = (hasRules || agentTags.some((t) => frameworkTags.includes(t.toLowerCase()))) ? 'local' : 'global';
+                }
                 const cliUpdate = await getCliUpdateWarning();
                 return { content: [jsonTextWithUpdate({
                             status: 'ok', agent: agent.name, slug: fullSlug, version: agent.version,
                             description: agent.description ?? '', tags: agentTags, requires: agentRequires, has_rules: hasRules,
+                            recommended_scope: recommendedScope,
                             files: countFiles(agentDir), install_path: agentDir,
-                            scope_hint: '설치 후 에이전트 성격에 따라 글로벌/로컬 배치를 사용자에게 물어보세요. tags에 특정 프레임워크가 있거나 rules/가 있으면 로컬 추천, 범용이면 글로벌 추천.',
+                            scope_hint: `이 에이전트의 권장 배치 범위는 "${recommendedScope}"입니다. 사용자에게 확인 후 relay deploy --scope ${recommendedScope}로 배치하세요.`,
                         }, cliUpdate)] };
             }
             finally {

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/dist/types.d.ts

@@ -32,11 +32,14 @@ export interface AgentRegistryInfo {
     description?: string;
     version: string;
     package_url: string;
+    git_url?: string;
     commands: {
         name: string;
         description: string;
     }[];
     type?: 'command' | 'passive' | 'hybrid';
+    /** 에이전트 제작자가 권장하는 배치 범위 */
+    recommended_scope?: 'global' | 'local';
     agent_details?: {
         name: string;
         description: string;

package/package.json

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