relayax-cli 0.4.24 → 0.4.26

package/dist/commands/publish.d.ts

@@ -27,6 +27,7 @@ export interface RequiresEnv {
     name: string;
     required?: boolean;
     description?: string;
+    setup_hint?: string;
 }
 export interface RequiresNpm {
     name: string;
@@ -74,7 +75,6 @@ export interface PublishMetadata {
     skill_details?: SkillDetail[];
     org_slug?: string;
 }
-export declare function createTarball(agentDir: string): Promise<string>;
 interface PublishResult {
     status: string;
     slug: string;
@@ -88,6 +88,6 @@ interface PublishResult {
         default_welcome?: string;
     } | null;
 }
-export declare function publishToApi(token: string, tarPath: string, metadata: PublishMetadata): Promise<PublishResult>;
+export declare function publishToApi(token: string, metadata: PublishMetadata): Promise<PublishResult>;
 export declare function registerPublish(program: Command): void;
 export {};

package/dist/commands/publish.js

@@ -3,14 +3,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createTarball = createTarball;
 exports.publishToApi = publishToApi;
 exports.registerPublish = registerPublish;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
-const os_1 = __importDefault(require("os"));
 const js_yaml_1 = __importDefault(require("js-yaml"));
-const tar_1 = require("tar");
 const config_js_1 = require("../lib/config.js");
 const preamble_js_1 = require("../lib/preamble.js");
 const version_check_js_1 = require("../lib/version-check.js");
@@ -18,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");
-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');
@@ -52,7 +48,6 @@ 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) {
@@ -250,34 +245,14 @@ function resolveLongDescription(agentDir, yamlValue) {
     }
     return undefined;
 }
