relayax-cli 0.3.66 → 0.4.12

package/dist/commands/publish.js

@@ -17,6 +17,8 @@ const version_check_js_1 = require("../lib/version-check.js");
 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");
+const manifest_generator_js_1 = require("../lib/manifest-generator.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');
@@ -50,6 +52,7 @@ function parseRelayYaml(content) {
         type,
         source: raw.source ? String(raw.source) : undefined,
         org_slug: raw.org_slug ? String(raw.org_slug) : undefined,
+        platforms: Array.isArray(raw.platforms) ? raw.platforms.map((p) => String(p)) : undefined,
     };
 }
 function detectCommands(agentDir) {
@@ -552,26 +555,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 +590,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 +616,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) {
@@ -685,6 +699,46 @@ function registerPublish(program) {
         const entrySlug = config.slug.startsWith('@') ? config.slug.slice(1) : config.slug;
         const entryFileName = entrySlug.replace('/', '-') + '.md';
         fs_1.default.writeFileSync(path_1.default.join(commandsDir, entryFileName), entryContent);
+        // Check git is available
+        try {
+            (0, git_operations_js_1.checkGitInstalled)();
+        }
+        catch (gitErr) {
+            const gitMsg = gitErr instanceof Error ? gitErr.message : String(gitErr);
+            (0, error_report_js_1.reportCliError)('publish', 'GIT_NOT_FOUND', gitMsg);
+            if (json) {
+                console.error(JSON.stringify({ error: 'GIT_NOT_FOUND', message: gitMsg }));
+            }
+            else {
+                console.error(`\x1b[31m${gitMsg}\x1b[0m`);
+            }
+            process.exit(1);
+        }
+        // Generate platform manifests (after preamble/command, before git commit)
+        const manifestYaml = {
+            name: config.name,
+            slug: config.slug,
+            description: config.description,
+            version: config.version,
+            source: config.source,
+            org_slug: config.org_slug ?? selectedOrgSlug,
+            platforms: config.platforms,
+        };
+        const manifestFiles = (0, manifest_generator_js_1.generateManifests)(manifestYaml, relayDir);
+        for (const mf of manifestFiles) {
+            const mfPath = path_1.default.join(relayDir, mf.relativePath);
+            fs_1.default.mkdirSync(path_1.default.dirname(mfPath), { recursive: true });
+            fs_1.default.writeFileSync(mfPath, mf.content);
+        }
+        const generatedPlatforms = [...new Set(manifestFiles.map((f) => {
+                if (f.relativePath.startsWith('.claude-plugin/') || f.relativePath === 'marketplace.json')
+                    return 'claude-code';
+                if (f.relativePath.startsWith('.codex-plugin/'))
+                    return 'codex';
+                if (f.relativePath.startsWith('.agent/'))
+                    return 'antigravity';
+                return 'unknown';
+            }))];
         let tarPath = null;
         try {
             tarPath = await createTarball(relayDir);
@@ -692,6 +746,29 @@ function registerPublish(program) {
                 console.error(`업로드 중...`);
             }
             const result = await publishToApi(token, tarPath, metadata);
+            // Git push: commit and push to git server (non-fatal if git server unavailable)
+            try {
+                const gitUrl = result.git_url;
+                if (gitUrl) {
+                    if (!json) {
+                        console.error('git 저장소에 푸시 중...');
+                    }
+                    const isFirstPublish = !result.is_update;
+                    if (isFirstPublish) {
+                        await (0, git_operations_js_1.gitPublishInit)(relayDir, gitUrl, config.version);
+                    }
+                    else {
+                        await (0, git_operations_js_1.gitPublishUpdate)(relayDir, gitUrl, config.version);
+                    }
+                }
+            }
+            catch (gitPushErr) {
+                // Git push failure is non-fatal — tar.gz upload already succeeded
+                if (!json) {
+                    const gpMsg = gitPushErr instanceof Error ? gitPushErr.message : String(gitPushErr);
+                    console.error(`\x1b[33m⚠ git push 실패 (배포는 완료됨): ${gpMsg}\x1b[0m`);
+                }
+            }
             // Update entry command preamble with scoped slug from server (non-fatal)
             try {
                 if (result.slug && result.slug !== config.slug) {
@@ -713,6 +790,17 @@ function registerPublish(program) {
                 console.log(`\n\x1b[32m✓ ${config.name} 배포 완료\x1b[0m  v${result.version}`);
                 console.log(`  슬러그: \x1b[36m${result.slug}\x1b[0m`);
                 console.log(`  URL:    \x1b[36m${result.url}\x1b[0m`);
+                // Show generated platform manifests
+                if (generatedPlatforms.length > 0) {
+                    console.log(`\n  \x1b[90m플랫폼 매니페스트:\x1b[0m ${generatedPlatforms.join(', ')}`);
+                }
+                // Show Claude Code plugin install command if claude-code manifest was generated
+                if (generatedPlatforms.includes('claude-code')) {
+                    const pluginSlug = result.slug.startsWith('@') ? result.slug.slice(1) : result.slug;
+                    const pluginUrl = `${config_js_1.API_URL}/api/registry/@${pluginSlug}/plugin`;
+                    console.log(`\n  \x1b[90mClaude Code 플러그인:\x1b[0m`);
+                    console.log(`  \x1b[36m/plugin marketplace add ${pluginUrl}\x1b[0m`);
+                }
                 // Show shareable onboarding guide as a plain copyable block
                 if (isTTY) {
                     const detailSlug = result.slug.startsWith('@') ? result.slug.slice(1) : result.slug;

package/dist/commands/update.js

@@ -9,6 +9,7 @@ const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
 const api_js_1 = require("../lib/api.js");
 const storage_js_1 = require("../lib/storage.js");
+const git_operations_js_1 = require("../lib/git-operations.js");
 const installer_js_1 = require("../lib/installer.js");
 const config_js_1 = require("../lib/config.js");
 const slug_js_1 = require("../lib/slug.js");
@@ -76,13 +77,30 @@ function registerUpdate(program) {
             const agentDir = currentScope === 'global'
                 ? path_1.default.join(os_1.default.homedir(), '.relay', 'agents', owner, name)
                 : path_1.default.join(projectPath, '.relay', 'agents', owner, name);
-            // Download & extract
-            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 });
+            // Download & extract: prefer git, fallback to tar.gz
+            if (agent.git_url && fs_1.default.existsSync(path_1.default.join(agentDir, '.git'))) {
+                // Existing git clone — fetch + checkout latest tag
+                (0, git_operations_js_1.checkGitInstalled)();
+                (0, git_operations_js_1.gitFetch)(agentDir);
+                const latestTag = (0, git_operations_js_1.gitLatestTag)(agentDir);
+                if (latestTag) {
+                    (0, git_operations_js_1.gitCheckout)(agentDir, latestTag);
+                }
+            }
+            else if (agent.git_url) {
+                // No existing clone — fresh git clone
+                (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);
             }
-            fs_1.default.mkdirSync(agentDir, { recursive: true });
-            await (0, storage_js_1.extractPackage)(tarPath, agentDir);
             // Inject preamble
             (0, preamble_js_1.injectPreambleToAgent)(agentDir, slug);
             // Deploy symlinks (always — handles migration from legacy deployed_files)

package/dist/index.js

@@ -24,6 +24,7 @@ const access_js_1 = require("./commands/access.js");
 const grant_js_1 = require("./commands/grant.js");
 const versions_js_1 = require("./commands/versions.js");
 const diff_js_1 = require("./commands/diff.js");
+const export_js_1 = require("./commands/export.js");
 const feedback_js_1 = require("./commands/feedback.js");
 const server_js_1 = require("./mcp/server.js");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
@@ -56,6 +57,7 @@ program
 (0, grant_js_1.registerGrant)(program);
 (0, versions_js_1.registerVersions)(program);
 (0, diff_js_1.registerDiff)(program);
+(0, export_js_1.registerExport)(program);
 (0, feedback_js_1.registerFeedback)(program);
 program
     .command('mcp')

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/lib/git-operations.d.ts

@@ -0,0 +1,38 @@
+export declare function checkGitInstalled(): void;
+export declare function gitInit(dir: string): void;
+export declare function gitClone(url: string, destDir: string, opts?: {
+    depth?: number;
+}): void;
+export declare function gitAdd(dir: string, files?: string): void;
+export declare function gitCommit(dir: string, message: string): void;
+export declare function gitTag(dir: string, tag: string): void;
+export declare function gitPush(dir: string, remote: string, refspec?: string): void;
+export declare function gitFetch(dir: string): void;
+export declare function gitCheckout(dir: string, ref: string): void;
+export declare function gitDiff(dir: string, from: string, to: string): string;
+export declare function gitLatestTag(dir: string): string | null;
+/**
+ * Build an authenticated git URL.
+ * For public repos: https://git.relayax.com/@owner/agent.git
+ * For gated/private: https://TOKEN:x@git.relayax.com/@owner/agent.git
+ */
+export declare function buildGitUrl(baseUrl: string, auth?: {
+    token?: string;
+    code?: string;
+}): string;
+/**
+ * First-time publish: init → add → commit → tag → push
+ */
+export declare function gitPublishInit(sourceDir: string, remoteUrl: string, version: string): Promise<void>;
+/**
+ * Re-publish: clone → replace files → commit → tag → push
+ */
+export declare function gitPublishUpdate(sourceDir: string, remoteUrl: string, version: string): Promise<void>;
+/**
+ * Install: git clone to destination, optionally checkout a specific version.
+ */
+export declare function gitInstall(gitUrl: string, destDir: string, version?: string): Promise<void>;
+/**
+ * Update: fetch latest then checkout the newest tag.
+ */
+export declare function gitUpdate(destDir: string): Promise<string | null>;

package/dist/lib/git-operations.js

@@ -0,0 +1,168 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkGitInstalled = checkGitInstalled;
+exports.gitInit = gitInit;
+exports.gitClone = gitClone;
+exports.gitAdd = gitAdd;
+exports.gitCommit = gitCommit;
+exports.gitTag = gitTag;
+exports.gitPush = gitPush;
+exports.gitFetch = gitFetch;
+exports.gitCheckout = gitCheckout;
+exports.gitDiff = gitDiff;
+exports.gitLatestTag = gitLatestTag;
+exports.buildGitUrl = buildGitUrl;
+exports.gitPublishInit = gitPublishInit;
+exports.gitPublishUpdate = gitPublishUpdate;
+exports.gitInstall = gitInstall;
+exports.gitUpdate = gitUpdate;
+const child_process_1 = require("child_process");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+// ─── Git Binary Check ───
+function checkGitInstalled() {
+    try {
+        (0, child_process_1.execFileSync)('git', ['--version'], { stdio: 'pipe' });
+    }
+    catch {
+        throw new Error('git이 설치되어 있지 않습니다.\n' +
+            '  macOS: xcode-select --install\n' +
+            '  Ubuntu/Debian: sudo apt install git\n' +
+            '  Windows: https://git-scm.com/download/win');
+    }
+}
+// ─── Core Git Operations ───
+function gitInit(dir) {
+    (0, child_process_1.execFileSync)('git', ['init'], { cwd: dir, stdio: 'pipe' });
+}
+function gitClone(url, destDir, opts) {
+    const args = ['clone'];
+    if (opts?.depth) {
+        args.push('--depth', String(opts.depth));
+    }
+    args.push(url, destDir);
+    (0, child_process_1.execFileSync)('git', args, { stdio: 'pipe' });
+}
+function gitAdd(dir, files = '.') {
+    (0, child_process_1.execFileSync)('git', ['add', files], { cwd: dir, stdio: 'pipe' });
+}
+function gitCommit(dir, message) {
+    // Configure committer for the temp repo
+    (0, child_process_1.execFileSync)('git', ['config', 'user.email', 'relay@relayax.com'], { cwd: dir, stdio: 'pipe' });
+    (0, child_process_1.execFileSync)('git', ['config', 'user.name', 'Relay CLI'], { cwd: dir, stdio: 'pipe' });
+    (0, child_process_1.execFileSync)('git', ['commit', '-m', message], { cwd: dir, stdio: 'pipe' });
+}
+function gitTag(dir, tag) {
+    (0, child_process_1.execFileSync)('git', ['tag', tag], { cwd: dir, stdio: 'pipe' });
+}
+function gitPush(dir, remote, refspec) {
+    const args = ['push', remote];
+    if (refspec)
+        args.push(refspec);
+    args.push('--tags');
+    (0, child_process_1.execFileSync)('git', args, { cwd: dir, stdio: 'pipe' });
+}
+function gitFetch(dir) {
+    (0, child_process_1.execFileSync)('git', ['fetch', '--tags'], { cwd: dir, stdio: 'pipe' });
+}
+function gitCheckout(dir, ref) {
+    (0, child_process_1.execFileSync)('git', ['checkout', ref], { cwd: dir, stdio: 'pipe' });
+}
+function gitDiff(dir, from, to) {
+    return (0, child_process_1.execFileSync)('git', ['diff', `${from}..${to}`], {
+        cwd: dir,
+        encoding: 'utf-8',
+        maxBuffer: 10 * 1024 * 1024,
+    });
+}
+function gitLatestTag(dir) {
+    try {
+        const result = (0, child_process_1.execFileSync)('git', ['describe', '--tags', '--abbrev=0'], {
+            cwd: dir,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        return result || null;
+    }
+    catch {
+        return null;
+    }
+}
+// ─── High-level Operations ───
+/**
+ * Build an authenticated git URL.
+ * For public repos: https://git.relayax.com/@owner/agent.git
+ * For gated/private: https://TOKEN:x@git.relayax.com/@owner/agent.git
+ */
+function buildGitUrl(baseUrl, auth) {
+    if (!auth?.token && !auth?.code)
+        return baseUrl;
+    const url = new URL(baseUrl);
+    const credential = auth.token ?? auth.code ?? '';
+    url.username = credential;
+    url.password = 'x';
+    return url.toString();
+}
+/**
+ * First-time publish: init → add → commit → tag → push
+ */
+async function gitPublishInit(sourceDir, remoteUrl, version) {
+    gitInit(sourceDir);
+    gitAdd(sourceDir);
+    gitCommit(sourceDir, `v${version}`);
+    gitTag(sourceDir, `v${version}`);
+    gitPush(sourceDir, remoteUrl, 'HEAD:main');
+}
+/**
+ * Re-publish: clone → replace files → commit → tag → push
+ */
+async function gitPublishUpdate(sourceDir, remoteUrl, version) {
+    const tempCloneDir = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'relay-git-'));
+    try {
+        // Clone existing repo
+        gitClone(remoteUrl, tempCloneDir);
+        // Copy .git directory to source dir
+        const gitDir = path_1.default.join(tempCloneDir, '.git');
+        const destGitDir = path_1.default.join(sourceDir, '.git');
+        fs_1.default.cpSync(gitDir, destGitDir, { recursive: true });
+        // Add all files (including new/changed, removing deleted)
+        gitAdd(sourceDir);
+        gitCommit(sourceDir, `v${version}`);
+        gitTag(sourceDir, `v${version}`);
+        gitPush(sourceDir, 'origin');
+    }
+    finally {
+        fs_1.default.rmSync(tempCloneDir, { recursive: true, force: true });
+    }
+}
+/**
+ * Install: git clone to destination, optionally checkout a specific version.
+ */
+async function gitInstall(gitUrl, destDir, version) {
+    // Remove existing directory if present
+    if (fs_1.default.existsSync(destDir)) {
+        fs_1.default.rmSync(destDir, { recursive: true, force: true });
+    }
+    fs_1.default.mkdirSync(path_1.default.dirname(destDir), { recursive: true });
+    gitClone(gitUrl, destDir, { depth: 1 });
+    if (version) {
+        // Fetch all tags then checkout the specific version
+        gitFetch(destDir);
+        gitCheckout(destDir, `v${version}`);
+    }
+}
+/**
+ * Update: fetch latest then checkout the newest tag.
+ */
+async function gitUpdate(destDir) {
+    gitFetch(destDir);
+    const latestTag = gitLatestTag(destDir);
+    if (latestTag) {
+        gitCheckout(destDir, latestTag);
+    }
+    return latestTag;
+}

package/dist/lib/guide.js

@@ -29,16 +29,25 @@ 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')}

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

@@ -0,0 +1,20 @@
+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[];