relayax-cli 0.2.25 → 0.2.27

package/dist/lib/command-adapter.js

@@ -7,6 +7,8 @@ exports.BUILDER_COMMANDS = exports.USER_COMMANDS = void 0;
 exports.createAdapter = createAdapter;
 exports.getGlobalCommandPath = getGlobalCommandPath;
 exports.getGlobalCommandDir = getGlobalCommandDir;
+exports.getGlobalCommandDirForTool = getGlobalCommandDirForTool;
+exports.getGlobalCommandPathForTool = getGlobalCommandPathForTool;
 exports.formatCommandFile = formatCommandFile;
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
@@ -24,18 +26,31 @@ function createAdapter(tool) {
     };
 }
 /**
- * 글로벌 슬래시 커맨드 파일 경로.
+ * 글로벌 슬래시 커맨드 파일 경로 (Claude Code 기본).
  * ~/.claude/commands/relay/{id}.md
  */
 function getGlobalCommandPath(commandId) {
     return path_1.default.join(os_1.default.homedir(), '.claude', 'commands', 'relay', `${commandId}.md`);
 }
 /**
- * 글로벌 슬래시 커맨드 디렉토리.
+ * 글로벌 슬래시 커맨드 디렉토리 (Claude Code 기본).
  */
 function getGlobalCommandDir() {
     return path_1.default.join(os_1.default.homedir(), '.claude', 'commands', 'relay');
 }
+/**
+ * 특정 AI 도구의 글로벌 커맨드 디렉토리.
+ * ~/{skillsDir}/commands/relay/
+ */
+function getGlobalCommandDirForTool(skillsDir) {
+    return path_1.default.join(os_1.default.homedir(), skillsDir, 'commands', 'relay');
+}
+/**
+ * 특정 AI 도구의 글로벌 커맨드 파일 경로.
+ */
+function getGlobalCommandPathForTool(skillsDir, commandId) {
+    return path_1.default.join(os_1.default.homedir(), skillsDir, 'commands', 'relay', `${commandId}.md`);
+}
 /**
  * 커맨드 콘텐츠를 파일 형식으로 포맷.
  */
@@ -52,54 +67,114 @@ const LOGIN_JIT_GUIDE = `
 // ─── 명함 표시 포맷 ───
 const BUSINESS_CARD_FORMAT = `
 ### 빌더 명함 표시
