relayax-cli 0.4.14 → 0.4.16

package/dist/commands/package.d.ts

@@ -8,7 +8,8 @@ import type { ContentType } from '../lib/ai-tools.js';
 export interface ContentEntry {
     name: string;
     type: ContentType;
-    from: string;
+    from?: string;
+    path?: string;
 }
 type ContentDiffStatus = 'modified' | 'unchanged' | 'source_missing';
 interface ContentDiffEntry {

package/dist/commands/package.js

@@ -16,6 +16,14 @@ const js_yaml_1 = __importDefault(require("js-yaml"));
 const ai_tools_js_1 = require("../lib/ai-tools.js");
 const paths_js_1 = require("../lib/paths.js");
 const SYNC_DIRS = ['skills', 'commands', 'agents', 'rules'];
+/** from 또는 path 중 존재하는 값을 반환 */
+function getFromPath(entry) {
+    const val = entry.from ?? entry.path;
+    if (!val) {
+        throw new Error(`contents 항목 "${entry.name}"에 from 또는 path가 필요합니다.`);
+    }
+    return val;
+}
 // ─── Helpers ───
 function fileHash(filePath) {
     const content = fs_1.default.readFileSync(filePath);
@@ -121,7 +129,7 @@ function scanPath(absPath) {
 function computeContentsDiff(contents, relayDir, projectPath) {
     const diff = [];
     for (const entry of contents) {
-        const absFrom = resolveFromPath(entry.from, projectPath);
+        const absFrom = resolveFromPath(getFromPath(entry), projectPath);
         if (!fs_1.default.existsSync(absFrom)) {
             diff.push({ name: entry.name, type: entry.type, status: 'source_missing' });
             continue;
@@ -152,7 +160,8 @@ function computeContentsDiff(contents, relayDir, projectPath) {
  *     ~/.claude/agents/dev-lead.md → agents/dev-lead.md
  */
 function deriveRelaySubPath(entry) {
-    const from = entry.from.startsWith('~/') ? entry.from.slice(2) : entry.from;
+    const fromPath = getFromPath(entry);
+    const from = fromPath.startsWith('~/') ? fromPath.slice(2) : fromPath;
     // skills/xxx, agents/xxx 등의 패턴을 추출
     for (const dir of SYNC_DIRS) {
         const idx = from.indexOf(`/${dir}/`);
@@ -211,7 +220,7 @@ function syncContentsToRelay(contents, contentsDiff, relayDir, projectPath) {
         const content = contents.find((c) => c.name === diffEntry.name && c.type === diffEntry.type);
         if (!content)
             continue;
-        const absFrom = resolveFromPath(content.from, projectPath);
+        const absFrom = resolveFromPath(getFromPath(content), projectPath);
         const relaySubPath = deriveRelaySubPath(content);
         const relayTarget = path_1.default.join(relayDir, relaySubPath);
         // 단일 파일인 경우 직접 복사 (디렉토리 기반 diff/sync 불필요)

package/dist/commands/publish.js

@@ -784,28 +784,28 @@ function registerPublish(program) {
                 // preamble update is best-effort — publish already succeeded
             }
             if (json) {
-                console.log(JSON.stringify(result));
+                // Enrich JSON output with plugin_url if git_url available
+                const jsonResult = { ...result };
+                const resultGitUrl = jsonResult.git_url;
+                if (resultGitUrl) {
+                    const pSlug = jsonResult.slug.startsWith('@') ? jsonResult.slug.slice(1) : jsonResult.slug;
+                    const pName = pSlug.includes('/') ? pSlug.split('/')[1] : pSlug;
+                    jsonResult.plugin_url = `${config_js_1.API_URL}/api/registry/${pSlug}/plugin`;
+                    jsonResult.plugin_install_cmd = `/plugin install ${pName}`;
+                }
+                jsonResult.platforms = generatedPlatforms;
+                console.log(JSON.stringify(jsonResult));
             }
             else {
                 console.log(`\n\x1b[32m✓ ${config.name} 배포 완료\x1b[0m  v${result.version}`);
                 console.log(`  슬러그: \x1b[36m${result.slug}\x1b[0m`);
                 console.log(`  URL:    \x1b[36m${result.url}\x1b[0m`);
-                // Show generated platform manifests
-                if (generatedPlatforms.length > 0) {
-                    console.log(`\n  \x1b[90m플랫폼 매니페스트:\x1b[0m ${generatedPlatforms.join(', ')}`);
-                }
-                // Show Claude Code plugin install command if claude-code manifest was generated
-                if (generatedPlatforms.includes('claude-code')) {
-                    const pluginSlug = result.slug.startsWith('@') ? result.slug.slice(1) : result.slug;
-                    const pluginUrl = `${config_js_1.API_URL}/api/registry/@${pluginSlug}/plugin`;
-                    console.log(`\n  \x1b[90mClaude Code 플러그인:\x1b[0m`);
-                    console.log(`  \x1b[36m/plugin marketplace add ${pluginUrl}\x1b[0m`);
-                }
-                // Show shareable onboarding guide as a plain copyable block
-                if (isTTY) {
+                // Build share block
+                {
                     const detailSlug = result.slug.startsWith('@') ? result.slug.slice(1) : result.slug;
                     const accessCode = result.access_code;
-                    // Primary: npx 설치 명령어 한 줄
+                    const gitUrl = result.git_url;
+                    // CLI install command
                     const visibility = config.visibility ?? 'public';
                     let installCmd;
                     if (visibility === 'internal' && accessCode) {
@@ -817,12 +817,46 @@ function registerPublish(program) {
                     else {
                         installCmd = `npx relayax-cli install ${result.slug}`;
                     }
-                    console.log(`\n  \x1b[90m공유하세요:\x1b[0m`);
-                    console.log(`  ┌${'─'.repeat(installCmd.length + 2)}┐`);
-                    console.log(`  │ ${installCmd} │`);
-                    console.log(`  └${'─'.repeat(installCmd.length + 2)}┘`);
-                    // Secondary: 에이전트 소개 페이지
-                    console.log(`\n  \x1b[90m에이전트 소개: \x1b[36mhttps://relayax.com/@${detailSlug}\x1b[0m`);
+                    // Plugin install commands (marketplace add + plugin install)
+                    const pluginSlug = detailSlug.includes('/') ? detailSlug.split('/')[1] : detailSlug;
+                    const pluginUrl = gitUrl ? `${config_js_1.API_URL}/api/registry/${detailSlug}/plugin` : null;
+                    // ── CLI 설치 (복사용) ──
+                    console.log(`\n  \x1b[1m▸ CLI 설치\x1b[0m`);
+                    console.log(`  ┌─`);
+                    console.log(`  │ ${installCmd}`);
+                    console.log(`  └─`);
+                    // ── Claude Code Plugin 설치 (복사용) ──
+                    if (pluginUrl) {
+                        console.log(`\n  \x1b[1m▸ Claude Code Plugin 설치\x1b[0m`);
+                        console.log(`  ┌─`);
+                        console.log(`  │ /plugin marketplace add ${pluginUrl}`);
+                        console.log(`  │ /plugin install ${pluginSlug}`);
+                        console.log(`  └─`);
+                    }
+                    // ── 소개 페이지 ──
+                    console.log(`\n  \x1b[90m소개 페이지:\x1b[0m https://relayax.com/@${detailSlug}`);
+                    // ── 공유 텍스트 (코드블록, 그대로 복붙) ──
+                    if (isTTY) {
+                        const shareBlock = [
+                            `[${config.name}] 설치하기`,
+                            ``,
+                            `# CLI`,
+                            installCmd,
+                        ];
+                        if (pluginUrl) {
+                            shareBlock.push(``, `# Claude Code Plugin`, `/plugin marketplace add ${pluginUrl}`, `/plugin install ${pluginSlug}`);
+                        }
+                        shareBlock.push(``, `소개: https://relayax.com/@${detailSlug}`);
+                        const maxLen = Math.max(...shareBlock.map((l) => l.length));
+                        const border = '─'.repeat(maxLen + 2);
+                        console.log(`\n  \x1b[90m┌${border}┐\x1b[0m`);
+                        for (const line of shareBlock) {
+                            const pad = ' '.repeat(maxLen - line.length);
+                            console.log(`  \x1b[90m│\x1b[0m ${line}${pad} \x1b[90m│\x1b[0m`);
+                        }
+                        console.log(`  \x1b[90m└${border}┘\x1b[0m`);
+                        console.log(`  \x1b[90m↑ 팀에 공유하세요\x1b[0m`);
+                    }
                 }
             }
         }

package/dist/prompts/create.md

@@ -3,6 +3,27 @@ relay.yaml이 없으면 새로 만들고, 있으면 변경사항을 반영합니
 
 > 빌더는 터미널 환경에서 작업합니다. CLI 명령어를 직접 실행하세요.
 
+## 핵심 원칙: 의사결정 포인트에서 사용자 질문
+
+각 단계에서 **선택지가 2개 이상**이면 반드시 사용자에게 질문하고 답변을 기다리세요.
+(AskUserQuestion 등 사용자 입력을 받는 도구를 사용하세요.)
+선택지가 1개뿐이거나 자동 판단이 가능하면 결과를 보여주고 바로 진행합니다.
+
+### 사용자 입력이 필요한 경우 (멈추고 질문하고 답변을 기다림)
+- 소스가 2개 이상 감지됨 → "어떤 콘텐츠를 포함할까요?"
+- Org가 1개 이상 있음 → "개인 배포 vs Org 배포?"
+- visibility 옵션이 2개 이상 → "공개 범위를 선택해주세요"
+- 포지셔닝 확인 → 분석 결과를 보여주고 "이대로 진행할까요?"
+- 배포 최종 확인 → relay.yaml 요약을 보여주고 "배포할까요?"
+
+**질문 후 반드시 사용자의 답변을 받을 때까지 다음 단계로 넘어가지 마세요.**
+텍스트로 질문을 출력한 뒤 혼자 답변하고 진행하면 안 됩니다.
+
+### 자동 진행하는 경우 (질문 불필요)
+- 소스가 1개뿐 → 해당 소스 자동 선택, 결과만 보여줌
+- 이미 relay.yaml이 있고 변경사항이 명확함 → 요약 후 진행
+- 로그인이 필요 → 자동으로 `relay login` 실행
+
 ## 분기: 최초 생성 vs 업데이트
 
 `.relay/relay.yaml`이 있는지 확인합니다.
@@ -17,7 +38,9 @@ relay.yaml이 없으면 새로 만들고, 있으면 변경사항을 반영합니
 ### 1. 콘텐츠 파악
 
 `relay package --init --json`으로 소스를 스캔합니다.
-결과의 `sources[]`에서 사용자에게 어떤 콘텐츠를 포함할지 물어봅니다.
+
+- **소스가 2개 이상** → `sources[]`를 정리하여 보여주고, **사용자에게 질문하여 어떤 콘텐츠를 포함할지 물어봅니다.** 사용자가 답변할 때까지 다음 단계로 넘어가지 마세요.
+- **소스가 1개** → 해당 소스를 자동 선택하고 결과를 보여준 뒤 바로 진행합니다.
 
 선택된 콘텐츠의 파일을 직접 읽어 기능을 파악합니다:
 - SKILL.md, 에이전트 파일, 커맨드 파일의 내용
@@ -35,6 +58,9 @@ relay.yaml이 없으면 새로 만들고, 있으면 변경사항을 반영합니
 이름(name)은 한국어 가능. slug는 영문 소문자+하이픈.
 설명은 설치자 관점으로 ("~를 자동화합니다").
 
+포지셔닝 결과를 표로 정리하여 보여주고, **사용자에게 질문하여 확인받으세요.**
+("이 포지셔닝으로 진행할까요? 수정할 부분이 있으면 알려주세요.")
+
 ### 3. requires 판단 + 보안 점검
 
 콘텐츠 파일을 읽고 requires를 판단합니다:
@@ -53,22 +79,30 @@ relay.yaml이 없으면 새로 만들고, 있으면 변경사항을 반영합니
 - 파일 컨텍스트를 읽어 실제 시크릿 vs 예시 코드를 구분
 - 발견 시 **반드시 경고**하고 환경변수 대체 안내
 
-### 4. relay.yaml 작성 & 배포
+### 4. 배포 설정
 
-판단 결과를 relay.yaml에 반영합니다:
+`relay orgs list --json`으로 Org 목록을 조회합니다.
+
+**항상 사용자에게 질문합니다** (AskUserQuestion 등 사용자 입력 도구 사용):
+- **Org가 1개 이상** → "개인 배포 / {org이름}에 배포" 선택
+- **Org가 없음** → "개인 배포 / 새 Organization 만들기" 선택
+  - "새 Organization 만들기" 선택 시 → `relay orgs create "이름"` 실행 후 해당 Org에 배포
+
+선택에 따라 **사용자에게 질문하여 visibility를 물어봅니다:**
+- **Org 없이 배포**: `public`, `private` (2개)
+- **Org에 배포**: `public`, `private`, `internal` (3개)
+- `public` — 누구나 설치
+- `private` — 접근 링크가 있는 사람만 설치
+- `internal` — Org 멤버만 설치 (Org 배포 시에만 선택 가능)
+
+### 5. relay.yaml 작성 & 배포
+
+위 결과를 relay.yaml에 반영합니다:
 - name, slug, description, version, tags
 - requires (판단 결과)
-- org: `relay orgs list --json`으로 Org 목록을 조회합니다.
-  - Org가 있으면: 개인 배포 vs Org 배포를 사용자에게 물어봅니다.
-  - Org가 없으면: 개인 배포로 진행합니다.
-- visibility: Org 선택 결과에 따라 옵션이 달라집니다:
-  - **Org 없이 배포**: `public`, `private` (2개)
-  - **Org에 배포**: `public`, `private`, `internal` (3개)
-  - `public` — 누구나 설치
-  - `private` — 접근 링크가 있는 사람만 설치
-  - `internal` — Org 멤버만 설치 (Org 배포 시에만 선택 가능)
+- org, visibility
 
-`relay publish --json`으로 배포합니다.
+**사용자에게 질문하여 최종 확인** 후 `relay publish --json`으로 배포합니다.
 
 ---
 
@@ -80,7 +114,7 @@ relay.yaml이 없으면 새로 만들고, 있으면 변경사항을 반영합니
 - 변경된 콘텐츠 (modified)
 - 새로 추가된 콘텐츠 (new_items)
 
-사용자에게 어떤 부분을 변경하려는지 물어봅니다:
+**사용자에게 질문하여 어떤 부분을 변경하려는지 물어봅니다:**
 - 콘텐츠 변경 반영 (sync)
 - 새 스킬/커맨드 추가
 - 설명/태그 개선
@@ -96,13 +130,25 @@ relay.yaml이 없으면 새로 만들고, 있으면 변경사항을 반영합니
 
 ### 3. 배포
 
+변경 요약을 보여주고 **사용자에게 질문하여 최종 확인** 후 배포합니다.
 `relay publish --json`으로 배포합니다.
-버전 범프가 필요하면 사용자에게 patch/minor/major 중 확인합니다.
+버전 범프가 필요하면 사용자에게 질문하여 patch/minor/major 중 확인합니다.
 
 ---
 
-## 공유 문구
+## 배포 완료 후 공유 안내
+
+`relay publish --json` 출력 결과를 파싱하여 다음을 보여주세요:
 
-배포 완료 후 `relay publish` 출력에 포함된 공유 문구를 보여줍니다.
+1. **배포 결과 요약** — slug, 버전, 공개 범위, URL
+2. **설치 방법** — CLI 출력에 코드블록 형태로 이미 포함되어 있으므로, 그 내용을 사용자에게 안내합니다:
+   - CLI: `npx relayax-cli install {slug}`
+   - 출력에 `plugin_url`이 있으면 Claude Code Plugin:
+     ```
+     /plugin marketplace add {pluginUrl}
+     /plugin install {slug}
+     ```
+   - 에이전트 소개 페이지 URL
+3. **공유 텍스트** — CLI 출력의 공유 블록(┌─ ... ─┘)을 그대로 안내합니다. 팀에 바로 복붙할 수 있는 코드블록 형태입니다.
 
 {{ERROR_HANDLING_GUIDE}}

package/package.json

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