relayax-cli 0.2.39 → 0.2.41

package/dist/commands/package.js

@@ -0,0 +1,287 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPackage = registerPackage;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const crypto_1 = __importDefault(require("crypto"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
+const ai_tools_js_1 = require("../lib/ai-tools.js");
+const SYNC_DIRS = ['skills', 'commands', 'agents', 'rules'];
+const EXCLUDE_SUBDIRS = ['relay']; // relay CLI 전용 하위 디렉토리 제외
+// ─── Helpers ───
+function fileHash(filePath) {
+    const content = fs_1.default.readFileSync(filePath);
+    return crypto_1.default.createHash('md5').update(content).digest('hex');
+}
+/**
+ * 디렉토리를 재귀 탐색하여 파일 목록을 반환한다.
+ * baseDir 기준 상대 경로 + 해시.
+ */
+function scanDir(baseDir, subDir) {
+    const fullDir = path_1.default.join(baseDir, subDir);
+    if (!fs_1.default.existsSync(fullDir))
+        return [];
+    const entries = [];
+    function walk(dir) {
+        for (const entry of fs_1.default.readdirSync(dir, { withFileTypes: true })) {
+            if (entry.name.startsWith('.'))
+                continue;
+            const fullPath = path_1.default.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                walk(fullPath);
+            }
+            else {
+                const relPath = path_1.default.relative(baseDir, fullPath);
+                entries.push({ relPath, hash: fileHash(fullPath) });
+            }
+        }
+    }
+    walk(fullDir);
+    return entries;
+}
+/**
+ * 소스 디렉토리(예: .claude/)에서 배포 가능한 콘텐츠를 스캔한다.
+ * relay/ 하위 디렉토리는 제외.
+ */
+function scanSource(projectPath, tool) {
+    const sourceBase = path_1.default.join(projectPath, tool.skillsDir);
+    const files = [];
+    const summary = {};
+    for (const dir of SYNC_DIRS) {
+        const fullDir = path_1.default.join(sourceBase, dir);
+        if (!fs_1.default.existsSync(fullDir))
+            continue;
+        // 제외 대상 필터링 (예: commands/relay/)
+        const dirEntries = fs_1.default.readdirSync(fullDir, { withFileTypes: true });
+        let count = 0;
+        for (const entry of dirEntries) {
+            if (entry.name.startsWith('.'))
+                continue;
+            if (entry.isDirectory() && EXCLUDE_SUBDIRS.includes(entry.name))
+                continue;
+            const entryPath = path_1.default.join(fullDir, entry.name);
+            if (entry.isDirectory()) {
+                // 하위 파일 재귀 탐색
+                const subFiles = scanDir(sourceBase, path_1.default.join(dir, entry.name));
+                // relPath를 sourceBase 기준 → SYNC_DIRS 기준으로 유지
+                files.push(...subFiles);
+                count += subFiles.length > 0 ? 1 : 0; // 디렉토리 단위로 카운트
+            }
+            else {
+                const relPath = path_1.default.relative(sourceBase, entryPath);
+                files.push({ relPath, hash: fileHash(entryPath) });
+                count++;
+            }
+        }
+        if (count > 0)
+            summary[dir] = count;
+    }
+    return { tool, files, summary };
+}
+/**
+ * .relay/ 디렉토리의 현재 콘텐츠를 스캔한다.
+ */
+function scanRelay(relayDir) {
+    const files = [];
+    for (const dir of SYNC_DIRS) {
+        files.push(...scanDir(relayDir, dir));
+    }
+    return files;
+}
+/**
+ * 소스와 .relay/를 비교하여 diff를 생성한다.
+ */
+function computeDiff(sourceFiles, relayFiles) {
+    const relayMap = new Map(relayFiles.map((f) => [f.relPath, f.hash]));
+    const sourceMap = new Map(sourceFiles.map((f) => [f.relPath, f.hash]));
+    const diff = [];
+    // 소스에 있는 파일
+    for (const [relPath, hash] of sourceMap) {
+        const relayHash = relayMap.get(relPath);
+        if (!relayHash) {
+            diff.push({ relPath, status: 'added' });
+        }
+        else if (relayHash !== hash) {
+            diff.push({ relPath, status: 'modified' });
+        }
+        else {
+            diff.push({ relPath, status: 'unchanged' });
+        }
+    }
+    // .relay/에만 있는 파일 (소스에서 삭제됨)
+    for (const [relPath] of relayMap) {
+        if (!sourceMap.has(relPath)) {
+            diff.push({ relPath, status: 'deleted' });
+        }
+    }
+    return diff.sort((a, b) => a.relPath.localeCompare(b.relPath));
+}
+/**
+ * 소스에서 .relay/로 파일을 동기화한다.
+ */
+function syncToRelay(sourceBase, relayDir, diff) {
+    for (const entry of diff) {
+        const sourcePath = path_1.default.join(sourceBase, entry.relPath);
+        const relayPath = path_1.default.join(relayDir, entry.relPath);
+        if (entry.status === 'added' || entry.status === 'modified') {
+            fs_1.default.mkdirSync(path_1.default.dirname(relayPath), { recursive: true });
+            fs_1.default.copyFileSync(sourcePath, relayPath);
+        }
+        else if (entry.status === 'deleted') {
+            if (fs_1.default.existsSync(relayPath)) {
+                fs_1.default.unlinkSync(relayPath);
+                // 빈 디렉토리 정리
+                const parentDir = path_1.default.dirname(relayPath);
+                try {
+                    const remaining = fs_1.default.readdirSync(parentDir).filter((f) => !f.startsWith('.'));
+                    if (remaining.length === 0)
+                        fs_1.default.rmdirSync(parentDir);
+                }
+                catch { /* ignore */ }
+            }
+        }
+    }
+}
+// ─── Command ───
+function registerPackage(program) {
+    program
+        .command('package')
+        .description('소스 디렉토리에서 .relay/로 콘텐츠를 동기화합니다')
+        .option('--source <dir>', '소스 디렉토리 지정 (예: .claude)')
+        .option('--sync', '변경사항을 .relay/에 즉시 반영', false)
+        .option('--init', '최초 패키징: 소스 감지 → .relay/ 초기화', false)
+        .action(async (opts) => {
+        const json = program.opts().json ?? false;
+        const projectPath = process.cwd();
+        const relayDir = path_1.default.join(projectPath, '.relay');
+        const relayYamlPath = path_1.default.join(relayDir, 'relay.yaml');
+        // ─── 최초 패키징 (--init) ───
+        if (opts.init || !fs_1.default.existsSync(relayYamlPath)) {
+            const detected = (0, ai_tools_js_1.detectAgentCLIs)(projectPath);
+            // 각 도구의 콘텐츠 스캔
+            const scans = detected
+                .map((tool) => scanSource(projectPath, tool))
+                .filter((s) => s.files.length > 0);
+            if (json) {
+                console.log(JSON.stringify({
+                    status: 'init_required',
+                    detected: scans.map((s) => ({
+                        source: s.tool.skillsDir,
+                        name: s.tool.name,
+                        summary: s.summary,
+                        fileCount: s.files.length,
+                    })),
+                }));
+            }
+            else {
+                if (scans.length === 0) {
+                    console.error('배포 가능한 에이전트 콘텐츠를 찾지 못했습니다.');
+                    console.error('skills/, commands/, agents/, rules/ 중 하나를 만들어주세요.');
+                    process.exit(1);
+                }
+                console.error('\n프로젝트에서 발견된 에이전트 콘텐츠:\n');
+                for (const scan of scans) {
+                    const parts = Object.entries(scan.summary)
+                        .map(([dir, count]) => `${dir} ${count}개`)
+                        .join(', ');
+                    console.error(`  📁 ${scan.tool.skillsDir}/ — ${parts}`);
+                }
+                console.error('');
+            }
+            return;
+        }
+        // ─── 재패키징 (source 기반 동기화) ───
+        const yamlContent = fs_1.default.readFileSync(relayYamlPath, 'utf-8');
+        const config = js_yaml_1.default.load(yamlContent);
+        const source = opts.source ?? config.source;
+        if (!source) {
+            if (json) {
+                console.log(JSON.stringify({
+                    status: 'no_source',
+                    message: 'relay.yaml에 source 필드가 없습니다. --source 옵션으로 지정하거나 relay.yaml에 source를 추가하세요.',
+                }));
+            }
+            else {
+                console.error('relay.yaml에 source 필드가 없습니다.');
+                console.error('--source <dir> 옵션으로 지정하거나 relay.yaml에 source를 추가하세요.');
+            }
+            process.exit(1);
+        }
+        // 소스 디렉토리 존재 확인
+        const sourceBase = path_1.default.join(projectPath, source);
+        if (!fs_1.default.existsSync(sourceBase)) {
+            const msg = `소스 디렉토리 '${source}'를 찾을 수 없습니다.`;
+            if (json) {
+                console.log(JSON.stringify({ error: 'SOURCE_NOT_FOUND', message: msg }));
+            }
+            else {
+                console.error(msg);
+            }
+            process.exit(1);
+        }
+        // 소스에서 해당 도구 찾기
+        const allTools = (0, ai_tools_js_1.detectAgentCLIs)(projectPath);
+        const tool = allTools.find((t) => t.skillsDir === source);
+        const toolName = tool?.name ?? source;
+        // diff 계산
+        const sourceScan = tool
+            ? scanSource(projectPath, tool)
+            : { tool: { name: source, value: source, skillsDir: source }, files: [], summary: {} };
+        // tool이 없으면 직접 스캔
+        if (!tool) {
+            for (const dir of SYNC_DIRS) {
+                const files = scanDir(sourceBase, dir);
+                sourceScan.files.push(...files);
+                if (files.length > 0)
+                    sourceScan.summary[dir] = files.length;
+            }
+        }
+        const relayFiles = scanRelay(relayDir);
+        const diff = computeDiff(sourceScan.files, relayFiles);
+        const summary = {
+            added: diff.filter((d) => d.status === 'added').length,
+            modified: diff.filter((d) => d.status === 'modified').length,
+            deleted: diff.filter((d) => d.status === 'deleted').length,
+            unchanged: diff.filter((d) => d.status === 'unchanged').length,
+        };
+        const hasChanges = summary.added + summary.modified + summary.deleted > 0;
+        // --sync: 즉시 동기화
+        if (opts.sync && hasChanges) {
+            syncToRelay(sourceBase, relayDir, diff);
+        }
+        const result = {
+            source,
+            sourceName: toolName,
+            synced: opts.sync === true && hasChanges,
+            diff: diff.filter((d) => d.status !== 'unchanged'),
+            summary,
+        };
+        if (json) {
+            console.log(JSON.stringify(result));
+        }
+        else {
+            if (!hasChanges) {
+                console.error(`✓ 소스(${source})와 .relay/가 동기화 상태입니다.`);
+                return;
+            }
+            console.error(`\n📦 소스 동기화 (${source}/ → .relay/)\n`);
+            for (const entry of diff) {
+                if (entry.status === 'unchanged')
+                    continue;
+                const icon = entry.status === 'added' ? '  신규' : entry.status === 'modified' ? '  변경' : '  삭제';
+                console.error(`${icon}: ${entry.relPath}`);
+            }
+            console.error('');
+            console.error(`  합계: 신규 ${summary.added}, 변경 ${summary.modified}, 삭제 ${summary.deleted}, 유지 ${summary.unchanged}`);
+            if (opts.sync) {
+                console.error(`\n✓ .relay/에 반영 완료`);
+            }
+            else {
+                console.error(`\n반영하려면: relay package --sync`);
+            }
+        }
+    });
+}

package/dist/commands/publish.js

@@ -24,8 +24,9 @@ function parseRelayYaml(content) {
     const requires = raw.requires;
     const rawVisibility = String(raw.visibility ?? '');
     const visibility = rawVisibility === 'private' ? 'private'
-        : rawVisibility === 'public' ? 'public'
-            : undefined;
+        : rawVisibility === 'gated' ? 'gated'
+            : rawVisibility === 'public' ? 'public'
+                : undefined;
     const rawType = String(raw.type ?? '');
     const type = rawType === 'command' ? 'command'
         : rawType === 'passive' ? 'passive'
@@ -42,6 +43,7 @@ function parseRelayYaml(content) {
         requires,
         visibility,
         type,
+        source: raw.source ? String(raw.source) : undefined,
     };
 }
 function detectCommands(teamDir) {
@@ -244,7 +246,7 @@ async function createTarball(teamDir) {
     const dirsToInclude = VALID_DIRS.filter((d) => fs_1.default.existsSync(path_1.default.join(teamDir, d)));
     // Include root-level files if they exist
     const entries = [...dirsToInclude];
-    const rootFiles = ['relay.yaml', 'SKILL.md'];
+    const rootFiles = ['relay.yaml', 'SKILL.md', 'guide.md'];
     for (const file of rootFiles) {
         if (fs_1.default.existsSync(path_1.default.join(teamDir, file))) {
             entries.push(file);
@@ -281,6 +283,8 @@ function registerPublish(program) {
         .command('publish')
         .description('현재 팀 패키지를 Space에 배포합니다 (relay.yaml 필요)')
         .option('--token <token>', '인증 토큰')
+        .option('--space <slug>', '배포할 Space 지정')
+        .option('--version <version>', '배포 버전 지정 (relay.yaml 업데이트)')
         .action(async (opts) => {
         const json = program.opts().json ?? false;
         const teamDir = process.cwd();
@@ -317,6 +321,7 @@ function registerPublish(program) {
                 console.error(JSON.stringify({
                     error: 'NOT_INITIALIZED',
                     message: '.relay/relay.yaml이 없습니다. 먼저 `relay create`를 실행하세요.',
+                    fix: 'relay create 또는 .relay/relay.yaml을 생성하세요.',
                 }));
                 process.exit(1);
             }
@@ -345,12 +350,16 @@ function registerPublish(program) {
             const visibility = await promptSelect({
                 message: '공개 범위:',
                 choices: [
-                    { name: '공개', value: 'public' },
-                    { name: '비공개 (Space 멤버만)', value: 'private' },
+                    { name: '공개 — 누구나 설치', value: 'public' },
+                    { name: '링크 공유 — 접근 링크가 있는 사람만 설치', value: 'gated' },
+                    { name: '비공개 — Space 멤버만', value: 'private' },
                 ],
             });
             console.error('\n\x1b[2m💡 프로필에 연락처를 설정하면 설치 시 명함이 전달됩니다: www.relayax.com/dashboard/profile\x1b[0m');
-            if (visibility === 'private') {
+            if (visibility === 'gated') {
+                console.error('\x1b[2m💡 링크 공유 팀은 웹 대시보드에서 접근 링크와 구매 안내를 설정하세요: www.relayax.com/dashboard\x1b[0m');
+            }
+            else if (visibility === 'private') {
                 console.error('\x1b[2m💡 비공개 팀은 Space를 통해 멤버를 관리하세요: www.relayax.com/dashboard/teams\x1b[0m');
             }
             console.error('');
@@ -377,11 +386,18 @@ function registerPublish(program) {
             console.error(JSON.stringify({
                 error: 'INVALID_CONFIG',
                 message: 'relay.yaml에 name, slug, description이 필요합니다.',
+                fix: 'relay.yaml에 name, slug, description을 확인하세요.',
             }));
             process.exit(1);
         }
-        // Version bump suggestion for republishing
-        if (isTTY) {
+        // Version bump: --version flag takes priority
+        if (opts.version) {
+            config.version = opts.version;
+            const yamlData = js_yaml_1.default.load(fs_1.default.readFileSync(relayYamlPath, 'utf-8'));
+            yamlData.version = opts.version;
+            fs_1.default.writeFileSync(relayYamlPath, js_yaml_1.default.dump(yamlData, { lineWidth: 120 }), 'utf-8');
+        }
+        else if (isTTY) {
             const { select: promptVersion } = await import('@inquirer/prompts');
             const [major, minor, patch] = config.version.split('.').map(Number);
             const bumpPatch = `${major}.${minor}.${patch + 1}`;
@@ -415,6 +431,7 @@ function registerPublish(program) {
             console.error(JSON.stringify({
                 error: 'EMPTY_PACKAGE',
                 message: '.relay/ 안에 skills/, agents/, rules/, commands/ 중 하나 이상에 파일이 있어야 합니다.',
+                fix: '.relay/ 안에 skills/, agents/, rules/, commands/ 중 하나에 파일을 추가하세요.',
             }));
             process.exit(1);
         }
@@ -424,71 +441,110 @@ function registerPublish(program) {
             console.error(JSON.stringify({
                 error: 'NO_TOKEN',
                 message: '인증이 필요합니다. `relay login`을 먼저 실행하세요.',
+                fix: 'relay login 실행 후 재시도하세요.',
             }));
             process.exit(1);
         }
         // Fetch user's Spaces and select publish target
         let selectedSpaceId;
-        let selectedSpaceIsPersonal = true;
+        let selectedSpaceSlug;
+        let selectedJoinPolicy;
         try {
             const { fetchMySpaces } = await import('./spaces.js');
             const spaces = await fetchMySpaces(token);
-            const personalSpace = spaces.find((s) => s.is_personal);
-            const teamSpaces = spaces.filter((s) => !s.is_personal);
-            if (isTTY) {
+            // --space flag: resolve Space by slug
+            if (opts.space) {
+                const matched = spaces.find((s) => s.slug === opts.space);
+                if (matched) {
+                    selectedSpaceId = matched.id;
+                    selectedSpaceSlug = matched.slug;
+                    selectedJoinPolicy = matched.join_policy;
+                }
+                else {
+                    if (json) {
+                        console.error(JSON.stringify({
+                            error: 'INVALID_SPACE',
+                            message: `Space '${opts.space}'를 찾을 수 없습니다.`,
+                            fix: `사용 가능한 Space: ${spaces.map((s) => s.slug).join(', ')}`,
+                            options: spaces.map((s) => ({ value: s.slug, label: `${s.name} (${s.slug})` })),
+                        }));
+                    }
+                    else {
+                        console.error(`Space '${opts.space}'를 찾을 수 없습니다.`);
+                    }
+                    process.exit(1);
+                }
+            }
+            else if (isTTY) {
                 if (spaces.length === 0) {
                     // No spaces at all — publish without space_id
                     console.error('\x1b[33m⚠ 소속 Space가 없습니다. 개인 계정으로 배포합니다.\x1b[0m\n');
                 }
-                else if (spaces.length === 1 && personalSpace) {
-                    // Only personal Space — auto-select
-                    selectedSpaceId = personalSpace.id;
-                    selectedSpaceIsPersonal = true;
-                    console.error(`\x1b[2m  Space: 개인 스페이스 (${personalSpace.slug})\x1b[0m\n`);
+                else if (spaces.length === 1) {
+                    // Only one Space — auto-select regardless of type
+                    selectedSpaceId = spaces[0].id;
+                    selectedSpaceSlug = spaces[0].slug;
+                    selectedJoinPolicy = spaces[0].join_policy;
+                    console.error(`\x1b[2m  Space: ${spaces[0].name} (${spaces[0].slug})\x1b[0m\n`);
                 }
                 else {
                     // Multiple spaces — prompt user
                     const { select: selectSpace } = await import('@inquirer/prompts');
-                    const spaceChoices = [
-                        ...(personalSpace ? [{ name: `개인 스페이스 (${personalSpace.slug})`, value: personalSpace.id, isPersonal: true }] : []),
-                        ...teamSpaces.map((s) => ({ name: `${s.name} (${s.slug})`, value: s.id, isPersonal: false })),
-                    ];
+                    const spaceChoices = spaces.map((s) => ({
+                        name: `${s.name} (${s.slug})`,
+                        value: s.id,
+                        slug: s.slug,
+                        join_policy: s.join_policy,
+                    }));
                     const chosenId = await selectSpace({
                         message: '어떤 Space에 배포할까요?',
                         choices: spaceChoices.map((c) => ({ name: c.name, value: c.value })),
                     });
                     const chosen = spaceChoices.find((c) => c.value === chosenId);
                     selectedSpaceId = chosenId;
-                    selectedSpaceIsPersonal = chosen?.isPersonal ?? false;
+                    selectedSpaceSlug = chosen?.slug;
+                    selectedJoinPolicy = chosen?.join_policy;
                     const chosenLabel = chosen?.name ?? chosenId;
                     console.error(`  → Space: ${chosenLabel}\n`);
                 }
             }
-            else if (personalSpace) {
-                selectedSpaceId = personalSpace.id;
-                selectedSpaceIsPersonal = true;
+            else if (spaces.length > 1 && json) {
+                // --json 모드 + 여러 Space: 에이전트가 선택할 수 있도록 에러 반환
+                console.error(JSON.stringify({
+                    error: 'MISSING_SPACE',
+                    message: '배포할 Space를 선택하세요.',
+                    fix: `relay publish --space <slug> --json`,
+                    options: spaces.map((s) => ({ value: s.slug, label: `${s.name} (${s.slug})` })),
+                }));
+                process.exit(1);
+            }
+            else if (spaces.length > 0) {
+                selectedSpaceId = spaces[0].id;
+                selectedSpaceSlug = spaces[0].slug;
+                selectedJoinPolicy = spaces[0].join_policy;
             }
         }
         catch {
             // Space 조회 실패 시 무시하고 계속 진행
         }
-        // Visibility default based on Space type: personal → public, team Space → private
-        const defaultVisibility = selectedSpaceIsPersonal ? 'public' : 'private';
-        const defaultVisLabel = defaultVisibility === 'public'
-            ? '공개 (개인 Space 기본값)'
-            : '비공개 (팀 Space 기본값)';
+        // Visibility default based on join_policy: approval → private, otherwise → public
+        const defaultVisibility = selectedJoinPolicy === 'approval' ? 'private' : 'public';
         // Visibility validation: must be explicitly set
         if (!config.visibility) {
             if (isTTY) {
                 const { select: promptSelect } = await import('@inquirer/prompts');
-                console.error(`\n\x1b[33m⚠ relay.yaml에 visibility가 설정되지 않았습니다.\x1b[0m  (기본값: ${defaultVisLabel})`);
+                console.error(`\n\x1b[33m⚠ relay.yaml에 visibility가 설정되지 않았습니다.\x1b[0m  (기본값: ${defaultVisibility === 'public' ? '공개' : '비공개'})`);
                 config.visibility = await promptSelect({
                     message: '공개 범위를 선택하세요:',
                     choices: [
                         {
-                            name: `공개 — Space에 누구나 검색·설치${defaultVisibility === 'public' ? '  ✓ 추천' : ''}`,
+                            name: `공개 — 누구나 설치${defaultVisibility === 'public' ? '  ✓ 추천' : ''}`,
                             value: 'public',
                         },
+                        {
+                            name: '링크 공유 — 접근 링크가 있는 사람만 설치',
+                            value: 'gated',
+                        },
                         {
                             name: `비공개 — Space 멤버만 접근${defaultVisibility === 'private' ? '  ✓ 추천' : ''}`,
                             value: 'private',
@@ -505,7 +561,13 @@ function registerPublish(program) {
             else {
                 console.error(JSON.stringify({
                     error: 'MISSING_VISIBILITY',
-                    message: 'relay.yaml에 visibility (public 또는 private)를 설정해주세요.',
+                    message: 'relay.yaml에 visibility를 설정해주세요.',
+                    options: [
+                        { value: 'public', label: '공개 — 누구나 설치' },
+                        { value: 'gated', label: '링크 공유 — 접근 링크가 있는 사람만 설치' },
+                        { value: 'private', label: '비공개 — Space 멤버만 접근' },
+                    ],
+                    fix: 'relay.yaml의 visibility 필드를 위 옵션 중 하나로 설정하세요.',
                 }));
                 process.exit(1);
             }
@@ -513,23 +575,36 @@ function registerPublish(program) {
         // Confirm visibility before publish (재배포 시 변경 기회 제공)
         if (isTTY) {
             const { select: promptConfirmVis } = await import('@inquirer/prompts');
-            const visLabel = config.visibility === 'public'
-                ? `\x1b[32m공개\x1b[0m (Space에 누구나 검색·설치)${defaultVisibility === 'public' ? '  ✓ 추천' : ''}`
-                : `\x1b[33m비공개\x1b[0m (Space 멤버만 접근)${defaultVisibility === 'private' ? '  ✓ 추천' : ''}`;
-            const visAction = await promptConfirmVis({
-                message: `공개 범위: ${config.visibility === 'public' ? '공개' : '비공개'} — 유지할까요?`,
+            const visLabelMap = {
+                public: '공개',
+                gated: '링크공유',
+                private: '비공개',
+            };
+            const currentVisLabel = visLabelMap[config.visibility ?? 'public'] ?? config.visibility;
+            const newVisibility = await promptConfirmVis({
+                message: `공개 범위: ${currentVisLabel} — 유지하거나 변경하세요`,
                 choices: [
-                    { name: `유지 — ${visLabel}`, value: 'keep' },
-                    { name: '변경', value: 'change' },
+                    {
+                        name: `공개 — 누구나 설치${defaultVisibility === 'public' ? '  ✓ 추천' : ''}`,
+                        value: 'public',
+                    },
+                    {
+                        name: '링크공유 — 접근 링크가 있는 사람만 설치',
+                        value: 'gated',
+                    },
+                    {
+                        name: `비공개 — Space 멤버만 접근${defaultVisibility === 'private' ? '  ✓ 추천' : ''}`,
+                        value: 'private',
+                    },
                 ],
+                default: config.visibility ?? defaultVisibility,
             });
-            if (visAction === 'change') {
-                config.visibility = config.visibility === 'public' ? 'private' : 'public';
+            if (newVisibility !== config.visibility) {
+                config.visibility = newVisibility;
                 const yamlData = js_yaml_1.default.load(fs_1.default.readFileSync(relayYamlPath, 'utf-8'));
                 yamlData.visibility = config.visibility;
                 fs_1.default.writeFileSync(relayYamlPath, js_yaml_1.default.dump(yamlData, { lineWidth: 120 }), 'utf-8');
-                const newLabel = config.visibility === 'public' ? '공개' : '비공개';
-                console.error(`  → relay.yaml에 visibility: ${config.visibility} 저장됨 (${newLabel})\n`);
+                console.error(`  → relay.yaml에 visibility: ${config.visibility} 저장됨 (${visLabelMap[config.visibility]})\n`);
             }
         }
         // Profile hint
@@ -564,6 +639,7 @@ function registerPublish(program) {
             agent_details: detectedAgents,
             skill_details: detectedSkills,
             ...(selectedSpaceId ? { space_id: selectedSpaceId } : {}),
+            ...(selectedSpaceSlug ? { space_slug: selectedSpaceSlug } : {}),
         };
         if (!json) {
             console.error(`패키지 생성 중... (${config.name} v${config.version})`);
@@ -573,6 +649,10 @@ function registerPublish(program) {
             console.error('\x1b[33m⚠ GUIDE.html은 더 이상 지원되지 않습니다. 상세페이지가 가이드 역할을 합니다.\x1b[0m');
             console.error('  long_description을 활용하거나 relayax.com에서 팀 정보를 편집하세요.\n');
         }
+        // Generate guide.md (consumer install guide)
+        const { generateGuide } = await import('../lib/guide.js');
+        const guideContent = generateGuide(config, detectedCommands, config.requires);
+        fs_1.default.writeFileSync(path_1.default.join(relayDir, 'guide.md'), guideContent);
         // Generate bin/relay-preamble.sh (self-contained tracking + update check)
         (0, preamble_js_1.generatePreambleBin)(relayDir, config.slug, config_js_1.API_URL);
         // Generate entry command (commands/{author}-{name}.md)
@@ -636,33 +716,28 @@ function registerPublish(program) {
                 }
                 // Show shareable onboarding guide as a plain copyable block
                 if (isTTY) {
-                    const guideLines = [
-                        'npm install -g relayax-cli',
-                        `/relay:relay-install ${result.slug}`,
-                    ];
-                    // Type-based usage hint
-                    const teamType = config.type ?? 'hybrid';
-                    if (teamType === 'passive') {
-                        guideLines.push('', '# 설치하면 자동 적용됩니다');
-                    }
-                    else if (detectedCommands.length > 0) {
-                        const usageCmd = teamType === 'hybrid'
-                            ? `# 자동 적용 + /${detectedCommands[0].name} 으로 추가 기능`
-                            : `# 사용법: /${detectedCommands[0].name}`;
-                        guideLines.push('', usageCmd);
-                    }
+                    const detailSlug = result.slug.startsWith('@') ? result.slug.slice(1) : result.slug;
+                    const guideUrl = `https://relayax.com/api/registry/${detailSlug}/guide.md`;
                     console.log(`\n  \x1b[90m주변인에게 공유하세요:\x1b[0m\n`);
                     console.log('```');
-                    guideLines.forEach((line) => console.log(line));
+                    console.log('아래 가이드를 읽고 그대로 따라해줘:');
+                    console.log(guideUrl);
                     console.log('```');
-                    const detailSlug = result.slug.startsWith('@') ? result.slug.slice(1) : result.slug;
+                    console.log(`\n  \x1b[90mCLI 설치된 사용자용 (짧은 버전):\x1b[0m`);
+                    console.log(`  /relay:relay-install ${result.slug}`);
+                    if (config.visibility !== 'private') {
+                        console.log(`\n  \x1b[90m유료 판매하려면:\x1b[0m`);
+                        console.log(`  1. 가시성을 "링크 공유"로 변경: \x1b[36mrelayax.com/dashboard\x1b[0m`);
+                        console.log(`  2. API 키 발급: \x1b[36mrelayax.com/dashboard/keys\x1b[0m`);
+                        console.log(`  3. 웹훅 연동 가이드: \x1b[36mrelayax.com/docs/webhook-guide.md\x1b[0m`);
+                    }
                     console.log(`\n  \x1b[90m상세페이지: \x1b[36mrelayax.com/@${detailSlug}\x1b[0m`);
                 }
             }
         }
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);
-            console.error(JSON.stringify({ error: 'PUBLISH_FAILED', message }));
+            console.error(JSON.stringify({ error: 'PUBLISH_FAILED', message, fix: message }));
             process.exit(1);
         }
         finally {

package/dist/commands/search.js

@@ -48,7 +48,7 @@ function registerSearch(program) {
         }
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);
-            console.error(JSON.stringify({ error: 'SEARCH_FAILED', message }));
+            console.error(JSON.stringify({ error: 'SEARCH_FAILED', message, fix: '검색어를 변경하거나 잠시 후 재시도하세요.' }));
             process.exit(1);
         }
     });

package/dist/commands/spaces.d.ts

@@ -4,7 +4,7 @@ export interface SpaceInfo {
     slug: string;
     name: string;
     description: string | null;
-    is_personal: boolean;
+    join_policy?: string;
     role: string;
 }
 export declare function fetchMySpaces(token: string): Promise<SpaceInfo[]>;