-async function createTarball(agentDir) {
-    const tmpFile = path_1.default.join(os_1.default.tmpdir(), `relay-publish-${Date.now()}.tar.gz`);
-    const dirsToInclude = VALID_DIRS.filter((d) => fs_1.default.existsSync(path_1.default.join(agentDir, d)));
-    // Include root-level files if they exist
-    const entries = [...dirsToInclude];
-    const rootFiles = ['relay.yaml', 'SKILL.md', 'guide.md'];
-    for (const file of rootFiles) {
-        if (fs_1.default.existsSync(path_1.default.join(agentDir, file))) {
-            entries.push(file);
-        }
-    }
-    await (0, tar_1.create)({
-        gzip: true,
-        file: tmpFile,
-        cwd: agentDir,
-    }, entries);
-    return tmpFile;
-}
-async function publishToApi(token, tarPath, metadata) {
-    const fileBuffer = fs_1.default.readFileSync(tarPath);
-    const blob = new Blob([fileBuffer], { type: 'application/gzip' });
-    const form = new FormData();
-    form.append('package', blob, `${metadata.slug}-${metadata.version}.tar.gz`);
-    form.append('metadata', JSON.stringify(metadata));
+async function publishToApi(token, metadata) {
     const res = await fetch(`${config_js_1.API_URL}/api/publish`, {
         method: 'POST',
-        headers: { Authorization: `Bearer ${token}` },
-        body: form,
+        headers: {
+            Authorization: `Bearer ${token}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify(metadata),
         redirect: 'error',
     });
     const body = await res.json();
@@ -442,6 +417,27 @@ function registerPublish(program) {
                 console.error(`  → relay.yaml에 version: ${newVersion} 저장됨\n`);
             }
         }
+        // Auto-sync: relay.yaml의 contents에 정의된 소스를 .relay/에 동기화
+        try {
+            const yamlContent = fs_1.default.readFileSync(relayYamlPath, 'utf-8');
+            const yamlConfig = js_yaml_1.default.load(yamlContent);
+            const contents = yamlConfig.contents ?? [];
+            if (contents.length > 0) {
+                const { computeContentsDiff, syncContentsToRelay } = await import('./package.js');
+                const { diff: contentsDiff } = computeContentsDiff(contents, relayDir, agentDir);
+                const hasChanges = contentsDiff.some((d) => d.status === 'modified');
+                if (hasChanges) {
+                    syncContentsToRelay(contents, contentsDiff, relayDir, agentDir);
+                    if (!json) {
+                        const changedNames = contentsDiff.filter((d) => d.status === 'modified').map((d) => d.name);
+                        console.error(`\x1b[36m⚙ 소스 동기화:\x1b[0m ${changedNames.join(', ')}`);
+                    }
+                }
+            }
+        }
+        catch {
+            // sync 실패는 non-fatal — 기존 .relay/ 내용으로 publish 진행
+        }
         // Validate structure (콘텐츠는 .relay/ 안에 있음)
         const hasDirs = VALID_DIRS.some((d) => {
             const dirPath = path_1.default.join(relayDir, d);
@@ -709,10 +705,7 @@ function registerPublish(program) {
             console.error('\x1b[33m⚠ GUIDE.html은 더 이상 지원되지 않습니다. 상세페이지가 가이드 역할을 합니다.\x1b[0m');
             console.error('  long_description을 활용하거나 relayax.com에서 에이전트 정보를 편집하세요.\n');
         }
-        // Generate guide.md (consumer install guide)
-        const { generateGuide } = await import('../lib/guide.js');
-        const guideContent = generateGuide(config, detectedCommands, config.requires);
-        fs_1.default.writeFileSync(path_1.default.join(relayDir, 'guide.md'), guideContent);
+        // 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)
@@ -740,38 +733,11 @@ function registerPublish(program) {
             }
             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);
             if (!json) {
                 console.error(`업로드 중...`);
             }
-            const result = await publishToApi(token, tarPath, metadata);
+            const result = await publishToApi(token, metadata);
             // Git push: commit and push to git server (required)
             const gitUrlRaw = result.git_url;
             if (gitUrlRaw) {
@@ -815,9 +781,7 @@ function registerPublish(program) {
                 // preamble update is best-effort — publish already succeeded
             }
             if (json) {
-                const jsonResult = { ...result };
-                jsonResult.platforms = generatedPlatforms;
-                console.log(JSON.stringify(jsonResult));
+                console.log(JSON.stringify(result));
             }
             else {
                 console.log(`\n\x1b[32m✓ ${config.name} 배포 완료\x1b[0m  v${result.version}`);
@@ -827,7 +791,6 @@ function registerPublish(program) {
                 {
                     const detailSlug = result.slug.startsWith('@') ? result.slug.slice(1) : result.slug;
                     const accessCode = result.access_code ?? null;
-                    // const gitUrl = (result as unknown as Record<string, unknown>).git_url as string | undefined // plugin disabled
                     // npx turnkey install command (works everywhere, no pre-install needed)
                     const visibility = config.visibility ?? 'public';
                     let npxInstallCmd;
@@ -865,10 +828,5 @@ function registerPublish(program) {
             console.error(JSON.stringify({ error: 'PUBLISH_FAILED', message, fix: message }));
             process.exit(1);
         }
-        finally {
-            if (tarPath && fs_1.default.existsSync(tarPath)) {
-                fs_1.default.unlinkSync(tarPath);
-            }
-        }
     });
 }

package/dist/commands/update.js

@@ -93,13 +93,7 @@ function registerUpdate(program) {
                 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);
+                throw new Error('이 에이전트는 재설치가 필요합니다. relay install로 다시 설치하세요.');
             }
             // Inject preamble
             (0, preamble_js_1.injectPreambleToAgent)(agentDir, slug);

package/dist/index.js

@@ -24,7 +24,6 @@ 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
@@ -57,7 +56,6 @@ 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/api.js

@@ -110,10 +110,12 @@ async function sendUsagePing(agentId, slug, version) {
     const deviceHash = createHash('sha256')
         .update(`${hostname()}:${userInfo().username}`)
         .digest('hex');
+    // CLI version
+    const pkg = require('../../package.json');
     // agentId(UUID)가 있으면 UUID 경로, 없으면 slug name으로 fallback
     const pathParam = agentId || slug.replace(/^@/, '').split('/').pop() || slug;
     const url = `${config_js_1.API_URL}/api/agents/${pathParam}/ping`;
-    const payload = { device_hash: deviceHash, slug };
+    const payload = { device_hash: deviceHash, slug, cli_version: pkg.version };
     if (version)
         payload.installed_version = version;
     const headers = { 'Content-Type': 'application/json' };

package/dist/lib/command-adapter.js

@@ -13,37 +13,6 @@ exports.formatCommandFile = formatCommandFile;
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
 const index_js_1 = require("../prompts/index.js");
-/**
- * 환경 감지 프리앰블.
- * slash command 실행 시 MCP tool 사용 가능 여부를 먼저 판별하여,
- * 이후 모든 CLI 명령어를 적절한 방식으로 실행하도록 안내.
- */
-const ENV_PREAMBLE = `## 환경 감지
-
-이 커맨드를 실행하기 전에 환경을 판별하세요:
-
-1. **relay MCP tool 사용 가능 여부 확인**: relay_status 같은 relay MCP tool을 호출할 수 있는지 확인하세요.
-   - 사용 가능 → **MCP 모드**로 실행 (아래 표 참고)
-   - 사용 불가 → **CLI 모드**로 실행 (bash 명령어 그대로 사용)
-
-2. MCP 모드에서의 명령어 변환:
-
-| CLI 명령어 | MCP tool |
-|---|---|
-| \`relay status\` | \`relay_status\` tool 호출 |
-| \`relay list --json\` | \`relay_list\` tool 호출 |
-| \`relay search <keyword>\` | \`relay_search\` tool 호출 |
-| \`relay install <slug>\` | \`relay_install\` tool 호출 |
-| \`relay uninstall <slug>\` | \`relay_uninstall\` tool 호출 |
-| \`relay package --init\` | \`relay_scan\` tool 호출 |
-| \`relay publish\` | \`relay_publish\` tool 호출 |
-| \`relay login\` | \`relay_login\` tool 호출 |
-
-**중요**: 이후 지시에서 \`relay <명령어>\`로 표기된 것은 판별된 환경에 따라 변환하여 실행하세요.
-
----
-
-`;
 /**
  * 로컬 어댑터 — 프로젝트 디렉토리 기준.
  * {projectPath}/{skillsDir}/commands/relay/{id}.md
@@ -101,7 +70,7 @@ exports.USER_COMMANDS = [
     {
         id: 'relay-status',
         description: '설치된 에이전트와 Organization 현황을 확인합니다',
-        body: ENV_PREAMBLE + `현재 설치된 에이전트와 소속 Organization 현황을 한눈에 보여줍니다.
+        body: `현재 설치된 에이전트와 소속 Organization 현황을 한눈에 보여줍니다.
 
 ## 실행 방법
 
@@ -154,7 +123,6 @@ exports.USER_COMMANDS = [
 
 **표시:**
 - \`role\`: owner → 오너, admin → 관리자, builder → 빌더, member → 멤버
-${index_js_1.ERROR_HANDLING_GUIDE}
 - Org 조회 실패해도 설치된 에이전트 목록은 정상 표시합니다 (로컬 데이터).
 
 ### 3. Org 에이전트 목록 (옵션)
@@ -190,7 +158,7 @@ ${index_js_1.ERROR_HANDLING_GUIDE}
     {
         id: 'relay-uninstall',
         description: '설치된 에이전트를 삭제합니다',
-        body: ENV_PREAMBLE + `설치된 에이전트를 제거합니다. CLI가 패키지와 배치된 파일을 모두 정리합니다.
+        body: `설치된 에이전트를 제거합니다. CLI가 패키지와 배치된 파일을 모두 정리합니다.
 
 ## 실행 방법
 

package/dist/lib/git-operations.js

@@ -148,7 +148,7 @@ async function gitPublishUpdate(sourceDir, remoteUrl, version) {
         gitAdd(sourceDir);
         gitCommit(sourceDir, `v${version}`);
         gitTag(sourceDir, `v${version}`);
-        gitPush(sourceDir, 'origin');
+        gitPush(sourceDir, 'origin', 'HEAD:main');
     }
     finally {
         fs_1.default.rmSync(tempCloneDir, { recursive: true, force: true });

package/dist/lib/installer.js

@@ -190,10 +190,11 @@ function checkRequires(agentDir) {
             }
             else {
                 const desc = env.description ? ` (${env.description})` : '';
+                const hint = env.setup_hint ? `\n    설정 방법:\n${env.setup_hint.split('\n').map((l) => `      ${l}`).join('\n')}` : '';
                 results.push({
                     label: 'env',
                     status: env.required !== false ? 'missing' : 'warn',
-                    message: `${env.name} — 미설정${desc}`,
+                    message: `${env.name} — 미설정${desc}${hint}`,
                 });
             }
         }

package/dist/lib/preamble.js

@@ -43,16 +43,24 @@ 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)
 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}\\"}" \\
+    -d "{\\"device_hash\\":\\"$DEVICE_HASH\\",\\"slug\\":\\"${slug}\\"$_CLI_VER_FIELD}" \\
     2>/dev/null &
 fi
 
@@ -78,8 +86,6 @@ function generatePreamble(slug, agentDir) {
 [ -f "${scriptPath}" ] && bash "${scriptPath}" 2>/dev/null || true
 \`\`\`
 
-If the bash command above fails or the file is not found (sandbox/MCP environment), use the \`relay_check_update\` MCP tool instead: \`relay_check_update(slug: "${slug}")\`
-
 If output shows \`CLI_UPGRADE_AVAILABLE <old> <new>\`: tell user "relay v{new} available. Run: npm update -g relayax-cli"
 If output shows \`AGENT_UPGRADE_AVAILABLE\`: tell user "${slug} v{new} available (by @{author}). Run: relay update ${slug}"
 ${PREAMBLE_END}`;

package/dist/lib/storage.d.ts

@@ -1,9 +1,6 @@
-export declare function downloadPackage(url: string, destDir: string): Promise<string>;
-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

@@ -3,49 +3,20 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-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"));
-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) {
-        throw new Error(`패키지 다운로드 실패 (${res.status}): ${url}`);
-    }
-    const fileName = path_1.default.basename(new URL(url).pathname) || 'package.tar.gz';
-    const destPath = path_1.default.join(destDir, fileName);
-    const body = res.body;
-    if (!body) {
-        throw new Error('응답 본문이 비어 있습니다');
-    }
-    const nodeReadable = stream_1.Readable.fromWeb(body);
-    await (0, promises_1.pipeline)(nodeReadable, (0, fs_2.createWriteStream)(destPath));
-    return destPath;
-}
-async function extractPackage(tarPath, destDir) {
-    if (!fs_1.default.existsSync(destDir)) {
-        fs_1.default.mkdirSync(destDir, { recursive: true });
-    }
-    await (0, tar_1.extract)({ file: tarPath, cwd: destDir });
-}
 function makeTempDir() {
-    return fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'relay-'));
+    return fs_1.default.mkdtempSync(os_1.default.tmpdir() + '/relay-');
 }
 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);