relayax-cli 0.1.95 → 0.1.96

package/dist/commands/init.js

@@ -93,87 +93,6 @@ function isTeamProject(projectPath) {
         return fs_1.default.readdirSync(dirPath).filter((f) => !f.startsWith('.')).length > 0;
     });
 }
-/** 레거시 User 커맨드 ID (이전에 로컬에 설치되던 것) */
-const LEGACY_LOCAL_COMMAND_IDS = ['relay-explore', 'relay-install', 'relay-publish'];
-/**
- * 레거시 구조를 감지하고 마이그레이션한다.
- * - relay.yaml (루트) → .relay/relay.yaml
- * - portfolio/ (루트) → .relay/portfolio/
- * - 로컬 레거시 슬래시 커맨드 제거 (글로벌로 이동되므로)
- */
-/** 루트에 있으면 .relay/ 안으로 옮길 디렉토리 */
-const LEGACY_CONTENT_DIRS = ['skills', 'agents', 'rules', 'commands', 'portfolio'];
-function detectLegacy(projectPath) {
-    const details = [];
-    if (fs_1.default.existsSync(path_1.default.join(projectPath, 'relay.yaml'))) {
-        details.push('relay.yaml → .relay/relay.yaml');
-    }
-    for (const dir of LEGACY_CONTENT_DIRS) {
-        const legacyDir = path_1.default.join(projectPath, dir);
-        if (fs_1.default.existsSync(legacyDir) && fs_1.default.statSync(legacyDir).isDirectory()) {
-            const hasFiles = fs_1.default.readdirSync(legacyDir).filter((f) => !f.startsWith('.')).length > 0;
-            if (hasFiles) {
-                details.push(`${dir}/ → .relay/${dir}/`);
-            }
-        }
-    }
-    // 로컬에 레거시 슬래시 커맨드가 있는지 확인
-    const detected = (0, ai_tools_js_1.detectAgentCLIs)(projectPath);
-    for (const tool of detected) {
-        const cmdDir = path_1.default.join(projectPath, tool.skillsDir, 'commands', 'relay');
-        if (!fs_1.default.existsSync(cmdDir))
-            continue;
-        for (const cmdId of LEGACY_LOCAL_COMMAND_IDS) {
-            if (fs_1.default.existsSync(path_1.default.join(cmdDir, `${cmdId}.md`))) {
-                details.push(`${tool.skillsDir}/commands/relay/ 레거시 커맨드 정리`);
-                break;
-            }
-        }
-    }
-    return { hasLegacy: details.length > 0, details };
-}
-function runMigration(projectPath) {
-    const result = { relayYaml: false, portfolio: false, localCommandsCleaned: 0 };
-    const relayDir = path_1.default.join(projectPath, '.relay');
-    fs_1.default.mkdirSync(relayDir, { recursive: true });
-    // 1. relay.yaml 이동
-    const legacyYaml = path_1.default.join(projectPath, 'relay.yaml');
-    const newYaml = path_1.default.join(relayDir, 'relay.yaml');
-    if (fs_1.default.existsSync(legacyYaml) && !fs_1.default.existsSync(newYaml)) {
-        fs_1.default.renameSync(legacyYaml, newYaml);
-        result.relayYaml = true;
-    }
-    // 2. 콘텐츠 디렉토리 이동 (skills, agents, rules, commands, portfolio)
-    for (const dir of LEGACY_CONTENT_DIRS) {
-        const legacyDir = path_1.default.join(projectPath, dir);
-        const newDir = path_1.default.join(relayDir, dir);
-        if (fs_1.default.existsSync(legacyDir) && fs_1.default.statSync(legacyDir).isDirectory() && !fs_1.default.existsSync(newDir)) {
-            fs_1.default.renameSync(legacyDir, newDir);
-            if (dir === 'portfolio')
-                result.portfolio = true;
-        }
-    }
-    // 3. 로컬 레거시 슬래시 커맨드 제거
-    const detected = (0, ai_tools_js_1.detectAgentCLIs)(projectPath);
-    for (const tool of detected) {
-        const cmdDir = path_1.default.join(projectPath, tool.skillsDir, 'commands', 'relay');
-        if (!fs_1.default.existsSync(cmdDir))
-            continue;
-        for (const cmdId of LEGACY_LOCAL_COMMAND_IDS) {
-            const cmdPath = path_1.default.join(cmdDir, `${cmdId}.md`);
-            if (fs_1.default.existsSync(cmdPath)) {
-                fs_1.default.unlinkSync(cmdPath);
-                result.localCommandsCleaned++;
-            }
-        }
-        // 디렉토리가 비었으면 삭제
-        const remaining = fs_1.default.readdirSync(cmdDir);
-        if (remaining.length === 0) {
-            fs_1.default.rmdirSync(cmdDir);
-        }
-    }
-    return result;
-}
 function registerInit(program) {
     program
         .command('init')
@@ -183,42 +102,6 @@ function registerInit(program) {
         .action(async (opts) => {
         const json = program.opts().json ?? false;
         const projectPath = process.cwd();
-        // ── 0. 레거시 마이그레이션 ──
-        const legacy = detectLegacy(projectPath);
-        let migrated = false;
-        if (legacy.hasLegacy) {
-            if (json) {
-                // JSON 모드: 자동 마이그레이션
-                const migrationResult = runMigration(projectPath);
-                migrated = migrationResult.relayYaml || migrationResult.portfolio || migrationResult.localCommandsCleaned > 0;
-            }
-            else if (process.stdin.isTTY) {
-                console.log('\n  \x1b[33m⚠ 레거시 구조 감지\x1b[0m\n');
-                for (const d of legacy.details) {
-                    console.log(`    ${d}`);
-                }
-                console.log();
-                const { confirm } = await import('@inquirer/prompts');
-                const doMigrate = await confirm({ message: '마이그레이션할까요?', default: true });
-                if (doMigrate) {
-                    const migrationResult = runMigration(projectPath);
-                    migrated = true;
-                    console.log(`\n  \x1b[32m✓ 마이그레이션 완료\x1b[0m`);
-                    if (migrationResult.relayYaml)
-                        console.log('    relay.yaml → .relay/relay.yaml');
-                    if (migrationResult.portfolio)
-                        console.log('    portfolio/ → .relay/portfolio/');
-                    if (migrationResult.localCommandsCleaned > 0)
-                        console.log(`    레거시 로컬 커맨드 ${migrationResult.localCommandsCleaned}개 제거`);
-                    console.log();
-                }
-            }
-            else {
-                // 비TTY, 비JSON: 자동 마이그레이션
-                const migrationResult = runMigration(projectPath);
-                migrated = migrationResult.relayYaml || migrationResult.portfolio || migrationResult.localCommandsCleaned > 0;
-            }
-        }
         const detected = (0, ai_tools_js_1.detectAgentCLIs)(projectPath);
         const detectedIds = new Set(detected.map((t) => t.value));
         const isBuilder = isTeamProject(projectPath);
@@ -303,7 +186,6 @@ function registerInit(program) {
             console.log(JSON.stringify({
                 status: 'ok',
                 mode: isBuilder ? 'builder' : 'user',
-                migrated,
                 global: {
                     status: globalStatus,
                     path: (0, command_adapter_js_1.getGlobalCommandDir)(),

package/dist/commands/publish.js

@@ -21,13 +21,34 @@ function parseRelayYaml(content) {
     const tags = Array.isArray(raw.tags)
         ? raw.tags.map((t) => String(t))
         : [];
-    const portfolio = Array.isArray(raw.portfolio)
-        ? raw.portfolio.map((p) => ({
-            path: String(p.path ?? ''),
-            title: String(p.title ?? ''),
-            description: p.description ? String(p.description) : undefined,
-        })).filter((p) => p.path)
-        : [];
+    // Parse portfolio slots structure
+    const rawPortfolio = raw.portfolio;
+    const portfolio = {};
+    if (rawPortfolio && typeof rawPortfolio === 'object' && !Array.isArray(rawPortfolio)) {
+        // New slot-based format: { cover: {...}, demo: {...}, gallery: [...] }
+        if (rawPortfolio.cover && typeof rawPortfolio.cover === 'object') {
+            const c = rawPortfolio.cover;
+            if (c.path)
+                portfolio.cover = { path: String(c.path) };
+        }
+        if (rawPortfolio.demo && typeof rawPortfolio.demo === 'object') {
+            const d = rawPortfolio.demo;
+            portfolio.demo = {
+                type: String(d.type ?? 'gif'),
+                path: d.path ? String(d.path) : undefined,
+                url: d.url ? String(d.url) : undefined,
+            };
+        }
+        if (Array.isArray(rawPortfolio.gallery)) {
+            portfolio.gallery = rawPortfolio.gallery
+                .map((g) => ({
+                path: String(g.path ?? ''),
+                title: String(g.title ?? ''),
+                description: g.description ? String(g.description) : undefined,
+            }))
+                .filter((g) => g.path);
+        }
+    }
     const requires = raw.requires;
     const rawVisibility = String(raw.visibility ?? '');
     const visibility = rawVisibility === 'login-only' ? 'login-only'
@@ -86,28 +107,58 @@ function countDir(teamDir, dirName) {
     return fs_1.default.readdirSync(dirPath).filter((f) => !f.startsWith('.')).length;
 }
 /**
- * 포트폴리오 이미지를 수집한다.
- * 1. relay.yaml에 portfolio 섹션이 있으면 사용
- * 2. 없으면 ./portfolio/ 디렉토리 자동 스캔
+ * 슬롯 기반 포트폴리오를 PortfolioEntry[] 로 평탄화한다.
+ * relay.yaml에 슬롯이 정의되어 있으면 사용, 없으면 portfolio/ 자동 스캔.
  */
-function collectPortfolio(teamDir, yamlPortfolio) {
-    if (yamlPortfolio.length > 0) {
-        return yamlPortfolio.filter((p) => {
-            const absPath = path_1.default.resolve(teamDir, p.path);
-            return fs_1.default.existsSync(absPath);
-        });
+function collectPortfolio(relayDir, slots) {
+    const entries = [];
+    // Cover
+    if (slots.cover?.path) {
+        const absPath = path_1.default.resolve(relayDir, slots.cover.path);
+        if (fs_1.default.existsSync(absPath)) {
+            entries.push({ path: slots.cover.path, title: 'Cover', slot_type: 'cover' });
+        }
     }
-    // Auto-scan .relay/portfolio/
-    const portfolioDir = path_1.default.join(teamDir, '.relay', 'portfolio');
-    if (!fs_1.default.existsSync(portfolioDir))
-        return [];
-    const files = fs_1.default.readdirSync(portfolioDir)
-        .filter((f) => IMAGE_EXTS.some((ext) => f.toLowerCase().endsWith(ext)))
-        .sort();
-    return files.map((f) => ({
-        path: path_1.default.join('.relay', 'portfolio', f),
-        title: path_1.default.basename(f, path_1.default.extname(f)).replace(/[-_]/g, ' '),
-    }));
+    // Demo
+    if (slots.demo) {
+        if (slots.demo.type === 'video_url' && slots.demo.url) {
+            entries.push({ path: '', title: 'Demo', slot_type: 'demo', demo_url: slots.demo.url });
+        }
+        else if (slots.demo.path) {
+            const absPath = path_1.default.resolve(relayDir, slots.demo.path);
+            if (fs_1.default.existsSync(absPath)) {
+                entries.push({ path: slots.demo.path, title: 'Demo', slot_type: 'demo' });
+            }
+        }
+    }
+    // Gallery
+    if (slots.gallery && slots.gallery.length > 0) {
+        for (const g of slots.gallery.slice(0, 5)) {
+            const absPath = path_1.default.resolve(relayDir, g.path);
+            if (fs_1.default.existsSync(absPath)) {
+                entries.push({ path: g.path, title: g.title, description: g.description, slot_type: 'gallery' });
+            }
+        }
+    }
+    // If no slots defined, auto-scan portfolio/ directory
+    if (entries.length === 0) {
+        const portfolioDir = path_1.default.join(relayDir, 'portfolio');
+        if (fs_1.default.existsSync(portfolioDir)) {
+            const files = fs_1.default.readdirSync(portfolioDir)
+                .filter((f) => IMAGE_EXTS.some((ext) => f.toLowerCase().endsWith(ext)))
+                .sort();
+            // First image as cover, rest as gallery
+            for (let i = 0; i < files.length && i < 6; i++) {
+                const f = files[i];
+                entries.push({
+                    path: path_1.default.join('portfolio', f),
+                    title: path_1.default.basename(f, path_1.default.extname(f)).replace(/[-_]/g, ' '),
+                    slot_type: i === 0 ? 'cover' : 'gallery',
+                });
+            }
+        }
+    }
+    return entries;
 }
 /**
  * long_description을 결정한다.
@@ -144,12 +195,24 @@ async function publishToApi(token, tarPath, metadata, teamDir, portfolioEntries)
     const form = new FormData();
     form.append('package', blob, `${metadata.slug}-${metadata.version}.tar.gz`);
     form.append('metadata', JSON.stringify(metadata));
-    // Attach portfolio images (with size validation)
+    // Attach portfolio images (with size validation and slot_type)
     if (portfolioEntries.length > 0) {
         const portfolioMeta = [];
         let totalImageSize = 0;
+        let fileIndex = 0;
         for (let i = 0; i < portfolioEntries.length; i++) {
             const entry = portfolioEntries[i];
+            // video_url demo has no file to upload
+            if (entry.slot_type === 'demo' && entry.demo_url && !entry.path) {
+                portfolioMeta.push({
+                    title: entry.title,
+                    description: entry.description,
+                    sort_order: i,
+                    slot_type: entry.slot_type,
+                    demo_url: entry.demo_url,
+                });
+                continue;
+            }
             const absPath = path_1.default.resolve(teamDir, entry.path);
             const imgBuffer = fs_1.default.readFileSync(absPath);
             if (imgBuffer.length > MAX_IMAGE_SIZE) {
@@ -162,13 +225,16 @@ async function publishToApi(token, tarPath, metadata, teamDir, portfolioEntries)
                 throw new Error(`포트폴리오 이미지 총 크기가 너무 큽니다 (${totalMB}MB). 최대 ${MAX_TOTAL_UPLOAD_SIZE / 1024 / 1024}MB까지 허용됩니다.`);
             }
             const ext = path_1.default.extname(entry.path).slice(1) || 'png';
-            const mimeType = ext === 'jpg' || ext === 'jpeg' ? 'image/jpeg' : ext === 'webp' ? 'image/webp' : 'image/png';
+            const mimeType = ext === 'gif' ? 'image/gif' : ext === 'jpg' || ext === 'jpeg' ? 'image/jpeg' : ext === 'webp' ? 'image/webp' : 'image/png';
             const imgBlob = new Blob([imgBuffer], { type: mimeType });
-            form.append(`portfolio[${i}]`, imgBlob, path_1.default.basename(entry.path));
+            form.append(`portfolio[${fileIndex}]`, imgBlob, path_1.default.basename(entry.path));
+            fileIndex++;
             portfolioMeta.push({
                 title: entry.title,
                 description: entry.description,
                 sort_order: i,
+                slot_type: entry.slot_type,
+                demo_url: entry.demo_url,
             });
         }
         form.append('portfolio_meta', JSON.stringify(portfolioMeta));

package/dist/lib/command-adapter.js

@@ -283,18 +283,36 @@ requires:
     - contents-team
 \`\`\`
 
-### 4. 포트폴리오 생성
-
-#### Layer 1: 팀 구성 시각화 (자동)
-- 분석된 팀 구조를 HTML로 생성합니다.
-- 생성된 HTML을 Playwright로 스크린샷 캡처합니다.
-- 결과 PNG를 ./.relay/portfolio/team-overview.png에 저장합니다.
-
-#### Layer 2: 결과물 쇼케이스 (선택)
+### 4. 포트폴리오 생성 (슬롯 기반)
+
+포트폴리오는 3가지 슬롯으로 구성됩니다. .relay/portfolio/ 디렉토리에 저장합니다.
+
+#### 슬롯 1: cover (필수 — 마켓 리스팅 카드)
+- 규격: 1200x630px, WebP, 최대 500KB
+- 팀 구조를 요약하는 카드 HTML을 생성합니다:
+  - 팀 이름, 버전
+  - Skills 목록 (이름 + 설명)
+  - Commands 목록
+  - 주요 기능 요약
+- 생성된 HTML을 Playwright로 1200x630 뷰포트에서 스크린샷 캡처합니다.
+- .relay/portfolio/cover.png에 저장합니다.
+- 사용자에게 "이 cover를 사용할까요?" 확인. 직접 제공도 가능.
+
+#### 슬롯 2: demo (선택 — 동작 시연)
+- 팀 유형에 따라 제안 여부를 판단합니다:
+  - 브라우저 자동화 키워드 감지 (playwright, puppeteer, crawl, scrape, browser) → GIF 데모 제안
+  - 그 외 → 건너뜀 (사용자가 원하면 수동 추가)
+- GIF: 최대 5MB, .relay/portfolio/demo.gif에 저장
+- 또는 외부 영상 URL (YouTube, Loom 등)을 relay.yaml에 기록
+- 사용자에게 "데모를 녹화할까요?" / "영상 URL이 있나요?" 확인
+
+#### 슬롯 3: gallery (선택 — 결과물 쇼케이스, 최대 5장)
+- 규격: 800x600px 이하, WebP, 각 500KB 이하
 - output/, results/, examples/ 디렉토리를 스캔합니다.
-- 발견된 결과물을 사용자에게 보여주고 포트폴리오 포함 여부를 선택합니다.
-- 선택된 이미지를 ./.relay/portfolio/에 저장합니다.
-- 각 이미지는 2MB 이하여야 합니다.
+- 큰 이미지 → 사용자에게 "어느 영역을 보여줄까요?" 확인 후 핵심 영역 crop
+- HTML 파일 → Playwright 스크린샷으로 변환
+- 사용자가 포트폴리오에 포함할 항목을 선택합니다.
+- .relay/portfolio/에 저장합니다.
 
 ### 5. 메타데이터 생성
 - description: skills 내용 기반으로 자동 생성합니다.
@@ -303,7 +321,19 @@ requires:
 - 사용자에게 확인: "이대로 배포할까요?"
 
 ### 6. .relay/relay.yaml 업데이트
-- 생성/수정된 메타데이터, requires, 포트폴리오 경로를 .relay/relay.yaml에 반영합니다.
+- 메타데이터, requires, 포트폴리오 슬롯을 .relay/relay.yaml에 반영합니다.
+
+\`\`\`yaml
+portfolio:
+  cover:
+    path: portfolio/cover.png
+  demo:                          # 선택
+    type: gif
+    path: portfolio/demo.gif
+  gallery:                       # 선택, 최대 5장
+    - path: portfolio/example-1.png
+      title: "카드뉴스 예시"
+\`\`\`
 
 ### 7. 배포
 - \`relay publish\` 명령어를 실행합니다.
@@ -314,12 +344,11 @@ requires:
 사용자: /relay-publish
 → 팀 구조 분석: skills 3개, commands 5개
 → 보안 스캔: ✓ 시크릿 없음
-→ 환경변수 감지: OPENAI_API_KEY, DATABASE_URL
-→ "OPENAI_API_KEY — 필수인가요?" → Yes
-→ "DATABASE_URL — 필수인가요?" → No, 선택
-→ npm 의존성 감지: sharp (필수)
+→ 환경변수 감지: OPENAI_API_KEY (필수), DATABASE_URL (선택)
 → requires 업데이트 완료
-→ 포트폴리오 생성 → 사용자 확인
+→ cover 생성: 팀 구조 카드 HTML → 1200x630 스크린샷
+→ demo: "브라우저 자동화 감지. GIF 데모 녹화할까요?" → Yes → 녹화 완료
+→ gallery: output/ 스캔 → "카드뉴스 예시.png 포함?" → Yes → crop + 리사이즈
 → relay publish 실행
 → "배포 완료! URL: https://relayax.com/teams/my-team"`,
     },

package/package.json

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