-CLI 출력에 포함된 빌더 명함 정보를 반드시 아래 예시와 동일한 형태로 출력합니다.
+JSON 결과의 \`author\`, \`welcome\` 필드를 사용하여 명함을 표시합니다.
 불릿 리스트(- 또는 *)로 나열하지 마세요. 반드시 인용 블록(>) 안에 넣어야 합니다.
 
+**JSON 결과에서 사용할 필드:**
+- \`author.display_name\` 또는 \`author.username\` → 명함 제목
+- \`welcome\` → 환영 메시지 (💬)
+- \`author.contact_links\` → 연락처 배열 (\`[{type, label, value}]\`)
+- \`author.username\` → 프로필 링크 (👤)
+
 **예시 (이 형태를 그대로 따르세요):**
 
-> **🪪 devhaemin의 명함**
+JSON 결과 예시:
+\`\`\`json
+{
+  "author": { "username": "alice", "display_name": "Alice Kim", "contact_links": [
+    {"type": "email", "label": "이메일", "value": "alice@example.com"},
+    {"type": "website", "label": "블로그", "value": "https://alice.dev"},
+    {"type": "kakao", "label": "카카오", "value": "https://open.kakao.com/o/abc123"}
+  ]},
+  "welcome": "안녕하세요!\\n에이전트 빌더 Alice입니다.\\n설치해주셔서 감사합니다."
+}
+\`\`\`
+
+출력:
+
+> **🪪 Alice Kim의 명함**
 >
-> 💬 "안녕하세요!"
+> 💬 "안녕하세요!
+> 에이전트 빌더 Alice입니다.
+> 설치해주셔서 감사합니다."
 >
-> 📧 haemin@musibe.com
-> 👤 relayax.com/@devhaemin
+> 📧 alice@example.com
+> 🔗 블로그: alice.dev
+> 💬 카카오: open.kakao.com/o/abc123
+> 👤 relayax.com/@alice
 
-- 환영 메시지가 없으면 💬 줄을 생략합니다.
+- \`welcome\`이 없으면 💬 줄을 생략합니다.
+- 연락처의 type에 맞는 이모지: 📧 email, 💬 kakao, 🐦 x, 💼 linkedin, 💻 github, 🔗 website/custom
 - 연락처가 여러 개면 각각 한 줄씩 표시합니다.
-- 명함이 비어있으면 명함 블록 전체를 생략합니다.`;
+- \`author\`가 null이면 명함 블록 전체를 생략합니다.`;
 // ─── User Commands (글로벌 설치) ───
 exports.USER_COMMANDS = [
     {
-        id: 'relay-explore',
-        description: 'relay 마켓플레이스를 탐색하고 프로젝트에 맞는 팀을 찾습니다',
-        body: `사용자의 요청이나 현재 프로젝트 맥락에 맞는 에이전트 팀을 relay 마켓플레이스에서 탐색합니다.
+        id: 'relay-install',
+        description: 'relay 마켓플레이스에서 에이전트 팀을 설치합니다',
+        body: `요청된 에이전트 팀을 relay 마켓플레이스에서 다운로드하고, 현재 에이전트 환경에 맞게 구성합니다.
+인자 없이 호출하면 인터랙티브 탐색 모드로 진입합니다.
 
-## 실행 방법
+## 인터랙션 플로우
 
-1. 사용자의 요청에서 키워드를 추출합니다. 명시적 키워드가 없으면 현재 프로젝트를 분석하여 적절한 검색어를 판단합니다.
-2. \`relay search <keyword>\` 명령어를 실행합니다 (필요하면 여러 키워드로 반복).
-3. 결과를 현재 프로젝트 맥락과 대조하여 가장 도움될 팀을 추천합니다:
-   - 팀 이름과 설명
-   - 제공하는 커맨드 목록
-   - 왜 이 팀이 지금 프로젝트에 맞는지 설명
-4. 관심 있는 팀이 있다면 \`/relay-install <@author/slug>\`로 바로 설치할 수 있다고 안내합니다.
+이 커맨드는 3단계 인터랙션으로 진행됩니다. 각 단계에서 반드시 AskUserQuestion 도구를 사용하세요.
 
-## 예시
+### Step 1. 공간 선택 & 팀 탐색 (slug가 없을 때만)
 
-사용자: /relay-explore 콘텐츠 만들 수 있는 팀 있어?
-→ relay search 콘텐츠 실행
-→ 결과 해석: "contents-team이 카드뉴스, PDF, PPT를 만들 수 있어요"
-→ 프로젝트 맥락 기반 추천
-→ "/relay-install @example/contents-team으로 설치할 수 있어요"`,
-    },
-    {
-        id: 'relay-install',
-        description: 'relay 마켓플레이스에서 에이전트 팀을 설치합니다',
-        body: `요청된 에이전트 팀을 relay 마켓플레이스에서 다운로드하고, 현재 에이전트 환경에 맞게 구성합니다.
+slug가 직접 주어지면 (\`/relay-install @alice/doc-writer\`) 이 단계를 건너뛰고 Step 2로 갑니다.
 
-## 실행 방법
+#### 1-1. 공간 선택
+\`relay spaces --json\` 을 실행하여 사용자의 Space 목록을 가져옵니다.
+
+**AskUserQuestion 호출:**
+- question: "어디서 팀을 찾을까요?"
+- options: Space가 있으면 \`["마켓플레이스 (공개)", "<space1_name>", "<space2_name>", ...]\`, 없으면 이 단계를 건너뛰고 바로 마켓 검색으로 진행
+
+**응답 처리:**
+- "마켓플레이스 (공개)" → 1-2. 마켓 검색으로 진행
+- Space 이름 선택 → 1-3. Space 팀 목록으로 진행
+
+#### 1-2. 마켓 검색
+사용자의 요청에서 키워드를 추출합니다. 명시적 키워드가 없으면 현재 프로젝트를 분석하여 적절한 검색어를 판단합니다.
+\`relay search <keyword>\` 명령어를 실행합니다 (필요하면 여러 키워드로 반복).
+
+검색 결과를 번호 리스트로 보여줍니다:
+
+\`\`\`
+검색 결과 (3개)
+
+1. @alice/doc-writer — 기술 문서 자동화
+   /write-doc, /api-doc
+
+2. @bob/code-reviewer — PR 리뷰 자동화
+   /review, /suggest
+
+3. @carol/test-gen — 테스트 코드 생성
+   /gen-test, /coverage
+\`\`\`
+
+**AskUserQuestion 호출:**
+- question: "어떤 팀을 설치할까요?"
+- options: \`["1", "2", "3", "다시 검색"]\`
+
+"다시 검색" → 새 키워드로 1-2 반복
+번호 선택 → 해당 팀의 slug로 설치 진행
+
+#### 1-3. Space 팀 목록
+\`relay list --space <space-slug> --json\` 을 실행합니다.
+
+팀 목록을 번호 리스트로 보여줍니다 (1-2와 동일 형식).
+
+**AskUserQuestion 호출:**
+- question: "어떤 팀을 설치할까요?"
+- options: \`["1", "2", ..., "돌아가기"]\`
+
+"돌아가기" → 1-1로 돌아감
+번호 선택 → 해당 팀의 slug로 설치 진행
+
+### Step 2. 설치 & 배치 범위 선택
 
-### 1. 패키지 다운로드
+#### 2-1. 패키지 다운로드
 \`relay install <@author/slug> --json\` 명령어를 실행합니다.
 - Public 마켓 팀: \`relay install <@author/slug> --json\`
 - Space 팀: \`relay install @spaces/<space-slug>/<team-slug> --json\`
@@ -108,36 +183,30 @@ exports.USER_COMMANDS = [
 - CLI가 init과 login을 자동으로 처리합니다 (사용자가 별도 실행할 필요 없음).
 - JSON 출력에서 \`install_path\` (패키지 경로)를 확인합니다.
 
-### 2. 배치 범위 선택
-사용자에게 설치 범위를 물어봅니다:
+#### 2-2. 배치 범위 선택
 
-- **글로벌** (\`~/.claude/\`): 모든 프로젝트에서 사용 가능
-- **로컬** (현재 프로젝트 \`.claude/\`): 이 프로젝트에서만 사용
+**AskUserQuestion 호출:**
+- question: "어디에 설치할까요?"
+- options: \`["글로벌 (모든 프로젝트)", "로컬 (이 프로젝트만)"]\`
 
-판단 기준:
-- 범용 도구 (카드뉴스, PDF 생성 등): 글로벌 추천
-- 프로젝트 전용 팀: 로컬 추천
-- Space 비공개 팀: 로컬 추천
+**응답 처리:**
+- "글로벌" → \`~/.claude/\`에 배치
+- "로컬" → 현재 프로젝트 \`.claude/\`에 배치
 
-사용자가 별도 지정하지 않으면 글로벌로 진행합니다.
-
-### 3. 에이전트 환경에 맞게 배치
+#### 2-3. 에이전트 환경에 맞게 배치
 다운로드된 패키지(\`install_path\`)에서 파일을 읽고 선택된 범위에 배치합니다:
-- Claude Code 글로벌: \`<install_path>/commands/\` → \`~/.claude/commands/\`에 복사
-- Claude Code 글로벌: \`<install_path>/skills/\` → \`~/.claude/skills/\`에 복사
-- Claude Code 로컬: \`<install_path>/commands/\` → \`.claude/commands/\`에 복사
-- Claude Code 로컬: \`<install_path>/skills/\` → \`.claude/skills/\`에 복사
+- 글로벌: \`<install_path>/commands/\` → \`~/.claude/commands/\`에 복사, skills/ 동일
+- 로컬: \`<install_path>/commands/\` → \`.claude/commands/\`에 복사, skills/ 동일
 - agents/, rules/ 파일도 같은 방식으로 배치합니다.
 - **충돌 확인**: 같은 이름의 파일이 이미 있으면 사용자에게 덮어쓸지 물어봅니다.
 
-### 4. 배치 정보 기록 (필수)
-배치 완료 후 반드시 \`relay deploy-record\`를 실행하여 배치 정보를 기록합니다:
+#### 2-4. 배치 정보 기록 (필수)
+배치 완료 후 반드시 \`relay deploy-record\`를 실행합니다:
 \`\`\`
 relay deploy-record <slug> --scope <global|local> --files <배치된_파일1> <배치된_파일2> ...
 \`\`\`
-이 정보는 \`relay uninstall\` 시 배치된 파일까지 정리하는 데 사용됩니다.
 
-### 5. Requirements 확인 및 설치
+#### 2-5. Requirements 확인 및 설치
 \`<install_path>/relay.yaml\`의 \`requires\` 섹션을 읽고 처리합니다:
 - **cli**: \`which <name>\`으로 확인 → 없으면 install 명령 실행 또는 안내
 - **npm**: \`npm list <package>\`로 확인 → 없으면 \`npm install\`
@@ -147,125 +216,145 @@ relay deploy-record <slug> --scope <global|local> --files <배치된_파일1> <
 - **teams**: 의존하는 다른 팀 → \`relay install <@author/team>\`으로 재귀 설치
 ${LOGIN_JIT_GUIDE}
 
-### 6. 완료 안내
+### Step 3. 완료 & 팔로우 제안
+
+#### 3-1. 완료 안내
 - 배치된 파일과 활성화된 커맨드 목록을 보여줍니다.
 ${BUSINESS_CARD_FORMAT}
-- **팔로우 제안**: 사용자에게 직접 질문하는 인터랙티브 도구(예: AskUserQuestion 등)를 사용하여 "@{username}을 팔로우할까요? 새 버전 알림을 받을 수 있습니다."라고 반드시 물어봅니다. 인터랙티브 도구가 없으면 텍스트로 물어봅니다.
-  - 수락하면: \`relay follow @{username}\` 실행. 로그인이 안 되어 있으면 먼저 \`relay login\` 실행 후 재시도.
-  - 거절하면: 건너뜁니다
+
+#### 3-2. 팔로우 제안 (필수 — 이 단계를 절대 건너뛰지 마세요)
+명함 표시 직후, 빌더의 username이 JSON 결과에 있으면 **반드시** AskUserQuestion 도구를 호출하세요.
+
+**AskUserQuestion 호출:**
+- question: \`@{username}을 팔로우할까요? 새 버전 알림을 받을 수 있습니다.\`
+- options: \`["팔로우", "건너뛰기"]\`
+
+**응답 처리:**
+- "팔로우" → \`relay follow @{username}\` 실행. 로그인이 안 되어 있으면 \`relay login\` 먼저 실행 후 재시도.
+- "건너뛰기" → 다음 단계로 진행
+
+#### 3-3. 사용 제안
 - "바로 사용해볼까요?" 제안
 
-### 7. 업데이트 확인 (설치 완료 후)
+#### 3-4. 업데이트 확인
 - \`relay check-update\` 명령어를 실행합니다.
 - CLI 업데이트가 있으면 안내합니다: "relay v{new} available. Run: npm update -g relayax-cli"
 - 다른 팀 업데이트가 있으면 안내합니다.
 
 ## 예시
 
-사용자: /relay-install @example/contents-team
-→ relay install @example/contents-team --json 실행 (패키지 다운로드)
-→ 사용자에게 "글로벌 vs 로컬" 선택 질문 → 글로벌
-→ .relay/teams/ 내용을 ~/.claude/에 배치
-→ relay deploy-record @example/contents-team --scope global --files ~/.claude/commands/cardnews.md ...
-→ requires 확인: ✓ playwright 설치됨, ✓ sharp 설치됨
-→ "✓ 설치 완료! /cardnews를 사용해볼까요?"`,
+### 인터랙티브 모드 (/relay-install)
+→ relay spaces --json 실행
+→ AskUserQuestion: "어디서 팀을 찾을까요?" → ["마켓플레이스 (공개)", "Acme Corp"]
+→ "마켓플레이스" 선택 → "어떤 팀을 찾고 계세요?"
+→ relay search "문서" 실행 → 결과 리스트 표시
+→ AskUserQuestion: "어떤 팀을 설치할까요?" → ["1", "2", "3", "다시 검색"]
+→ "1" 선택 (@alice/doc-writer)
+→ AskUserQuestion: "어디에 설치할까요?" → ["글로벌 (모든 프로젝트)", "로컬 (이 프로젝트만)"]
+→ "글로벌" 선택
+→ 설치 + 배치 + deploy-record
+→ 명함 표시
+→ AskUserQuestion: "@alice을 팔로우할까요?" → ["팔로우", "건너뛰기"]
+→ "✓ 설치 완료! /write-doc를 사용해볼까요?"
+
+### 다이렉트 모드 (/relay-install @alice/doc-writer)
+→ relay install @alice/doc-writer --json 실행 (Step 1 건너뜀)
+→ AskUserQuestion: "어디에 설치할까요?" → ["글로벌 (모든 프로젝트)", "로컬 (이 프로젝트만)"]
+→ 설치 + 배치 + deploy-record
+→ 명함 표시
+→ AskUserQuestion: "@alice을 팔로우할까요?" → ["팔로우", "건너뛰기"]
+→ "✓ 설치 완료! /write-doc를 사용해볼까요?"`,
     },
     {
-        id: 'relay-list',
-        description: '설치된 에이전트 팀 목록을 확인합니다',
-        body: `현재 설치된 에이전트 팀 목록을 보여줍니다.
+        id: 'relay-status',
+        description: '설치된 팀과 Space 현황을 확인합니다',
+        body: `현재 설치된 에이전트 팀과 소속 Space 현황을 한눈에 보여줍니다.
 
 ## 실행 방법
 
-1. \`relay list --json\` 명령어를 실행합니다.
-2. 결과를 사용자에게 보기 좋게 정리하여 보여줍니다:
-   - 팀 이름과 버전
-   - 설치 날짜
-   - 사용 가능한 커맨드
-3. 설치된 팀이 없으면 \`/relay-explore\`로 팀을 탐색해보라고 안내합니다.
+### 1. 설치된 팀 목록
 
-### Space 팀 목록 확인
-- 특정 Space에서 사용 가능한 팀 목록을 보려면: \`relay list --space <space-slug> --json\`
-- Space에 가입되어 있어야 합니다.
+\`relay list --json\` 명령어를 실행합니다.
 
-## 예시
-
-사용자: /relay-list
-→ relay list --json 실행
-→ "2개 팀이 설치되어 있어요:"
-→ "  @example/contents-team v1.2.0 (2일 전 설치) - /cardnews, /pdf-report"
-→ "  qa-team v0.5.1 (1주 전 설치) - /qa, /qa-only"
-
-사용자: /relay-list --space bobusan
-→ relay list --space bobusan --json 실행
-→ "bobusan Space에서 설치 가능한 팀:"
-→ "  pm-bot — 프로젝트 관리 봇"
-→ "  cs-bot — 고객 응대 봇"`,
-    },
+**JSON 응답 구조:**
+\`\`\`json
+{
+  "installed": [
     {
-        id: 'relay-update',
-        description: '설치된 에이전트 팀을 최신 버전으로 업데이트합니다',
-        body: `설치된 에이전트 팀의 업데이트를 확인하고 적용합니다.
+      "slug": "@author/team-name",
+      "version": "1.2.0",
+      "installed_at": "2026-03-20T12:00:00.000Z",
+      "scope": "global",
+      "deploy_scope": "global",
+      "space_slug": null
+    }
+  ]
+}
+\`\`\`
 
-## 실행 방법
+**각 팀을 아래 형식으로 표시:**
 
-### 0. CLI 업데이트 확인
-- 먼저 \`relay check-update\` 명령어를 실행합니다.
-- CLI 업데이트가 있으면 사용자에게 안내합니다: "relay v{new} available. Run: npm update -g relayax-cli"
-- 업데이트 여부와 관계없이 팀 업데이트를 계속 진행합니다.
-
-### 특정 팀 업데이트
-- 사용자가 팀 이름을 지정한 경우: \`relay update <@author/slug> --json\` 실행
-- 업데이트 결과를 보여줍니다 (이전 버전 → 새 버전)
-- **재배치 필요 확인**: JSON 출력에 \`needs_redeploy: true\`가 있으면:
-  1. \`previous_deploy_scope\`를 참고하여 같은 범위(글로벌/로컬)로 파일을 다시 배치합니다.
-  2. 배치 후 \`relay deploy-record <slug> --scope <scope> --files <...>\`를 실행하여 기록합니다.
-${BUSINESS_CARD_FORMAT}
+| 팀 | 버전 | 배포 | 설치일 |
+|---|---|---|---|
+| @author/team-name | v1.2.0 | 글로벌 | 3/20 |
 
-### 전체 업데이트 확인
-- 팀 이름을 지정하지 않은 경우:
-  1. \`relay outdated --json\`으로 업데이트 가능한 팀 목록을 확인합니다.
-  2. 업데이트 가능한 팀이 있으면 목록을 보여주고 어떤 팀을 업데이트할지 물어봅니다.
-  3. 선택된 팀에 대해 \`relay update <@author/slug> --json\`을 실행합니다.
-  4. 모두 최신이면 "모든 팀이 최신 버전입니다"라고 안내합니다.
+- \`deploy_scope\`가 \`"global"\` → 글로벌, \`"local"\` → 로컬, 없으면 → 미배치
+- \`space_slug\`가 있으면 \`[Space: slug]\` 표시
 
-## 예시
+### 2. Space 목록
 
-사용자: /relay-update
-→ relay outdated --json 실행
-→ "1개 팀 업데이트 가능:"
-→ "  @example/contents-team: v1.2.0 → v1.3.0"
-→ "업데이트할까요?"
-→ relay update @example/contents-team --json 실행
-→ needs_redeploy: true → 글로벌로 재배치
-→ relay deploy-record @example/contents-team --scope global --files ...
-→ "✓ @example/contents-team v1.3.0으로 업데이트 완료"`,
-    },
-    {
-        id: 'relay-spaces',
-        description: '내 Space 목록을 확인합니다',
-        body: `사용자의 Space 목록을 조회하고 보여줍니다.
+\`relay spaces --json\` 명령어를 실행합니다.
 
-## 실행 방법
+**JSON 응답 구조:**
+\`\`\`json
+{
+  "spaces": [
+    {
+      "slug": "my-space",
+      "name": "내 스페이스",
+      "description": "설명",
+      "is_personal": false,
+      "role": "owner"
+    }
+  ]
+}
+\`\`\`
 
-1. \`relay spaces --json\` 명령어를 실행합니다.
-2. 결과를 사용자에게 보기 좋게 정리합니다:
-   - 개인 스페이스
-   - 팀 스페이스 (이름, 역할, 설명)
-3. Space가 있으면 관련 활용법을 안내합니다:
-   - 팀 목록 보기: \`relay list --space <slug>\`
-   - 비공개 팀 설치: \`relay install @spaces/<slug>/<team>\`
-   - Space 관리: www.relayax.com/spaces/<slug>
+**표시:**
+- \`is_personal: true\` → 개인 스페이스로 분류
+- \`role\`: owner → 소유자, admin → 관리자, member → 멤버
 ${LOGIN_JIT_GUIDE}
+- Spaces 조회 실패해도 설치된 팀 목록은 정상 표시합니다 (로컬 데이터).
+
+### 3. Space 팀 목록 (옵션)
+- \`--space <slug>\` 인자가 있으면: \`relay list --space <space-slug> --json\`으로 해당 Space에서 설치 가능한 팀 목록도 보여줍니다.
+
+### 4. 안내
+- 설치된 팀이 없으면 \`/relay-install\`로 팀을 탐색·설치해보라고 안내합니다.
+- Space가 있으면 활용법을 안내합니다:
+  - 비공개 팀 설치: \`relay install @spaces/<slug>/<team>\`
+  - Space 관리: www.relayax.com/spaces/<slug>
 
 ## 예시
 
-사용자: /relay-spaces
-→ relay spaces --json 실행
-→ "2개 Space가 있어요:"
-→ "  bobusan — 보부산 (소유자)"
-→ "  design-lab — 디자인 랩 (멤버)"
-→ "💡 Space 팀 보기: relay list --space bobusan"`,
+사용자: /relay-status
+→ relay list --json 실행
+→ relay spaces --json 실행 (병렬 가능)
+
+**설치된 팀 (2개)**
+
+| 팀 | 버전 | 배포 | 설치일 |
+|---|---|---|---|
+| @alice/doc-writer | v1.2.0 | 글로벌 | 3/20 |
+| @bob/code-reviewer | v0.5.1 | 로컬 | 3/15 |
+
+**내 Space (2개)**
+- acme-corp — Acme Corp (소유자)
+- dev-guild — Dev Guild (멤버)
+
+사용자: /relay-status --space acme-corp
+→ 위 정보 + \`relay list --space acme-corp --json\` 실행
+→ acme-corp Space에서 설치 가능한 팀 목록 추가 표시`,
     },
     {
         id: 'relay-uninstall',
@@ -284,9 +373,9 @@ ${LOGIN_JIT_GUIDE}
 
 ## 예시
 
-사용자: /relay-uninstall @example/contents-team
-→ relay uninstall @example/contents-team --json 실행
-→ "✓ @example/contents-team 삭제 완료 (12개 파일 제거)"`,
+사용자: /relay-uninstall @alice/doc-writer
+→ relay uninstall @alice/doc-writer --json 실행
+→ "✓ @alice/doc-writer 삭제 완료 (12개 파일 제거)"`,
     },
 ];
 // ─── Builder Commands (로컬 설치) ───
