relayax-cli 0.2.39 → 0.2.41

package/dist/commands/spaces.js

@@ -22,7 +22,7 @@ function registerSpaces(program) {
         const token = await (0, config_js_1.getValidToken)();
         if (!token) {
             if (json) {
-                console.error(JSON.stringify({ error: 'LOGIN_REQUIRED', message: '로그인이 필요합니다. relay login을 먼저 실행하세요.' }));
+                console.error(JSON.stringify({ error: 'LOGIN_REQUIRED', message: '로그인이 필요합니다. relay login을 먼저 실행하세요.', fix: 'relay login 실행 후 재시도하세요.' }));
             }
             else {
                 console.error('\x1b[31m오류: 로그인이 필요합니다.\x1b[0m');
@@ -36,29 +36,21 @@ function registerSpaces(program) {
                 console.log(JSON.stringify({ spaces }));
                 return;
             }
-            const personal = spaces.find((s) => s.is_personal);
-            const others = spaces.filter((s) => !s.is_personal);
-            if (personal) {
-                console.log(`\n\x1b[90m개인 스페이스:\x1b[0m`);
-                console.log(`  \x1b[36m${personal.slug}\x1b[0m  \x1b[1m${personal.name}\x1b[0m`);
+            if (spaces.length === 0) {
+                console.log('\nSpace가 없습니다.');
+                console.log('\x1b[33m💡 Space를 만들려면: www.relayax.com/spaces/new\x1b[0m');
             }
-            if (others.length > 0) {
-                console.log(`\n\x1b[1m내 Space\x1b[0m (${others.length}개):\n`);
-                for (const s of others) {
+            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 === 'admin' ? '\x1b[36m관리자\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}`);
                 }
-            }
-            if (!personal && others.length === 0) {
-                console.log('\nSpace가 없습니다.');
-                console.log('\x1b[33m💡 Space를 만들려면: www.relayax.com/spaces/new\x1b[0m');
-            }
-            if (others.length > 0) {
                 console.log(`\n\x1b[33m💡 Space 팀 목록: relay list --space <slug>\x1b[0m`);
                 console.log(`\x1b[33m💡 비공개 배포: relay.yaml에 visibility: private 설정 후 relay publish\x1b[0m`);
             }
@@ -66,7 +58,7 @@ function registerSpaces(program) {
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);
             if (json) {
-                console.error(JSON.stringify({ error: 'FETCH_FAILED', message }));
+                console.error(JSON.stringify({ error: 'FETCH_FAILED', message, fix: '네트워크 연결을 확인하거나 잠시 후 재시도하세요.' }));
             }
             else {
                 console.error(`\x1b[31m오류: ${message}\x1b[0m`);

package/dist/commands/update.js

@@ -133,7 +133,7 @@ function registerUpdate(program) {
         }
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);
-            console.error(JSON.stringify({ error: 'UPDATE_FAILED', message }));
+            console.error(JSON.stringify({ error: 'UPDATE_FAILED', message, fix: 'npm update -g relayax-cli로 수동 업데이트하세요.' }));
             process.exit(1);
         }
         finally {

package/dist/index.js

@@ -9,6 +9,7 @@ const search_js_1 = require("./commands/search.js");
 const install_js_1 = require("./commands/install.js");
 const list_js_1 = require("./commands/list.js");
 const uninstall_js_1 = require("./commands/uninstall.js");
+const package_js_1 = require("./commands/package.js");
 const publish_js_1 = require("./commands/publish.js");
 const login_js_1 = require("./commands/login.js");
 const update_js_1 = require("./commands/update.js");
@@ -20,6 +21,7 @@ const join_js_1 = require("./commands/join.js");
 const spaces_js_1 = require("./commands/spaces.js");
 const deploy_record_js_1 = require("./commands/deploy-record.js");
 const ping_js_1 = require("./commands/ping.js");
+const access_js_1 = require("./commands/access.js");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const pkg = require('../package.json');
 const program = new commander_1.Command();
@@ -35,6 +37,7 @@ program
 (0, install_js_1.registerInstall)(program);
 (0, list_js_1.registerList)(program);
 (0, uninstall_js_1.registerUninstall)(program);
+(0, package_js_1.registerPackage)(program);
 (0, publish_js_1.registerPublish)(program);
 (0, login_js_1.registerLogin)(program);
 (0, update_js_1.registerUpdate)(program);
@@ -46,4 +49,5 @@ program
 (0, spaces_js_1.registerSpaces)(program);
 (0, deploy_record_js_1.registerDeployRecord)(program);
 (0, ping_js_1.registerPing)(program);
+(0, access_js_1.registerAccess)(program);
 program.parse();

package/dist/lib/command-adapter.js

@@ -57,13 +57,46 @@ function getGlobalCommandPathForTool(skillsDir, commandId) {
 function formatCommandFile(content) {
     return `---\ndescription: ${content.description}\n---\n\n${content.body}\n`;
 }
-// ─── Login JIT 공통 안내 ───
-const LOGIN_JIT_GUIDE = `
-### 인증 오류 처리
-- 커맨드 실행 결과에 \`LOGIN_REQUIRED\` 에러가 포함되면:
-  1. \`relay login\` 실행 (timeout 300초)
-     - 브라우저가 자동으로 열리고, 사용자가 로그인을 완료하면 토큰이 자동 저장됩니다.
-  2. 완료 후 \`relay status --json\`으로 로그인 성공을 확인하고, 원래 커맨드를 재실행합니다.`;
+// ─── 에러 처리 가이드 (결정적 실행 + 비결정적 조율) ───
+const ERROR_HANDLING_GUIDE = `
+### 에러 처리 가이드
+
+CLI 명령 실행 후 JSON 에러가 반환되면 아래 기준에 따라 처리합니다.
+**원칙: "되돌릴 수 없는 영향이 있는가?"로 판단합니다.**
+
+#### 1. 자동 해결 (사용자에게 물어보지 않음)
+되돌릴 수 있고, 부작용 없는 에러:
+
+| 에러 코드 | 행동 |
+|-----------|------|
+| \`LOGIN_REQUIRED\` / \`NO_TOKEN\` | \`relay login\` 실행 (timeout 300초, 브라우저 자동 열림) → 성공 후 원래 명령 재시도 |
+| \`NOT_INITIALIZED\` | \`relay init --all --json\` 실행 → 원래 명령 재시도 |
+| \`FETCH_FAILED\` | 3초 대기 후 원래 명령 재시도 (최대 2회). 2회 실패 시 사용자에게 안내 |
+
+#### 2. 사용자에게 선택지 제시 (AskUserQuestion)
+\`options\` 필드가 있는 에러:
+
+| 에러 코드 | 행동 |
+|-----------|------|
+| \`MISSING_VISIBILITY\` | options의 label을 선택지로 AskUserQuestion 호출 |
+| \`MISSING_FIELD\` | fix 안내 + 사용자에게 값 입력 요청 |
+| \`MISSING_TOOLS\` | options의 감지된 도구 목록을 선택지로 AskUserQuestion 호출 |
+| \`MISSING_SPACE\` | options의 Space 목록을 선택지로 AskUserQuestion 호출 |
+
+사용자가 선택하면, 선택된 값을 CLI 플래그에 반영하여 명령을 재호출합니다.
+
+#### 3. 사용자에게 안내 (되돌릴 수 없는 에러)
+구매, 접근 권한, 보안 관련:
+
+| 에러 코드 | 행동 |
+|-----------|------|
+| \`GATED_ACCESS_REQUIRED\` | purchase_info의 message/url 표시 → "접근 코드가 있으신가요?" AskUserQuestion |
+| \`SPACE_ONLY\` | Space 가입 필요 안내 → "초대 코드가 있으신가요?" AskUserQuestion |
+| \`APPROVAL_REQUIRED\` | 승인 대기 안내 |
+| \`NO_ACCESS\` | 접근 방법 안내 |
+
+#### 4. 그 외 에러
+\`fix\` 필드의 메시지를 사용자에게 전달하고, 필요하면 다음 행동을 제안합니다.`;
 // ─── 명함 표시 포맷 ───
 const BUSINESS_CARD_FORMAT = `
 ### 빌더 명함 표시
@@ -128,7 +161,7 @@ slug가 직접 주어지면 (\`/relay-install @alice/doc-writer\`) 이 단계를
 
 **AskUserQuestion 호출:**
 - question: "어디서 팀을 찾을까요?"
-- options: Space가 있으면 \`["<space1_name> (개인)", "<space2_name>", ...]\`, 없으면 이 단계를 건너뛰고 바로 내 Space 탐색으로 진행
+- options: Space가 있으면 \`["<space1_name>", "<space2_name>", ...]\`, 없으면 이 단계를 건너뛰고 바로 내 Space 탐색으로 진행
 
 **응답 처리:**
 - Space 이름 선택 → 1-2. Space 팀 탐색으로 진행
@@ -177,13 +210,24 @@ slug가 직접 주어지면 (\`/relay-install @alice/doc-writer\`) 이 단계를
 
 #### 2-1. 패키지 다운로드
 \`relay install <@space/team> --json\` 명령어를 실행합니다.
-- 공개 팀: \`relay install <@space/team> --json\`
-- Space 팀 (비공개): \`relay install @<space-slug>/<team-slug> --json\`
+- 공개 팀 (public): \`relay install <@space/team> --json\`
+- 링크 공유 팀 (gated): \`relay install <slug> --json\`
+  - 접근 권한이 없으면 CLI가 **purchase_info** (구매 안내 메시지 + URL)를 표시합니다.
+  - 접근 링크 코드가 있으면: \`relay access <slug> --code <code>\` 로 접근 부여 + 자동 설치를 한번에 수행합니다.
+  - Space 멤버이면 접근 확인 없이 바로 설치됩니다.
+- Space 팀 (비공개/private): \`relay install @<space-slug>/<team-slug> --json\`
   - Space 가입이 필요하면: \`relay join <space-slug> --code <invite-code>\` 를 먼저 실행합니다.
   - 또는 \`--join-code <code>\`로 가입+설치를 한번에 할 수 있습니다.
 - CLI가 init과 login을 자동으로 처리합니다 (사용자가 별도 실행할 필요 없음).
 - JSON 출력에서 \`install_path\` (패키지 경로)를 확인합니다.
 
+**gated 팀 접근 거부 처리:**
+- CLI가 403 + \`GATED_ACCESS_REQUIRED\` 에러를 반환하면:
+  1. purchase_info의 message와 url을 사용자에게 표시합니다.
+  2. "접근 링크 코드가 있으신가요?"라고 물어봅니다.
+  3. 코드가 있으면 \`relay access <slug> --code <code>\`를 실행합니다.
+  4. 코드가 없으면 purchase_info의 url로 구매 안내합니다.
+
 #### 2-2. 배치 범위 선택 (추천 포함)
 
 팀의 성격을 분석하여 글로벌/로컬 중 적합한 쪽을 추천합니다.
@@ -283,7 +327,7 @@ requires 섹션이 없거나 비어있으면 이 단계를 건너뜁니다.
 \`\`\`
 ⚠️  필수 요구사항이 충족되지 않았습니다. 팀 기능이 제한될 수 있습니다.
 \`\`\`
-${LOGIN_JIT_GUIDE}
+${ERROR_HANDLING_GUIDE}
 
 ### Step 3. 완료 & 팔로우 제안
 
@@ -308,17 +352,12 @@ ${BUSINESS_CARD_FORMAT}
 \`\`\`
 주변인에게 공유하세요:
 
-npm install -g relayax-cli
-/relay:relay-install {slug}
-
-상세페이지: relayax.com/@{owner}/{team}
+아래 가이드를 읽고 그대로 따라해줘:
+https://relayax.com/api/registry/{owner}/{slug}/guide.md
 \`\`\`
 
-- \`{slug}\`가 \`@owner/team\` 형식이면 상세페이지는 \`relayax.com/@{owner}/{team}\`으로 치환합니다.
-
-- type 기반 사용법도 포함:
-  - command/hybrid: \`# 사용법: /{첫번째 커맨드}\`
-  - passive: \`# 설치하면 자동 적용됩니다\`
+- \`{slug}\`가 \`@owner/team\` 형식이면 \`{owner}\`과 \`{slug}\`를 분리하여 URL을 구성합니다.
+- CLI가 이미 설치된 사용자를 위한 짧은 버전도 함께 표시합니다: \`/relay:relay-install {slug}\`
 
 #### 3-4. 사용 제안
 - "바로 사용해볼까요?" 제안
@@ -332,8 +371,8 @@ npm install -g relayax-cli
 
 ### 인터랙티브 모드 (/relay-install)
 → relay spaces --json 실행
-→ AskUserQuestion: "어디서 팀을 찾을까요?" → ["개인 Space (alice)", "Acme Corp"]
-→ "개인 Space" 선택 → "어떤 팀을 찾고 계세요?"
+→ AskUserQuestion: "어디서 팀을 찾을까요?" → ["Alice's Space (alice)", "Acme Corp"]
+→ "Alice's Space" 선택 → "어떤 팀을 찾고 계세요?"
 → relay search "문서" 실행 → 결과 리스트 표시
 → AskUserQuestion: "어떤 팀을 설치할까요?" → ["1", "2", "3", "다시 검색"]
 → "1" 선택 (@alice/doc-writer)
@@ -400,7 +439,6 @@ npm install -g relayax-cli
       "slug": "my-space",
       "name": "내 스페이스",
       "description": "설명",
-      "is_personal": false,
       "role": "owner"
     }
   ]
@@ -408,9 +446,8 @@ npm install -g relayax-cli
 \`\`\`
 
 **표시:**
-- \`is_personal: true\` → 개인 스페이스로 분류
-- \`role\`: owner → 소유자, admin → 관리자, member → 멤버
-${LOGIN_JIT_GUIDE}
+- \`role\`: owner → 소유자, builder → 빌더, member → 멤버
+${ERROR_HANDLING_GUIDE}
 - Spaces 조회 실패해도 설치된 팀 목록은 정상 표시합니다 (로컬 데이터).
 
 ### 3. Space 팀 목록 (옵션)
@@ -469,58 +506,154 @@ ${LOGIN_JIT_GUIDE}
         description: '현재 팀 패키지를 relay Space에 배포합니다',
         body: `현재 디렉토리의 에이전트 팀(.relay/)을 분석하고, 보안 점검 및 requirements를 구성한 뒤, 사용가이드를 생성하고 relay Space에 배포합니다.
 
-## 사전 준비 (자동)
+## 사전 준비
+
+### 0-1. 인증 확인
+
+- \`relay status --json\` 명령어를 실행하여 로그인 상태를 확인합니다.
+- 인증되어 있으면 다음 단계로 진행합니다.
+- 미인증이면 바로 로그인을 진행합니다:
+  1. \`relay login\` 실행 (timeout 300초)
+     - 브라우저가 자동으로 열리고, 사용자가 로그인을 완료하면 토큰이 자동 저장됩니다.
+  2. 완료 후 \`relay status --json\`으로 로그인 성공을 확인합니다.
+
+### 0-2. 소스 패키징 (source → .relay/)
+
+\`relay package\` CLI 명령을 사용하여 소스 디렉토리의 콘텐츠를 .relay/로 동기화합니다.
+소스 탐색과 파일 비교는 CLI가 결정적으로 처리하고, 에이전트는 결과를 사용자에게 보여주고 흐름을 조율합니다.
+
+#### A. 최초 배포 (.relay/relay.yaml이 없음)
+
+##### 1단계: 소스 탐색
+
+\`relay package --init --json\` 실행
+- CLI가 프로젝트에서 에이전트 CLI 디렉토리(.claude/, .codex/, .gemini/ 등)를 자동 탐색합니다.
+- JSON 결과의 \`detected\` 배열에 각 디렉토리별 콘텐츠 요약이 포함됩니다:
+  \`\`\`json
+  {
+    "status": "init_required",
+    "detected": [
+      { "source": ".claude", "name": "Claude Code", "summary": { "skills": 2, "commands": 3 }, "fileCount": 8 },
+      { "source": ".codex", "name": "Codex", "summary": { "agents": 1 }, "fileCount": 2 }
+    ]
+  }
+  \`\`\`
+
+- **detected가 0개** → "배포 가능한 에이전트 콘텐츠가 없습니다. skills/이나 commands/를 먼저 만들어주세요." 안내 후 중단
 
-### 0-1. 팀 프로젝트 확인 & 초기화
+##### 2단계: 콘텐츠 분석 & 팀 포지셔닝
 
-.relay/relay.yaml이 있는지 확인합니다.
+detected된 소스 디렉토리의 skills/, commands/, agents/, rules/ 파일 **내용을 직접 읽어** 팀의 정체성을 파악합니다.
 
-**있으면** → 바로 0-2로 진행합니다.
+**분석 관점:**
+- 이 팀이 **무엇을 하는 팀**인지 (코드 리뷰? QA? 문서 생성? 데이터 분석?)
+- 어떤 **기술 스택/도메인**에 특화되어 있는지 (Supabase? React? Python?)
+- 설치자에게 **어떤 가치**를 제공하는지
 
-**없으면** → 팀 프로젝트를 인라인으로 초기화합니다:
+이 분석을 기반으로 팀을 하나의 "제품"으로 포지셔닝합니다.
 
-1. "이 프로젝트를 relay 팀으로 배포하겠습니다. 먼저 팀 정보를 입력해주세요." 안내
+**중요: 소스 디렉토리 이름(.claude 등)은 인프라 디테일이므로 사용자에게 노출하지 않습니다.**
+사용자에게는 팀의 기능과 정체성 중심으로 질문합니다.
 
-2. **AskUserQuestion 호출:**
-   - question: "팀 이름을 입력해주세요"
-   - 기본값으로 현재 디렉토리명을 제안합니다.
+##### 3단계: 배포 제안
 
-3. **AskUserQuestion 호출:**
-   - question: "팀을 한 줄로 설명해주세요 (Space에 표시됩니다)"
-   - 기본값으로 적절한 값을 만들어줍니다.
+분석 결과를 바탕으로 팀 배포를 제안합니다.
 
-4. 자동 처리:
-   - \`mkdir -p .relay/skills .relay/commands .relay/agents .relay/rules\` 실행
-   - \`.relay/relay.yaml\` 생성:
-     \`\`\`yaml
-     name: <입력된 이름>
-     slug: <이름에서 자동 생성 — 소문자, 특수문자→하이픈>
-     description: <입력된 설명>
-     version: 1.0.0
-     tags: []
+**detected가 1개일 때:**
+
+**AskUserQuestion 호출:**
+- question: 콘텐츠 분석 기반의 포지셔닝 질문
+- 예시:
+  - "Supabase 웹 개발팀으로 배포할까요? (skills 2개, commands 3개)"
+  - "코드 리뷰 자동화 팀으로 배포할까요? (skills 1개, agents 2개)"
+  - "Next.js QA 테스트팀으로 배포할까요? (commands 5개)"
+- options: \`["배포", "취소"]\`
+
+**detected가 여러 개일 때:**
+각 소스의 콘텐츠를 분석하여 서로 다른 팀으로 포지셔닝합니다.
+
+**AskUserQuestion 호출:**
+- question: "어떤 팀으로 배포할까요?"
+- options: 콘텐츠 기반 설명 (예: \`["Supabase 웹 개발팀 (skills 2개, commands 3개)", "QA 자동화 에이전트 (agents 1개)"]\`)
+- 디렉토리 이름은 내부적으로만 매핑하고, 사용자에게는 팀의 기능으로 보여줍니다.
+
+##### 4단계: 팀 정보 확정
+
+포지셔닝 분석을 기반으로 팀 이름과 설명을 제안합니다.
+
+**AskUserQuestion 호출:**
+- question: "팀 이름을 확인해주세요"
+- 분석된 포지셔닝에서 자연스러운 팀 이름을 제안합니다 (예: "supabase-web-dev", "code-reviewer")
+- 현재 디렉토리명이 아닌, **콘텐츠 기반** 이름을 기본값으로 제시합니다.
+
+**AskUserQuestion 호출:**
+- question: "팀 설명을 확인해주세요 (Space에 표시됩니다)"
+- 분석한 콘텐츠를 기반으로 설치자 관점의 설명을 제안합니다.
+- 좋은 예: "Supabase 기반 웹앱의 DB 마이그레이션, API 개발, 테스트를 자동화합니다"
+- 나쁜 예: ".claude 디렉토리의 skills와 commands를 패키징한 팀"
+
+##### 5단계: 초기화 & 패키징
+
+자동 처리:
+- \`.relay/relay.yaml\` 생성:
+  \`\`\`yaml
+  name: <확정된 이름>
+  slug: <이름에서 자동 생성 — 소문자, 특수문자→하이픈>
+  description: <확정된 설명>
+  source: <선택된 소스 디렉토리> # 예: .claude (내부용)
+  version: 1.0.0
+  tags: []
+  \`\`\`
+- \`relay package --source <선택된 소스> --sync --json\` 실행하여 콘텐츠를 .relay/로 복사
+- \`relay init --auto\` 실행하여 글로벌 커맨드 설치 보장
+- 결과를 사용자에게 표시
+
+#### B. 재배포 (.relay/relay.yaml이 있음)
+
+1. \`relay package --json\` 실행
+   - CLI가 relay.yaml의 \`source\` 필드를 읽고, 소스 디렉토리와 .relay/를 파일 해시로 비교합니다.
+   - JSON 결과 예시:
+     \`\`\`json
+     {
+       "source": ".claude",
+       "sourceName": "Claude Code",
+       "synced": false,
+       "diff": [
+         { "relPath": "skills/code-review/SKILL.md", "status": "modified" },
+         { "relPath": "commands/deploy.md", "status": "added" },
+         { "relPath": "commands/old-cmd.md", "status": "deleted" }
+       ],
+       "summary": { "added": 1, "modified": 1, "deleted": 1, "unchanged": 5 }
+     }
      \`\`\`
-   - \`relay init --update\` 실행하여 글로벌 커맨드 설치 보장
 
-5. "✓ 팀 프로젝트가 초기화되었습니다. 배포를 계속 진행합니다." 안내
+2. **변경이 있으면** (added + modified + deleted > 0) → diff를 사용자에게 보여줍니다:
+   \`\`\`
+   📦 소스 동기화 (.claude/ → .relay/)
+     변경: skills/code-review/SKILL.md
+     신규: commands/deploy.md
+     삭제: commands/old-cmd.md
+     유지: 5개 파일
+   \`\`\`
 
-### 0-2. 인증 확인
+   **AskUserQuestion 호출:**
+   - question: "소스 변경사항을 .relay/에 반영할까요?"
+   - options: \`["반영", "변경 확인", "건너뛰기"]\`
 
-- \`relay status --json\` 명령어를 실행하여 로그인 상태를 확인합니다.
-- 인증되어 있으면 다음 단계로 진행합니다.
-- 미인증이면 바로 로그인을 진행합니다:
-  1. \`relay login\` 실행 (timeout 300초)
-     - 브라우저가 자동으로 열리고, 사용자가 로그인을 완료하면 토큰이 자동 저장됩니다.
-  2. 완료 후 \`relay status --json\`으로 로그인 성공을 확인합니다.
+   **응답 처리:**
+   - "반영" → \`relay package --sync --json\` 실행하여 동기화
+   - "변경 확인" → 변경된 파일의 내용을 직접 읽어 diff를 상세히 보여준 후 다시 AskUserQuestion
+   - "건너뛰기" → 현재 .relay/ 그대로 배포
+
+3. **변경이 없으면** → "✓ 소스와 동기화 상태입니다." 표시 후 다음 단계로
 
-### 0-3. 팀 구조 분석
-- .relay/ 디렉토리의 skills/, agents/, rules/, commands/를 탐색합니다.
-- 각 파일의 이름과 description을 추출합니다.
+4. \`source\` 필드가 없으면 → .relay/ 내 콘텐츠를 직접 편집하는 모드로 간주하고 동기화를 건너뜁니다.
 
 ## 인터랙션 플로우
 
-이 커맨드는 5단계 인터랙션으로 진행됩니다. 각 단계에서 반드시 AskUserQuestion 도구를 사용하세요.
+이 커맨드는 4단계 인터랙션으로 진행됩니다. 각 단계에서 반드시 AskUserQuestion 도구를 사용하세요.
 
-### Step 0. 버전 범프
+### Step 1. 버전 범프
 
 relay.yaml의 현재 \`version\`을 읽고 semver 범프를 제안합니다.
 
@@ -541,14 +674,14 @@ relay.yaml의 \`visibility\` 설정을 확인합니다.
 #### 신규 배포 (visibility 미설정)
 
 **AskUserQuestion 호출:**
-- question: "어디에 배포할까요?"
-- options: \`["공개 (Space 공개)", "비공개 (Space 전용)"]\`
+- question: "공개 범위를 선택하세요"
+- options: \`["공개 — 누구나 설치", "링크 공유 — 접근 링크가 있는 사람만 설치", "비공개 — Space 멤버만"]\`
 
 **응답 처리:**
 - "공개" → relay.yaml에 \`visibility: public\` 저장
+- "링크 공유" → relay.yaml에 \`visibility: gated\` 저장. 배포 후 웹 대시보드(/dashboard)에서 접근 링크를 생성하고 구매 안내를 설정할 수 있다고 안내.
 - "비공개" → \`relay spaces --json\` 실행 후 Space 목록 표시
-  - \`is_personal: true\`인 개인 Space는 **제외**합니다. 비공개 배포는 팀 Space에만 가능합니다.
-  - 팀 Space가 0개이면: "비공개 배포하려면 팀 Space가 필요합니다. www.relayax.com/spaces 에서 Space를 생성하세요."라고 안내하고 중단합니다.
+  - Space가 0개이면: "비공개 배포하려면 Space가 필요합니다. www.relayax.com/spaces 에서 Space를 생성하세요."라고 안내하고 중단합니다.
 
   **AskUserQuestion 호출 (Space가 1개여도 반드시 호출):**
   - question: "어떤 Space에 배포할까요?"
@@ -562,7 +695,7 @@ relay.yaml의 \`visibility\` 설정을 확인합니다.
 현재 설정을 확인합니다:
 
 **AskUserQuestion 호출:**
-- question: 공개일 때 "현재 **공개** 설정입니다. Space에 공개됩니다. 유지할까요?", 비공개일 때 "현재 **비공개** 설정입니다 (Space: {name}). 유지할까요?"
+- question: 공개일 때 "현재 **공개** 설정입니다. 유지할까요?", 링크공유일 때 "현재 **링크 공유** 설정입니다. 접근 링크가 있는 사람만 설치 가능합니다. 유지할까요?", 비공개일 때 "현재 **비공개** 설정입니다 (Space: {name}). 유지할까요?"
 - options: \`["유지", "변경"]\`
 
 "변경" → 신규 배포와 동일한 플로우
@@ -676,12 +809,13 @@ requires: env 2개, cli 1개
 - 출력에 코드블록이 없으면 아래 형태로 직접 생성합니다:
 
 \\\`\\\`\\\`
-npm install -g relayax-cli
-/relay:relay-install <slug>
+아래 가이드를 읽고 그대로 따라해줘:
+https://relayax.com/api/registry/{owner}/{slug}/guide.md
 \\\`\\\`\\\`
 
-- \`<slug>\`는 배포된 팀의 실제 슬러그로 치환합니다.
-- "이 블록을 팀원에게 공유하면 바로 설치할 수 있습니다"라고 안내합니다.
+- \`{owner}\`과 \`{slug}\`는 배포된 팀의 실제 슬러그에서 추출합니다 (\`@owner/slug\` → \`owner\`, \`slug\`).
+- "이 블록을 팀원에게 공유하면 Claude가 환경 체크부터 설치까지 자동으로 해줍니다"라고 안내합니다.
+- CLI가 이미 설치된 사용자를 위한 짧은 버전도 함께 표시: \`/relay:relay-install <slug>\`
 ${BUSINESS_CARD_FORMAT}
 
 ## 예시
@@ -697,10 +831,11 @@ ${BUSINESS_CARD_FORMAT}
 → AskUserQuestion: "이대로 배포할까요?" → ["배포", "취소"]
 → "배포" → relay publish 실행
 → "배포 완료! URL: https://relayax.com/@my-space/my-team"
-→ 온보딩 가이드 코드블록 표시`,
+→ 온보딩 가이드 코드블록 표시
+${ERROR_HANDLING_GUIDE}`,
     },
 ];
 // ─── Builder Commands (로컬 설치) ───
 // relay-publish가 글로벌로 승격되어 현재 비어있음.
-// relay init --update만 실행하면 모든 커맨드가 한번에 업데이트됨.
+// relay init --auto만 실행하면 모든 커맨드가 한번에 업데이트됨.
 exports.BUILDER_COMMANDS = [];

package/dist/lib/guide.d.ts

@@ -1,5 +1,13 @@
-/**
- * GUIDE.html 생성 프롬프트 템플릿.
- * publish slash command에서 Claude Code가 이 프롬프트를 읽고 GUIDE.html을 생성한다.
- */
-export declare const GUIDE_HTML_PROMPT: string;
+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;
+    visibility?: string;
+}, commands: CommandEntry[], requires?: Requires): string;
+export {};