relayax-cli 0.2.40 → 0.3.41

package/dist/lib/guide.js

@@ -1,52 +1,144 @@
 "use strict";
-/**
- * GUIDE.html 생성 프롬프트 템플릿.
- * publish slash command에서 Claude Code가 이 프롬프트를 읽고 GUIDE.html을 생성한다.
- */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GUIDE_HTML_PROMPT = void 0;
-exports.GUIDE_HTML_PROMPT = `
-당신은 에이전트 팀의 사용가이드(GUIDE.html)를 생성하는 에이전트입니다.
-팀의 skills/, agents/, commands/ 파일을 분석한 결과를 바탕으로, 설치자가 읽을 수 있는 standalone HTML 파일을 생성하세요.
-
-## 콘텐츠 구조 (순서대로)
-
-1. **헤더**: 팀 이름 + 한 줄 소개
-2. **설치 방법 (준비하기)**:
-   - Step 1: CLI 설치 — \`npm install -g relayax-cli\`
-   - Step 2: 팀 설치 — \`relay install @owner/slug\` (실제 팀의 scoped slug 사용)
-   - Step 3: 에이전트에 복사붙여넣기 — "사용하시는 AI 에이전트(Claude Code, Codex 등)의 채팅창에 아래 명령어를 붙여넣기 하세요!"
-3. **안내 Callout**: 노란 배경 박스로 시작 방법 강조 — "채팅창에 '○○○'라고 입력하세요."
-4. **워크플로우 요약**: 전체 흐름을 한 줄로 — \`[0 온보딩 → 1 분석 → 1.5 선택 → 2 추천 → 3 생성]\`
-5. **파이프라인 다이어그램**: 2-column 세로 플로우차트
-   - 왼쪽 컬럼: 파이프라인 단계 (노드 + 연결선, 세로 흐름)
-   - 오른쪽 컬럼: 해당 단계에서 사용하는 skill 카드 (skill명 + 한 줄 설명)
-   - 색상 구분: 유저 개입 단계 = 베이지/주황 톤, AI 자동 단계 = 연두/초록 톤
-   - 상단에 범례: ■ 유저 개입 / ■ 자동 실행
-   - 선택적 단계(optional)는 점선 테두리 그룹으로 묶기
-6. **단계별 상세 테이블**: 4-column 테이블
-   - 컬럼: 단계 | skill명 | 액션 | 상세
-   - 각 행에 역할 뱃지: "AI가 알아서 해줘요" (초록 배경) / "직접 아래 액션을 수행해주세요!" (주황 배경, 볼드)
-   - 상세 컬럼에 bullet list로 구체적 동작 설명
-   - 주의사항은 빨간 이탤릭 (*주의: ...)
-7. **사전 준비사항**: 필요한 환경변수, 접근 권한, 데이터 등
-8. **Q&A**: 접이식 토글(details/summary)로 자주 묻는 질문
-   - 커스터마이징 방법 (개수 변경, 타입 고정 등)
-   - 중단/재시작 방법
-   - 데이터 형식 요구사항
-
-파이프라인이 없는 단순한 팀은 시작 방법 + 기능 설명 + Q&A만 포함합니다.
-
-## 디자인 규칙 (Notion 스타일)
-
-- **라이트 모드**: 배경 #ffffff / 부배경 #fafaf8, 텍스트 다크 #1a1a18
-- **레이아웃**: max-width 900px, padding 40px, Notion 문서형 넓은 여백
-- **타이포그래피**: system-ui, -apple-system, sans-serif. 본문 15px, line-height 1.7
-- **Callout 박스**: 노란 배경 #fffbeb + 좌측 보더 4px solid #fcd34d (중요 안내), 파란 배경 #eff6ff + 보더 #93c5fd (참고)
-- **역할 뱃지**: 둥근 모서리 pill, 초록 배경 #e0f5ea + 텍스트 #0d6b2e (AI) / 주황 배경 #fff0e0 + 텍스트 #b85a00 (유저)
-- **테이블**: 깔끔한 border #e8e8e4, hover 시 행 하이라이트 #f5f5f3, 헤더 회색 배경 #f5f5f3
-- **색상**: 유저 단계 = 베이지/주황 (#fff8f0, #f0c090), AI 단계 = 연두 (#f0faf4, #90d4a8)
-- **톤**: 따뜻하고 친근한 한국어, 이모지 적절히 활용
-- **반응형**: 600px 이하에서 테이블 가로스크롤, 다이어그램 단일 컬럼
-- **기술 제약**: standalone HTML, CSS는 style 태그 내, 외부 CDN/폰트 없음, JS 최소화 (details/summary만)
-`.trim();
+exports.generateGuide = generateGuide;
+function buildSetupSection(needsLogin) {
+    const installStep = `## Step 1. Relay CLI 설치
+
+relay CLI가 설치되어 있지 않다면:
+
+\`\`\`bash
+npm install -g relayax-cli
+\`\`\`
+
+Node.js가 없는 경우:
+- macOS: \`brew install node\`
+- Windows: \`winget install OpenJS.NodeJS.LTS\`
+- Linux: \`curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash && source ~/.bashrc && nvm install --lts\`
+
+npm 권한 오류 시:
+\`\`\`bash
+mkdir -p ~/.npm-global && npm config set prefix '~/.npm-global'
+echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc && source ~/.zshrc
+npm install -g relayax-cli
+\`\`\``;
+    if (!needsLogin)
+        return installStep;
+    return `${installStep}
+
+## Step 2. 로그인
+
+\`\`\`bash
+relay login
+\`\`\`
+
+브라우저가 열리면 GitHub 또는 카카오 계정으로 로그인하세요.`;
+}
+function buildRequiresSection(requires) {
+    const sections = [];
+    if (requires.cli && requires.cli.length > 0) {
+        sections.push('### CLI 도구 설치\n');
+        for (const cli of requires.cli) {
+            const label = cli.required === false ? '(선택)' : '(필수)';
+            if (cli.install) {
+                sections.push(`- **${cli.name}** ${label}: \`${cli.install}\``);
+            }
+            else {
+                sections.push(`- **${cli.name}** ${label}: 설치 후 \`which ${cli.name}\`으로 확인`);
+            }
+        }
+        sections.push('');
+    }
+    if (requires.npm && requires.npm.length > 0) {
+        sections.push('### npm 패키지 설치\n');
+        sections.push('```bash');
+        const pkgNames = requires.npm.map((p) => typeof p === 'string' ? p : p.name);
+        sections.push(`npm install ${pkgNames.join(' ')}`);
+        sections.push('```\n');
+    }
+    if (requires.env && requires.env.length > 0) {
+        sections.push('### 환경변수 설정\n');
+        sections.push('```bash');
+        for (const env of requires.env) {
+            const label = env.required === false ? '# (선택)' : '# (필수)';
+            const desc = env.description ? ` — ${env.description}` : '';
+            sections.push(`${env.name}=your_value_here  ${label}${desc}`);
+        }
+        sections.push('```\n');
+    }
+    if (requires.mcp && requires.mcp.length > 0) {
+        sections.push('### MCP 서버 설정\n');
+        for (const mcp of requires.mcp) {
+            sections.push(`**${mcp.name}:**`);
+            if (mcp.package)
+                sections.push(`- 패키지: \`${mcp.package}\``);
+            if (mcp.config) {
+                sections.push(`- 실행: \`${mcp.config.command}${mcp.config.args ? ' ' + mcp.config.args.join(' ') : ''}\``);
+            }
+            if (mcp.env && mcp.env.length > 0) {
+                sections.push(`- 필요한 환경변수: ${mcp.env.map((e) => `\`${e}\``).join(', ')}`);
+            }
+            sections.push('');
+        }
+    }
+    if (requires.teams && requires.teams.length > 0) {
+        sections.push('### 의존 팀 설치\n');
+        sections.push('```bash');
+        for (const team of requires.teams) {
+            sections.push(`relay install ${team}`);
+        }
+        sections.push('```\n');
+    }
+    if (requires.permissions && requires.permissions.length > 0) {
+        sections.push('### 권한 설정\n');
+        sections.push('아래 도구 사용을 허용해야 합니다:\n');
+        for (const perm of requires.permissions) {
+            sections.push(`- \`${perm}\``);
+        }
+        sections.push('');
+    }
+    if (sections.length === 0)
+        return '';
+    return '## Step 4. 환경 구성\n\n' + sections.join('\n');
+}
+function generateGuide(config, commands, requires) {
+    const scopedSlug = config.slug.startsWith('@') ? config.slug : `@${config.slug}`;
+    const needsLogin = config.visibility === 'private' || config.visibility === 'gated';
+    const setupSection = buildSetupSection(needsLogin);
+    const installStepNum = needsLogin ? 3 : 2;
+    const requiresSection = requires ? buildRequiresSection(requires) : '';
+    const requiresSectionFinal = requiresSection
+        ? requiresSection.replace('## Step 4.', `## Step ${installStepNum + 1}.`)
+        : '';
+    let usageHint = '';
+    if (commands.length > 0) {
+        usageHint = `## 사용법
+
+설치가 완료되면 아래 커맨드를 사용할 수 있습니다:
+
+${commands.map((cmd) => `- \`/${cmd.name}\`: ${cmd.description}`).join('\n')}
+
+원하는 작업을 말하거나 위 커맨드를 직접 실행하세요.
+`;
+    }
+    return `# ${config.name} — 설치 가이드
+
+> ${config.description}
+
+이 가이드는 [RelayAX](https://relayax.com)에서 자동 생성되었습니다.
+아래 단계를 순서대로 실행하면 Agent 팀이 설치됩니다.
+
+${setupSection}
+
+## Step ${installStepNum}. 팀 설치
+
+\`\`\`bash
+relay install ${scopedSlug}
+\`\`\`
+
+설치 후 Agent가 자동으로 의존성을 확인하고 환경을 구성합니다.
+
+${requiresSectionFinal}${usageHint}---
+*출처: https://relayax.com — Agent Team Marketplace*
+*설치: \`relay install ${scopedSlug}\`*
+`;
+}

package/dist/lib/preamble.js

@@ -17,11 +17,10 @@ const PREAMBLE_END = '<!-- RELAY_PREAMBLE_END -->';
  * relay CLI가 있으면 사용, 없으면 curl fallback.
  */
 function generatePreambleScript(slug, apiUrl) {
-    // slug format: @space/team → space=space, team=team
+    // slug format: @owner/team → extract team slug for ping
     const stripped = slug.startsWith('@') ? slug.slice(1) : slug;
     const slashIdx = stripped.indexOf('/');
-    const spacePart = slashIdx !== -1 ? stripped.slice(0, slashIdx) : stripped;
-    const teamPart = slashIdx !== -1 ? stripped.slice(slashIdx + 1) : stripped;
+    const teamSlug = slashIdx !== -1 ? stripped.slice(slashIdx + 1) : stripped;
     return `#!/usr/bin/env bash
 # relay-preamble.sh — auto-generated by relay publish
 set +e
@@ -32,7 +31,7 @@ DEVICE_HASH=$(echo "$HOSTNAME:$USER" | shasum -a 256 | cut -d' ' -f1)
 if command -v relay &>/dev/null; then
   relay ping "${slug}" --quiet 2>/dev/null &
 else
-  curl -sf -X POST "${apiUrl}/api/spaces/${spacePart}/teams/${teamPart}/ping" \\
+  curl -sf -X POST "${apiUrl}/api/teams/${teamSlug}/ping" \\
     -H "Content-Type: application/json" \\
     -d "{\\"device_hash\\":\\"$DEVICE_HASH\\"}" \\
     2>/dev/null &

package/dist/lib/slug.d.ts

@@ -15,6 +15,5 @@ export declare function isSimpleSlug(input: string): boolean;
 /**
  * Scoped 또는 단순 slug를 받아 ParsedSlug를 반환한다.
  * 단순 slug는 서버에 resolve를 요청한다.
- * `@spaces/{spaceSlug}/{teamSlug}` 형식은 `@{spaceSlug}/{teamSlug}`로 정규화된다.
  */
 export declare function resolveSlug(input: string): Promise<ParsedSlug>;

package/dist/lib/slug.js

@@ -28,22 +28,18 @@ function isSimpleSlug(input) {
 /**
  * Scoped 또는 단순 slug를 받아 ParsedSlug를 반환한다.
  * 단순 slug는 서버에 resolve를 요청한다.
- * `@spaces/{spaceSlug}/{teamSlug}` 형식은 `@{spaceSlug}/{teamSlug}`로 정규화된다.
  */
 async function resolveSlug(input) {
-    // @spaces/{spaceSlug}/{teamSlug} → @{spaceSlug}/{teamSlug} 정규화
-    const spacesPrefix = input.match(/^@spaces\/([a-z0-9][a-z0-9-]*)\/([a-z0-9][a-z0-9-]*)$/);
-    const normalized = spacesPrefix ? `@${spacesPrefix[1]}/${spacesPrefix[2]}` : input;
     // scoped slug면 바로 파싱
-    const parsed = parseSlug(normalized);
+    const parsed = parseSlug(input);
     if (parsed)
         return parsed;
     // 단순 slug인지 검증
-    if (!isSimpleSlug(normalized)) {
+    if (!isSimpleSlug(input)) {
         throw new Error(`잘못된 slug 형식입니다: '${input}'. @owner/name 또는 name 형태로 입력하세요.`);
     }
     // 서버에 resolve 요청
-    const results = await (0, api_js_1.resolveSlugFromServer)(normalized);
+    const results = await (0, api_js_1.resolveSlugFromServer)(input);
     if (results.length === 0) {
         throw new Error(`'${input}' 팀을 찾을 수 없습니다.`);
     }

package/dist/types.d.ts

@@ -10,8 +10,8 @@ export interface InstalledTeam {
     installed_at: string;
     files: string[];
     type?: 'team' | 'system';
-    /** Space 소속 팀인 경우 Space slug */
-    space_slug?: string;
+    /** Org 소속 팀인 경우 Org slug */
+    org_slug?: string;
     /** 배치 범위 — 에이전트가 relay deploy-record로 기록 */
     deploy_scope?: 'global' | 'local';
     /** 배치된 파일 절대경로 목록 — 에이전트가 relay deploy-record로 기록 */

package/package.json

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