@@ -296,51 +385,92 @@ exports.BUILDER_COMMANDS = [
         description: '현재 팀 패키지를 포트폴리오와 함께 relay 마켓플레이스에 배포합니다',
         body: `현재 디렉토리의 에이전트 팀(.relay/)을 분석하고, 보안 점검 및 requirements를 구성한 뒤, 사용가이드와 포트폴리오를 생성하고 relay 마켓플레이스에 배포합니다.
 
-## 실행 단계
+## 사전 준비 (자동)
 
-### 1. 인증 확인 (가장 먼저)
+### 0-1. 인증 확인
 - \`relay status --json\` 명령어를 실행하여 로그인 상태를 확인합니다.
 - 미인증이면 즉시 \`relay login\`을 실행합니다.
-- 로그인 완료 후 다음 단계로 진행합니다.
 ${LOGIN_JIT_GUIDE}
 
-### 2. 팀 구조 분석
+### 0-2. 팀 구조 분석
 - .relay/ 디렉토리의 skills/, agents/, rules/, commands/를 탐색합니다.
 - 각 파일의 이름과 description을 추출합니다.
 - .relay/relay.yaml이 있으면 읽고, 없으면 사용자에게 팀 정보(name, slug, description, tags)를 물어보고 생성합니다.
 
-### 3. 보안 점검 & Requirements 구성 (HITL)
+## 인터랙션 플로우
+
+이 커맨드는 5단계 인터랙션으로 진행됩니다. 각 단계에서 반드시 AskUserQuestion 도구를 사용하세요.
+
+### Step 1. 공개 범위 선택
+
+relay.yaml의 \`visibility\` 설정을 확인합니다.
+
+#### 신규 배포 (visibility 미설정)
+
+**AskUserQuestion 호출:**
+- question: "어디에 배포할까요?"
+- options: \`["공개 (마켓플레이스)", "비공개 (Space 전용)"]\`
+
+**응답 처리:**
+- "공개" → relay.yaml에 \`visibility: public\` 저장
+- "비공개" → \`relay spaces --json\` 실행 후 Space 목록 표시
+
+  **AskUserQuestion 호출:**
+  - question: "어떤 Space에 배포할까요?"
+  - options: \`["<space1_name>", "<space2_name>", ...]\`
+
+  → relay.yaml에 \`visibility: private\`, \`space: <selected_slug>\` 저장
+
+#### 재배포 (visibility 이미 설정됨)
 
-.relay/ 내 모든 파일을 읽고 아래 항목을 분석합니다.
+현재 설정을 확인합니다:
 
-#### 3-1. 시크릿 스캔
+**AskUserQuestion 호출:**
+- question: 공개일 때 "현재 **공개** 설정입니다. 마켓플레이스에 노출됩니다. 유지할까요?", 비공개일 때 "현재 **비공개** 설정입니다 (Space: {name}). 유지할까요?"
+- options: \`["유지", "변경"]\`
+
+"변경" → 신규 배포와 동일한 플로우
+
+### Step 2. 보안 점검 & requires 확인
+
+.relay/ 내 모든 파일을 자동 분석합니다.
+
+#### 2-1. 시크릿 스캔 (자동)
 - 하드코딩된 API 키, 토큰, 비밀번호, Private Key 등을 탐색합니다.
   - 예: sk-..., ghp_..., AKIA..., Bearer 토큰, JWT, -----BEGIN PRIVATE KEY----- 등
 - 발견 시 **즉시 사용자에게 경고**하고, 환경변수로 대체하도록 안내합니다.
 - 시크릿이 제거되지 않으면 배포를 진행하지 않습니다.
 
-#### 3-2. 환경변수 감지
-- 파일 내 환경변수 참조를 감지합니다 (process.env.*, \${VAR}, os.environ 등).
-- 각 환경변수에 대해 사용자에게 확인합니다:
-  - "이 환경변수가 필수인가요, 선택인가요?"
-  - 설명을 추가할 수 있습니다.
-
-#### 3-3. 의존성 감지
-아래 카테고리별로 분석하고, 사용자에게 필수/선택 여부를 확인합니다:
-
-- **cli**: 파일에서 참조하는 CLI 도구 (playwright, ffmpeg, sharp 등)
+#### 2-2. 환경변수 & 의존성 분석 (자동)
+분석 대상:
+- **env**: 환경변수 참조 (process.env.*, \${VAR}, os.environ 등)
+- **cli**: 참조하는 CLI 도구 (playwright, ffmpeg, sharp 등)
 - **npm**: import/require되는 npm 패키지
-- **mcp**: MCP 서버 설정 — 외부 서비스 연결 포함 (name, package, config, 필요한 env)
-- **runtime**: Node.js/Python 등 최소 버전 요구
-- **permissions**: 필요한 에이전트 권한 (filesystem, network, shell)
+- **mcp**: MCP 서버 설정
+- **runtime**: Node.js/Python 등 최소 버전
 - **teams**: 의존하는 다른 relay 팀
 
-각 항목에 대해:
-- \`required: true/false\` — 없으면 팀이 동작하지 않는지, 부분 동작인지
-- \`description\` — 왜 필요한지 짧은 설명
+분석 결과를 요약 표시합니다:
+
+\`\`\`
+requires 분석 결과
 
-#### 3-4. .relay/relay.yaml에 requires 반영
-분석 결과를 .relay/relay.yaml의 requires 섹션에 저장합니다.
+환경변수:
+  OPENAI_API_KEY — 필수 (LLM API 호출)
+  SLACK_WEBHOOK_URL — 선택 (알림 전송)
+
+CLI: playwright (필수)
+npm: sharp (필수)
+MCP: supabase (선택)
+\`\`\`
+
+**AskUserQuestion 호출:**
+- question: "requires 설정이 맞나요?"
+- options: \`["확인", "수정"]\`
+
+**응답 처리:**
+- "확인" → .relay/relay.yaml에 requires 섹션 저장, 다음 단계로
+- "수정" → 사용자와 텍스트 대화로 수정 후 다시 확인
 
 \`\`\`yaml
 # .relay/relay.yaml requires 구조
@@ -367,95 +497,116 @@ requires:
         command: "npx"
         args: ["-y", "@supabase/mcp-server"]
       env: [SUPABASE_URL, SUPABASE_SECRET_KEY]
-    - name: notion
-      package: "@notionhq/mcp-server"
-      required: false
-      env: [NOTION_API_KEY]
   runtime:
     node: ">=18"
   permissions:
     - filesystem
     - network
   teams:
-    - @example/contents-team
+    - @alice/doc-writer
 \`\`\`
 
-### 4. 포트폴리오 수집
+### Step 3. 포트폴리오 선택
+
+output/, results/, examples/, portfolio/ 디렉토리를 스캔하여 결과물(PNG, JPG, HTML, PDF)을 찾습니다.
+HTML 파일은 Playwright 스크린샷으로 변환합니다.
 
-- output/, results/, examples/, portfolio/ 디렉토리를 스캔합니다.
-- 발견된 결과물(PNG, JPG, HTML, PDF)을 사용자에게 보여줍니다.
-- HTML 파일은 Playwright 스크린샷으로 변환합니다.
-- 사용자가 포트폴리오에 포함할 항목을 선택합니다.
-- 선택된 이미지를 .relay/portfolio/에 저장합니다.
+발견된 파일을 번호 리스트로 보여줍니다:
 
-### 5. 사용가이드 생성 (GUIDE.html)
+\`\`\`
+포트폴리오 후보 (4개)
+
+1. output/report-example.png — 리포트 예시
+2. output/dashboard.html → 스크린샷 변환
+3. examples/result-1.png — 결과물 1
+4. examples/result-2.png — 결과물 2
+\`\`\`
+
+**AskUserQuestion 호출:**
+- question: "어떤 결과물을 포트폴리오에 포함할까요? (최대 5개)"
+- options: \`["전체 포함", "1", "2", "3", "4", "건너뛰기"]\`
+
+**응답 처리:**
+- "전체 포함" → 모든 파일을 .relay/portfolio/에 저장
+- 번호 선택 → 해당 파일만 포함 (여러 번 선택 가능 — 한 번 선택 후 추가 선택 여부를 다시 물어봄)
+- "건너뛰기" → 포트폴리오 없이 진행
+
+선택된 이미지를 .relay/portfolio/에 저장하고 relay.yaml의 portfolio.gallery에 등록합니다.
+
+\`\`\`yaml
+portfolio:
+  demo:                          # 선택
+    type: gif
+    path: portfolio/demo.gif
+  gallery:                       # 선택, 최대 5장
+    - path: portfolio/guide-preview.png
+      title: "사용가이드 미리보기"
+    - path: portfolio/report-example.png
+      title: "리포트 예시"
+\`\`\`
+
+파일이 하나도 발견되지 않으면 이 단계를 건너뜁니다.
+
+### Step 4. GUIDE.html 컨펌
 
 설치자가 읽을 수 있는 사용가이드를 HTML로 생성합니다.
 
-#### 5-1. 팀 소스 분석
+#### 4-1. 팀 소스 분석 (자동)
 - skills/, agents/, commands/ 디렉토리의 **모든 파일 내용**을 읽습니다.
 - 각 스킬의 SKILL.md, 에이전트 설정, 커맨드 문서를 분석하여 팀의 파이프라인 흐름을 추론합니다.
 
-#### 5-2. GUIDE.html 생성
+#### 4-2. GUIDE.html 생성 (자동)
 - 팀의 핵심 기능, 시작 방법, 파이프라인 흐름, Q&A를 포함하는 단일 HTML 가이드를 생성합니다.
 - 디자인: 깔끔한 단일 페이지, 시스템 폰트, 최대 1200px 너비, 라이트 테마.
-- 5-1에서 분석한 팀 소스 정보를 기반으로 콘텐츠를 구성합니다.
 - 파이프라인이 없는 단순한 팀은 시작 방법 + 기능 설명 + Q&A만 포함합니다.
 
-#### 5-3. 미리보기 + 컨펌
-- 생성된 GUIDE.html을 브라우저에서 열어 빌더에게 미리보기를 보여줍니다.
-- 빌더에게 확인: "사용가이드를 확인해주세요. 이대로 진행할까요?"
+#### 4-3. 미리보기 + 컨펌
+생성된 GUIDE.html을 브라우저에서 열어 빌더에게 미리보기를 보여줍니다.
 
-#### 5-4. 재생성 루프
-- 빌더가 수정을 요청하면 (예: "Q&A 추가해줘", "파이프라인 설명 더 자세히") 요청사항을 반영하여 GUIDE.html을 재생성합니다.
-- 재생성 후 다시 브라우저에서 미리보기를 보여줍니다.
-- 빌더가 컨펌할 때까지 반복합니다.
+**AskUserQuestion 호출:**
+- question: "사용가이드를 확인해주세요. 진행할까요?"
+- options: \`["진행", "수정 요청"]\`
 
-#### 5-5. 저장
-- 컨펌된 GUIDE.html을 \`.relay/GUIDE.html\`에 저장합니다.
+**응답 처리:**
+- "진행" → GUIDE.html을 \`.relay/GUIDE.html\`에 저장
+- "수정 요청" → 사용자와 텍스트 대화로 수정사항 파악 → GUIDE.html 재생성 → 다시 미리보기 → AskUserQuestion 반복
 
-#### 5-6. GUIDE.html 스크린샷 → gallery 등록
-- GUIDE.html을 Playwright로 열어 첫 화면(뷰포트 1200x630)을 스크린샷 캡처합니다. (gstack 또는 webapp-testing 스킬 활용)
+#### 4-4. GUIDE.html 스크린샷 → gallery 등록 (자동)
+- GUIDE.html을 Playwright로 열어 첫 화면(뷰포트 1200x630)을 스크린샷 캡처합니다.
 - 결과 PNG를 \`./portfolio/guide-preview.png\`에 저장합니다.
 - relay.yaml의 portfolio gallery 첫 번째 항목으로 자동 등록합니다.
 - 이 이미지는 마켓플레이스 카드 및 OG 이미지의 fallback으로 사용됩니다 (demo > gallery 순).
 
-### 6. 메타데이터 생성
+### Step 5. 최종 확인 & 배포
+
+#### 5-1. 메타데이터 생성 (자동)
 - description: skills 내용 기반으로 자동 생성합니다.
 - long_description: 팀 소개 마크다운을 자동 생성합니다 (README.md가 있으면 활용).
 - tags: 팀 특성에 맞는 태그를 추천합니다.
-- 사용자에게 확인: "이대로 배포할까요?"
 
-### 7. 공개 범위 확인 (필수)
-- .relay/relay.yaml에 \`visibility\`가 반드시 설정되어 있어야 합니다.
-- 설정되어 있지 않으면 빌더에게 반드시 물어봅니다:
-  - "공개 (마켓플레이스에 누구나 검색·설치 가능)" vs "비공개 (Space 멤버만 접근)"
-- 선택 결과를 relay.yaml에 저장합니다.
-- 이미 설정되어 있으면 현재 값을 확인합니다:
-  - 공개인 경우: "⚠ 이 팀은 **공개**로 설정되어 있어 마켓플레이스에 노출됩니다. 맞나요?"
-  - 비공개인 경우: "이 팀은 **비공개**로 설정되어 Space 멤버만 접근 가능합니다."
-- 빌더가 변경을 원하면 relay.yaml을 업데이트합니다.
+#### 5-2. 배포 요약 + 최종 확인
+배포할 내용을 요약 표시합니다:
 
-### 8. .relay/relay.yaml 업데이트
-- 메타데이터, requires, 포트폴리오 슬롯을 .relay/relay.yaml에 반영합니다.
+\`\`\`
+배포 요약
 
-\`\`\`yaml
-portfolio:
-  demo:                          # 선택
-    type: gif
-    path: portfolio/demo.gif
-  gallery:                       # 선택, 최대 5장
-    - path: portfolio/guide-preview.png
-      title: "사용가이드 미리보기"
-    - path: portfolio/example-1.png
-      title: "카드뉴스 예시"
+팀: my-team v1.0.0
+공개: 마켓플레이스 (공개)
+Skills: 3개, Commands: 5개
+포트폴리오: 2장
+requires: env 2개, cli 1개
 \`\`\`
 
-### 9. 배포
-- \`relay publish\` 명령어를 실행합니다.
-- 배포 결과와 마켓플레이스 URL을 보여줍니다.
+**AskUserQuestion 호출:**
+- question: "이대로 배포할까요?"
+- options: \`["배포", "취소"]\`
+
+**응답 처리:**
+- "배포" → \`relay publish\` 실행
+- "취소" → 중단
 
-### 10. 공유용 온보딩 가이드 제공
+#### 5-3. 배포 완료 & 온보딩 가이드
+- 배포 결과와 마켓플레이스 URL을 보여줍니다.
 - \`relay publish\` 출력 끝에 코드블록 형태의 온보딩 가이드가 포함됩니다.
 - 이 코드블록을 사용자에게 그대로 보여줍니다.
 - 출력에 코드블록이 없으면 아래 형태로 직접 생성합니다:
@@ -473,16 +624,22 @@ ${BUSINESS_CARD_FORMAT}
 ## 예시
 
 사용자: /relay-publish
-→ 팀 구조 분석: skills 3개, commands 5개
-→ 보안 스캔: ✓ 시크릿 없음
-→ 환경변수 감지: OPENAI_API_KEY (필수), DATABASE_URL (선택)
-→ requires 업데이트 완료
-→ 포트폴리오: output/ 스캔 → "카드뉴스 예시.png 포함?" → Yes
-→ GUIDE.html 생성 → 브라우저에서 미리보기 → 빌더 컨펌
-→ GUIDE.html 스크린샷 → gallery 첫 번째 이미지로 등록
-→ relay publish 실행
+→ 인증 확인 ✓, 팀 구조 분석 (skills 3개, commands 5개)
+→ AskUserQuestion: "어디에 배포할까요?" → ["공개 (마켓플레이스)", "비공개 (Space 전용)"]
+→ "공개" 선택
+→ 보안 스캔 ✓ 시크릿 없음 → requires 분석 결과 표시
+→ AskUserQuestion: "requires 설정이 맞나요?" → ["확인", "수정"]
+→ "확인"
+→ 포트폴리오 후보 스캔 → 리스트 표시
+→ AskUserQuestion: "어떤 결과물을 포함할까요?" → ["전체 포함", "1", "2", "건너뛰기"]
+→ "1" 선택
+→ GUIDE.html 생성 → 브라우저 미리보기
+→ AskUserQuestion: "사용가이드 진행할까요?" → ["진행", "수정 요청"]
+→ "진행"
+→ 배포 요약 표시
+→ AskUserQuestion: "이대로 배포할까요?" → ["배포", "취소"]
+→ "배포" → relay publish 실행
 → "배포 완료! URL: https://relayax.com/teams/my-team"
-→ 온보딩 가이드 코드블록 표시
-→ "이 블록을 팀원에게 공유하면 바로 설치할 수 있습니다"`,
+→ 온보딩 가이드 코드블록 표시`,
     },
 ];