relayax-cli 0.4.25 → 0.4.27

package/dist/prompts/create.md

@@ -29,7 +29,9 @@ relay.yaml이 없으면 새로 만들고, 있으면 변경사항을 반영합니
 `.relay/relay.yaml`이 있는지 확인합니다.
 
 - **없음** → 아래 "최초 생성" 플로우
-- **있음** → 아래 "업데이트" 플로우
+- **있음** → `relay package --json`으로 상태 확인
+  - `no_contents` 에러 → relay.yaml에 sources/contents가 없는 레거시 상태. `relay package --init --json`으로 소스를 스캔하고 relay.yaml에 sources를 추가한 뒤 "업데이트" 플로우 진행
+  - 정상 응답 → 아래 "업데이트" 플로우
 
 ---
 
@@ -150,11 +152,6 @@ relay.yaml이 없으면 새로 만들고, 있으면 변경사항을 반영합니
 1. **배포 결과 요약** — slug, 버전, 공개 범위, URL
 2. **설치 방법** — CLI 출력에 코드블록 형태로 이미 포함되어 있으므로, 그 내용을 사용자에게 안내합니다:
    - CLI: `npx relayax-cli install {slug}`
-   - 출력에 `plugin_url`이 있으면 Claude Code Plugin (**두 명령을 순서대로 각각 실행**):
-     ```
-     ① /plugin marketplace add {pluginUrl}
-     ② /plugin install {slug}
-     ```
    - 에이전트 소개 페이지 URL
 3. **공유 텍스트** — CLI 출력의 공유 블록(┌─ ... ─┘)을 그대로 안내합니다. 팀에 바로 복붙할 수 있는 코드블록 형태입니다.
 

package/dist/prompts/explore.md

@@ -26,3 +26,5 @@
 scope 결정 기준:
 - 범용 도구 (코드 리뷰, 문서 생성, 테스트) → `relay install <slug>` (글로벌 기본)
 - 프로젝트 특화 (특정 프레임워크, 팀 컨벤션) → `relay install <slug> --local`
+
+{{ERROR_HANDLING_GUIDE}}

package/package.json

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

package/dist/commands/export.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare function registerExport(program: Command): void;

package/dist/commands/export.js

@@ -1,106 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerExport = registerExport;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const js_yaml_1 = __importDefault(require("js-yaml"));
-const manifest_generator_js_1 = require("../lib/manifest-generator.js");
-const paths_js_1 = require("../lib/paths.js");
-function registerExport(program) {
-    program
-        .command('export <platform>')
-        .description('로컬에서 플랫폼 네이티브 매니페스트를 생성합니다')
-        .option('--out <dir>', '출력 디렉토리 (기본: .relay/export/<platform>/)')
-        .option('--project <dir>', '프로젝트 루트 경로')
-        .action(async (platform, opts) => {
-        const json = program.opts().json ?? false;
-        const projectPath = (0, paths_js_1.resolveProjectPath)(opts.project);
-        const relayDir = path_1.default.join(projectPath, '.relay');
-        const relayYamlPath = path_1.default.join(relayDir, 'relay.yaml');
-        // Check relay.yaml exists
-        if (!fs_1.default.existsSync(relayYamlPath)) {
-            const msg = 'relay.yaml not found';
-            if (json) {
-                console.error(JSON.stringify({ error: 'NOT_FOUND', message: msg }));
-            }
-            else {
-                console.error(`\x1b[31m${msg}\x1b[0m`);
-                console.error('  relay.yaml이 있는 에이전트 디렉토리에서 실행하세요.');
-            }
-            process.exit(1);
-        }
-        // Validate platform
-        const validPlatforms = [...manifest_generator_js_1.SUPPORTED_PLATFORMS, 'all'];
-        if (!validPlatforms.includes(platform)) {
-            const msg = `지원하지 않는 플랫폼: ${platform}`;
-            if (json) {
-                console.error(JSON.stringify({ error: 'INVALID_PLATFORM', message: msg, supported: manifest_generator_js_1.SUPPORTED_PLATFORMS }));
-            }
-            else {
-                console.error(`\x1b[31m${msg}\x1b[0m`);
-                console.error(`  지원 플랫폼: ${manifest_generator_js_1.SUPPORTED_PLATFORMS.join(', ')}, all`);
-            }
-            process.exit(1);
-        }
-        // Parse relay.yaml
-        const yamlContent = fs_1.default.readFileSync(relayYamlPath, 'utf-8');
-        const raw = js_yaml_1.default.load(yamlContent) ?? {};
-        const manifestYaml = {
-            name: String(raw.name ?? ''),
-            slug: String(raw.slug ?? ''),
-            description: String(raw.description ?? ''),
-            version: String(raw.version ?? '1.0.0'),
-            source: raw.source ? String(raw.source) : undefined,
-            org_slug: raw.org_slug ? String(raw.org_slug) : undefined,
-            platforms: platform === 'all' ? undefined : [platform],
-        };
-        // Generate manifests
-        const files = (0, manifest_generator_js_1.generateManifests)(manifestYaml, relayDir);
-        if (files.length === 0) {
-            if (json) {
-                console.log(JSON.stringify({ status: 'empty', message: '생성할 매니페스트가 없습니다.' }));
-            }
-            else {
-                console.log('생성할 매니페스트가 없습니다.');
-            }
-            return;
-        }
-        // Determine output directory
-        const outDir = opts.out
-            ? path_1.default.resolve(opts.out)
-            : path_1.default.join(relayDir, 'export', platform);
-        fs_1.default.mkdirSync(outDir, { recursive: true });
-        // Write files
-        const written = [];
-        for (const file of files) {
-            const filePath = path_1.default.join(outDir, file.relativePath);
-            fs_1.default.mkdirSync(path_1.default.dirname(filePath), { recursive: true });
-            fs_1.default.writeFileSync(filePath, file.content);
-            written.push(file.relativePath);
-        }
-        if (json) {
-            console.log(JSON.stringify({ status: 'ok', platform, output_dir: outDir, files: written }));
-        }
-        else {
-            console.log(`\n\x1b[32m✓ 매니페스트 생성 완료\x1b[0m  (${platform})`);
-            console.log(`  출력: \x1b[36m${outDir}\x1b[0m\n`);
-            for (const f of written) {
-                console.log(`  \x1b[90m•\x1b[0m ${f}`);
-            }
-            // Platform-specific usage hints
-            console.log('');
-            if (platform === 'claude-code' || platform === 'all') {
-                console.log('  \x1b[90mClaude Code:\x1b[0m /plugin marketplace add <marketplace.json URL>');
-            }
-            if (platform === 'codex' || platform === 'all') {
-                console.log('  \x1b[90mCodex:\x1b[0m .codex-plugin/plugin.json을 Codex에 등록하세요');
-            }
-            if (platform === 'antigravity' || platform === 'all') {
-                console.log('  \x1b[90mAntigravity:\x1b[0m .agent/skills/를 프로젝트에 복사하세요');
-            }
-        }
-    });
-}

package/dist/commands/follow.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare function registerFollow(program: Command): void;

package/dist/commands/follow.js

@@ -1,45 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerFollow = registerFollow;
-const api_js_1 = require("../lib/api.js");
-const config_js_1 = require("../lib/config.js");
-function registerFollow(program) {
-    program
-        .command('follow <username>')
-        .description('빌더를 팔로우합니다 (새 버전 알림)')
-        .action(async (username) => {
-        const json = program.opts().json ?? false;
-        // Strip @ prefix if present
-        const cleanUsername = username.startsWith('@') ? username.slice(1) : username;
-        const token = await (0, config_js_1.getValidToken)();
-        if (!token) {
-            const msg = '로그인이 필요합니다. `relay login`을 먼저 실행하세요.';
-            if (json) {
-                console.log(JSON.stringify({ error: 'NO_TOKEN', message: msg, fix: 'relay login 실행 후 재시도하세요.' }));
-            }
-            else {
-                console.error(msg);
-            }
-            process.exit(1);
-        }
-        try {
-            await (0, api_js_1.followBuilder)(cleanUsername);
-            if (json) {
-                console.log(JSON.stringify({ ok: true, following: cleanUsername }));
-            }
-            else {
-                console.log(`\x1b[32m✓ @${cleanUsername} 팔로우 완료\x1b[0m — 새 버전 알림을 받습니다.`);
-            }
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            if (json) {
-                console.log(JSON.stringify({ error: 'FOLLOW_FAILED', message, fix: 'username을 확인하거나 잠시 후 재시도하세요.' }));
-            }
-            else {
-                console.error(`팔로우 실패: ${message}`);
-            }
-            process.exit(1);
-        }
-    });
-}

package/dist/commands/invite.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare function registerInvite(program: Command): void;

package/dist/commands/invite.js

@@ -1,135 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerInvite = registerInvite;
-const config_js_1 = require("../lib/config.js");
-function registerInvite(program) {
-    const inviteCmd = program
-        .command('invite <slug>')
-        .description('invite-only 팀에 사용자를 초대합니다');
-    inviteCmd
-        .command('add <username>')
-        .description('사용자 초대')
-        .action(async (username) => {
-        const json = program.opts().json ?? false;
-        const slug = inviteCmd.args[0];
-        const token = (0, config_js_1.loadToken)();
-        if (!token) {
-            console.error(JSON.stringify({ error: 'NO_TOKEN', message: '인증이 필요합니다. `relay login`을 먼저 실행하세요.' }));
-            process.exit(1);
-        }
-        try {
-            const res = await fetch(`${config_js_1.API_URL}/api/teams/${slug}/invites`, {
-                method: 'POST',
-                headers: {
-                    'Authorization': `Bearer ${token}`,
-                    'Content-Type': 'application/json',
-                },
-                body: JSON.stringify({ username }),
-            });
-            const body = await res.json();
-            if (!res.ok) {
-                if (json) {
-                    console.error(JSON.stringify(body));
-                }
-                else {
-                    console.error(`오류: ${body.message ?? '초대에 실패했습니다'}`);
-                }
-                process.exit(1);
-            }
-            if (json) {
-                console.log(JSON.stringify(body));
-            }
-            else {
-                console.log(`✓ @${username}을(를) ${slug}에 초대했습니다.`);
-            }
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            console.error(JSON.stringify({ error: 'INVITE_FAILED', message }));
-            process.exit(1);
-        }
-    });
-    inviteCmd
-        .command('remove <username>')
-        .description('초대 취소')
-        .action(async (username) => {
-        const json = program.opts().json ?? false;
-        const slug = inviteCmd.args[0];
-        const token = (0, config_js_1.loadToken)();
-        if (!token) {
-            console.error(JSON.stringify({ error: 'NO_TOKEN', message: '인증이 필요합니다.' }));
-            process.exit(1);
-        }
-        try {
-            const res = await fetch(`${config_js_1.API_URL}/api/teams/${slug}/invites`, {
-                method: 'DELETE',
-                headers: {
-                    'Authorization': `Bearer ${token}`,
-                    'Content-Type': 'application/json',
-                },
-                body: JSON.stringify({ username }),
-            });
-            const body = await res.json();
-            if (!res.ok) {
-                if (json) {
-                    console.error(JSON.stringify(body));
-                }
-                else {
-                    console.error(`오류: ${body.message ?? '초대 취소에 실패했습니다'}`);
-                }
-                process.exit(1);
-            }
-            if (json) {
-                console.log(JSON.stringify(body));
-            }
-            else {
-                console.log(`✓ @${username}의 초대를 취소했습니다.`);
-            }
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            console.error(JSON.stringify({ error: 'REVOKE_FAILED', message }));
-            process.exit(1);
-        }
-    });
-    inviteCmd
-        .command('list')
-        .description('초대 목록 조회')
-        .action(async () => {
-        const json = program.opts().json ?? false;
-        const slug = inviteCmd.args[0];
-        const token = (0, config_js_1.loadToken)();
-        if (!token) {
-            console.error(JSON.stringify({ error: 'NO_TOKEN', message: '인증이 필요합니다.' }));
-            process.exit(1);
-        }
-        try {
-            const res = await fetch(`${config_js_1.API_URL}/api/teams/${slug}/invites`, {
-                headers: { 'Authorization': `Bearer ${token}` },
-            });
-            const body = await res.json();
-            if (!res.ok) {
-                console.error(JSON.stringify(body));
-                process.exit(1);
-            }
-            const invites = body.invites ?? [];
-            if (json) {
-                console.log(JSON.stringify(body));
-            }
-            else if (invites.length === 0) {
-                console.log('초대된 사용자가 없습니다.');
-            }
-            else {
-                console.log(`초대된 사용자 (${invites.length}명):`);
-                for (const inv of invites) {
-                    console.log(`  @${inv.profiles?.username ?? '(알 수 없음)'}`);
-                }
-            }
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            console.error(JSON.stringify({ error: 'LIST_FAILED', message }));
-            process.exit(1);
-        }
-    });
-}

package/dist/commands/spaces.d.ts

@@ -1,11 +0,0 @@
-import { Command } from 'commander';
-export interface SpaceInfo {
-    id: string;
-    slug: string;
-    name: string;
-    description: string | null;
-    join_policy?: string;
-    role: string;
-}
-export declare function fetchMySpaces(token: string): Promise<SpaceInfo[]>;
-export declare function registerSpaces(program: Command): void;

package/dist/commands/spaces.js

@@ -1,69 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.fetchMySpaces = fetchMySpaces;
-exports.registerSpaces = registerSpaces;
-const config_js_1 = require("../lib/config.js");
-async function fetchMySpaces(token) {
-    const res = await fetch(`${config_js_1.API_URL}/api/spaces`, {
-        headers: { Authorization: `Bearer ${token}` },
-        signal: AbortSignal.timeout(8000),
-    });
-    if (!res.ok) {
-        throw new Error(`Space 목록 조회 실패 (${res.status})`);
-    }
-    return (await res.json());
-}
-function registerSpaces(program) {
-    program
-        .command('spaces')
-        .description('내 Space 목록을 확인합니다')
-        .action(async () => {
-        const json = program.opts().json ?? false;
-        const token = await (0, config_js_1.getValidToken)();
-        if (!token) {
-            if (json) {
-                console.error(JSON.stringify({ error: 'LOGIN_REQUIRED', message: '로그인이 필요합니다. relay login을 먼저 실행하세요.', fix: 'relay login 실행 후 재시도하세요.' }));
-            }
-            else {
-                console.error('\x1b[31m오류: 로그인이 필요합니다.\x1b[0m');
-                console.error('  relay login을 먼저 실행하세요.');
-            }
-            process.exit(1);
-        }
-        try {
-            const spaces = await fetchMySpaces(token);
-            if (json) {
-                console.log(JSON.stringify({ spaces }));
-                return;
-            }
-            if (spaces.length === 0) {
-                console.log('\nSpace가 없습니다.');
-                console.log('\x1b[33m💡 Space를 만들려면: www.relayax.com/spaces/new\x1b[0m');
-            }
-            else {
-                console.log(`\n\x1b[1m내 Space\x1b[0m (${spaces.length}개):\n`);
-                for (const s of spaces) {
-                    const role = s.role === 'owner' ? '\x1b[33m소유자\x1b[0m'
-                        : s.role === 'builder' ? '\x1b[36m빌더\x1b[0m'
-                            : '\x1b[90m멤버\x1b[0m';
-                    const desc = s.description
-                        ? `  \x1b[90m${s.description.length > 40 ? s.description.slice(0, 40) + '...' : s.description}\x1b[0m`
-                        : '';
-                    console.log(`  \x1b[36m${s.slug}\x1b[0m  \x1b[1m${s.name}\x1b[0m  ${role}${desc}`);
-                }
-                console.log(`\n\x1b[33m💡 Space 팀 목록: relay list --space <slug>\x1b[0m`);
-                console.log(`\x1b[33m💡 비공개 배포: relay.yaml에 visibility: private 설정 후 relay publish\x1b[0m`);
-            }
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            if (json) {
-                console.error(JSON.stringify({ error: 'FETCH_FAILED', message, fix: '네트워크 연결을 확인하거나 잠시 후 재시도하세요.' }));
-            }
-            else {
-                console.error(`\x1b[31m오류: ${message}\x1b[0m`);
-            }
-            process.exit(1);
-        }
-    });
-}

package/dist/lib/config.js.bak

@@ -1,75 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.API_URL = void 0;
-exports.getInstallPath = getInstallPath;
-exports.ensureRelayDir = ensureRelayDir;
-exports.loadToken = loadToken;
-exports.saveToken = saveToken;
-exports.loadInstalled = loadInstalled;
-exports.saveInstalled = saveInstalled;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const os_1 = __importDefault(require("os"));
-const ai_tools_js_1 = require("./ai-tools.js");
-exports.API_URL = 'https://relayax.com';
-const RELAY_DIR = path_1.default.join(os_1.default.homedir(), '.relay');
-const INSTALLED_FILE = path_1.default.join(RELAY_DIR, 'installed.json');
-/**
- * 설치 경로를 결정한다.
- * 1. --path 옵션이 있으면 그대로 사용
- * 2. 에이전트 CLI 자동 감지 → 감지된 경로 사용
- * 3. 감지 안 되면 현재 디렉토리에 직접 설치
- */
-function getInstallPath(override) {
-    if (override) {
-        const resolved = override.startsWith('~')
-            ? path_1.default.join(os_1.default.homedir(), override.slice(1))
-            : path_1.default.resolve(override);
-        return resolved;
-    }
-    const cwd = process.cwd();
-    const detected = (0, ai_tools_js_1.detectAgentCLIs)(cwd);
-    if (detected.length >= 1) {
-        return path_1.default.join(cwd, detected[0].skillsDir);
-    }
-    return cwd;
-}
-function ensureRelayDir() {
-    if (!fs_1.default.existsSync(RELAY_DIR)) {
-        fs_1.default.mkdirSync(RELAY_DIR, { recursive: true });
-    }
-}
-function loadToken() {
-    const tokenFile = path_1.default.join(RELAY_DIR, 'token');
-    if (!fs_1.default.existsSync(tokenFile))
-        return undefined;
-    try {
-        return fs_1.default.readFileSync(tokenFile, 'utf-8').trim() || undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-function saveToken(token) {
-    ensureRelayDir();
-    fs_1.default.writeFileSync(path_1.default.join(RELAY_DIR, 'token'), token);
-}
-function loadInstalled() {
-    if (!fs_1.default.existsSync(INSTALLED_FILE)) {
-        return {};
-    }
-    try {
-        const raw = fs_1.default.readFileSync(INSTALLED_FILE, 'utf-8');
-        return JSON.parse(raw);
-    }
-    catch {
-        return {};
-    }
-}
-function saveInstalled(registry) {
-    ensureRelayDir();
-    fs_1.default.writeFileSync(INSTALLED_FILE, JSON.stringify(registry, null, 2));
-}

package/dist/lib/guide.d.ts

@@ -1,12 +0,0 @@
-import type { Requires } from '../commands/publish.js';
-interface CommandEntry {
-    name: string;
-    description: string;
-}
-export declare function generateGuide(config: {
-    slug: string;
-    name: string;
-    description: string;
-    version: string;
-}, commands: CommandEntry[], requires?: Requires): string;
-export {};

package/dist/lib/guide.js

@@ -1,60 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateGuide = generateGuide;
-function buildRequiresSummary(requires) {
-    const lines = [];
-    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 names = requires.npm.map((p) => typeof p === 'string' ? p : p.name);
-        lines.push(`- npm: ${names.map((n) => `**${n}**`).join(', ')}`);
-    }
-    for (const env of requires.env ?? []) {
-        const label = env.required === false ? '선택' : '필수';
-        const desc = env.description ? ` — ${env.description}` : '';
-        lines.push(`- env: **${env.name}** (${label})${desc}`);
-    }
-    for (const mcp of requires.mcp ?? []) {
-        const pkg = mcp.package ? ` — \`${mcp.package}\`` : '';
-        lines.push(`- mcp: **${mcp.name}**${pkg}`);
-    }
-    for (const agent of requires.agents ?? []) {
-        lines.push(`- agent: **${agent}**`);
-    }
-    return lines.join('\n');
-}
-function generateGuide(config, commands, requires) {
-    const scopedSlug = config.slug.startsWith('@') ? config.slug : `@${config.slug}`;
-    const installCmd = `npx relayax-cli install ${scopedSlug}`;
-    const requiresSummary = requires ? buildRequiresSummary(requires) : '';
-    const slugPart = scopedSlug.startsWith('@') ? scopedSlug.slice(1) : scopedSlug;
-    const pluginUrl = `https://www.relayax.com/api/registry/${slugPart}/plugin`;
-    return `# ${config.name}
-
-> ${config.description}
-
-## 설치
-
-### CLI
-\`\`\`bash
-${installCmd}
-\`\`\`
-
-### Claude Code Plugin
-\`\`\`
-/plugin marketplace add ${pluginUrl}
-/plugin install ${config.slug.split('/').pop() ?? config.slug}
-\`\`\`
-
-${commands.length > 0 ? `## 포함된 커맨드
-
-${commands.map((cmd) => `- \`/${cmd.name}\`: ${cmd.description}`).join('\n')}
-` : ''}${requiresSummary ? `## 요구사항
-
-${requiresSummary}
-` : ''}---
-*https://relayax.com — Agent Marketplace*
-`;
-}

package/dist/lib/manifest-generator.d.ts

@@ -1,20 +0,0 @@
-export interface GeneratedFile {
-    relativePath: string;
-    content: string;
-}
-export interface ManifestRelayYaml {
-    name: string;
-    slug: string;
-    description: string;
-    version: string;
-    source?: string;
-    org_slug?: string;
-    platforms?: string[];
-}
-export declare const SUPPORTED_PLATFORMS: readonly ["claude-code", "codex", "antigravity"];
-export type Platform = typeof SUPPORTED_PLATFORMS[number];
-/**
- * Generate platform-native manifests from relay.yaml metadata.
- * Used by both `relay publish` and `relay export`.
- */
-export declare function generateManifests(yaml: ManifestRelayYaml, agentDir: string): GeneratedFile[];