anpm-io 1.0.0

package/dist/commands/install.js

@@ -0,0 +1,626 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerInstall = registerInstall;
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const api_js_1 = require("../lib/api.js");
+const storage_js_1 = require("../lib/storage.js");
+const git_operations_js_1 = require("../lib/git-operations.js");
+const config_js_1 = require("../lib/config.js");
+const slug_js_1 = require("../lib/slug.js");
+const preamble_js_1 = require("../lib/preamble.js");
+const init_js_1 = require("./init.js");
+const paths_js_1 = require("../lib/paths.js");
+const error_report_js_1 = require("../lib/error-report.js");
+const step_tracker_js_1 = require("../lib/step-tracker.js");
+const installer_js_1 = require("../lib/installer.js");
+const ai_tools_js_1 = require("../lib/ai-tools.js");
+const install_source_js_1 = require("../lib/install-source.js");
+const local_installer_js_1 = require("../lib/local-installer.js");
+const git_installer_js_1 = require("../lib/git-installer.js");
+const auto_detect_js_1 = require("../lib/auto-detect.js");
+const manifest_js_1 = require("../lib/manifest.js");
+const lockfile_js_1 = require("../lib/lockfile.js");
+function registerInstall(program) {
+    program
+        .command('install [slug]')
+        .description('Install an agent package to .relay/agents/')
+        .option('--code <code>', 'Access code (for private/internal agents)')
+        .option('--global', 'Global install (home directory)')
+        .option('--local', 'Local install (project directory)')
+        .option('--project <dir>', 'Project root path (default: cwd, env: RELAY_PROJECT_PATH)')
+        .option('--path <subpath>', 'Subpath within a monorepo (for git installs)')
+        .option('--yes', 'Skip confirmation prompts')
+        .option('--save', 'Add agent to relay.yaml agents')
+        .option('--prune', 'Remove agents not in relay.yaml')
+        .action(async (slugInput, _opts) => {
+        const json = program.opts().json ?? false;
+        const projectPath = (0, paths_js_1.resolveProjectPath)(_opts.project);
+        // ── Manifest mode (no args) ──
+        if (!slugInput) {
+            const { manifest, filePath: manifestPath } = (0, manifest_js_1.loadManifest)(projectPath);
+            if (!manifest?.agents || Object.keys(manifest.agents).length === 0) {
+                if (json) {
+                    console.log(JSON.stringify({ error: 'NO_MANIFEST', message: 'No anpm.yaml with agents found.' }));
+                }
+                else {
+                    console.error('No anpm.yaml with agents found. Run `anpm install <slug>` to install an agent.');
+                }
+                process.exit(1);
+            }
+            const agents = manifest.agents;
+            const _lock = (0, lockfile_js_1.loadLockfile)(projectPath); // used in future for pinned versions
+            const localInstalled = (0, config_js_1.loadInstalled)();
+            let installed = 0;
+            let skipped = 0;
+            if (!json)
+                console.error(`\x1b[2mInstalling from ${manifestPath}...\x1b[0m`);
+            for (const [slug, range] of Object.entries(agents)) {
+                // Check if already installed with compatible version
+                const existing = localInstalled[slug];
+                if (existing && (0, manifest_js_1.satisfiesRange)(existing.version, range)) {
+                    skipped++;
+                    continue;
+                }
+                try {
+                    const source = (0, install_source_js_1.parseInstallSource)(slug);
+                    if (source.type === 'local') {
+                        (0, local_installer_js_1.installFromLocal)(source.absolutePath, { scope: 'local', projectPath });
+                    }
+                    else if (source.type === 'git') {
+                        (0, git_installer_js_1.installFromGit)(source, { scope: 'local', projectPath });
+                    }
+                    else {
+                        // Registry install — reuse the existing flow by recursing
+                        // For now, use a simplified approach: call the single-agent install logic
+                        if (!json)
+                            console.error(`  Installing ${slug}...`);
+                        // We'll let the user run `relay install <slug>` for registry agents
+                        // Full manifest registry install requires the same token/fetch flow
+                        if (!json)
+                            console.error(`  \x1b[33m⚠ Registry agent ${slug} — run: anpm install ${slug} --save\x1b[0m`);
+                        continue;
+                    }
+                    // Update lock
+                    (0, lockfile_js_1.updateLockEntry)(projectPath, slug, {
+                        version: existing?.version ?? '0.0.0',
+                        resolved: source.type === 'local' ? `local:${source.absolutePath}` : `git:${slug}`,
+                    });
+                    installed++;
+                    if (!json)
+                        console.error(`  \x1b[32m✓\x1b[0m ${slug}`);
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    if (!json)
+                        console.error(`  \x1b[31m✖\x1b[0m ${slug}: ${msg}`);
+                }
+            }
+            if (json) {
+                console.log(JSON.stringify({ status: 'ok', installed, skipped, total: Object.keys(agents).length }));
+            }
+            else {
+                console.log(`\n\x1b[32m✓\x1b[0m Manifest install complete: ${installed} installed, ${skipped} skipped`);
+            }
+            return;
+        }
+        (0, step_tracker_js_1.trackCommand)('install', { slug: slugInput });
+        // ── Source type branching ──
+        const source = (0, install_source_js_1.parseInstallSource)(slugInput);
+        if (source.type === 'local' || source.type === 'git') {
+            try {
+                const interactive = Boolean(process.stdin.isTTY) && !json;
+                const scope = _opts.global ? 'global' : 'local';
+                let agentDir;
+                let installSlug;
+                let sourceTag;
+                if (source.type === 'local') {
+                    if (!json)
+                        console.error(`\x1b[2mInstalling from local path: ${source.absolutePath}\x1b[0m`);
+                    const result = (0, local_installer_js_1.installFromLocal)(source.absolutePath, { scope, projectPath });
+                    // Confirm auto-detected structure if no relay.yaml
+                    if (result.detected.method !== 'relay-yaml' && interactive && !_opts.yes) {
+                        console.error(`\n  Detected structure (${result.detected.method}):`);
+                        console.error((0, auto_detect_js_1.formatDetectedStructure)(result.detected));
+                        const { confirm } = await import('@inquirer/prompts');
+                        const ok = await confirm({ message: 'Install these?', default: true });
+                        if (!ok) {
+                            process.exit(0);
+                        }
+                    }
+                    agentDir = result.agentDir;
+                    installSlug = `local/${result.name}`;
+                    sourceTag = `local:${source.absolutePath}`;
+                }
+                else {
+                    if (!json)
+                        console.error(`\x1b[2mInstalling from git: ${source.url}${source.ref ? `#${source.ref}` : ''}\x1b[0m`);
+                    const result = (0, git_installer_js_1.installFromGit)(source, { scope, projectPath, subpath: _opts.path });
+                    if (result.detected.method !== 'relay-yaml' && interactive && !_opts.yes) {
+                        console.error(`\n  Detected structure (${result.detected.method}):`);
+                        console.error((0, auto_detect_js_1.formatDetectedStructure)(result.detected));
+                        const { confirm } = await import('@inquirer/prompts');
+                        const ok = await confirm({ message: 'Install these?', default: true });
+                        if (!ok) {
+                            process.exit(0);
+                        }
+                    }
+                    agentDir = result.agentDir;
+                    installSlug = result.slug;
+                    sourceTag = `git:${source.host}:${source.user}/${source.repo}${source.ref ? `#${source.ref}` : ''}`;
+                }
+                // Deploy symlinks to detected harnesses
+                const deploy = await (0, installer_js_1.deploySymlinks)(agentDir, scope, projectPath);
+                for (const w of deploy.warnings) {
+                    if (!json)
+                        console.error(`\x1b[33m${w}\x1b[0m`);
+                }
+                // Record in installed.json
+                const installRecord = {
+                    version: '0.0.0',
+                    installed_at: new Date().toISOString(),
+                    files: [agentDir],
+                    deploy_scope: scope,
+                    deployed_symlinks: deploy.symlinks,
+                    source: sourceTag,
+                };
+                if (scope === 'global') {
+                    const globalInstalled = (0, config_js_1.loadGlobalInstalled)();
+                    globalInstalled[installSlug] = installRecord;
+                    (0, config_js_1.saveGlobalInstalled)(globalInstalled);
+                }
+                else {
+                    const installed = (0, config_js_1.loadInstalled)();
+                    installed[installSlug] = installRecord;
+                    (0, config_js_1.saveInstalled)(installed);
+                }
+                // Count files
+                function countFilesInDir(dir) {
+                    let count = 0;
+                    if (!fs_1.default.existsSync(dir))
+                        return 0;
+                    for (const entry of fs_1.default.readdirSync(dir, { withFileTypes: true })) {
+                        if (entry.isDirectory())
+                            count += countFilesInDir(path_1.default.join(dir, entry.name));
+                        else
+                            count++;
+                    }
+                    return count;
+                }
+                const fileCount = countFilesInDir(agentDir);
+                const scopeLabel = scope === 'global' ? 'global' : 'local';
+                if (json) {
+                    console.log(JSON.stringify({
+                        status: 'ok',
+                        slug: installSlug,
+                        source: sourceTag,
+                        files: fileCount,
+                        install_path: agentDir,
+                        scope,
+                        symlinks: deploy.symlinks,
+                    }));
+                }
+                else {
+                    console.log(`\n\x1b[32m✓ Installed ${installSlug}\x1b[0m`);
+                    console.log(`  path: \x1b[36m${agentDir}\x1b[0m`);
+                    console.log(`  scope: ${scopeLabel}`);
+                    console.log(`  files: ${fileCount}, symlinks: ${deploy.symlinks.length}`);
+                }
+                // --save: add to relay.yaml
+                if (_opts.save) {
+                    (0, manifest_js_1.addAgentToManifest)(projectPath, installSlug, '*');
+                    if (!json)
+                        console.log(`  \x1b[32m✓\x1b[0m Added to anpm.yaml`);
+                }
+                return;
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                (0, error_report_js_1.reportCliError)('install', 'INSTALL_FAILED', message);
+                if (json) {
+                    console.error(JSON.stringify({ error: 'INSTALL_FAILED', message }));
+                }
+                else {
+                    console.error(`\x1b[31m✖ ${message}\x1b[0m`);
+                }
+                process.exit(1);
+            }
+        }
+        // ── Registry install flow (existing) ──
+        const tempDir = (0, storage_js_1.makeTempDir)();
+        try {
+            // Resolve scoped slug and fetch agent metadata
+            let agent;
+            let slug;
+            let parsed;
+            // Extract version from @owner/agent@version syntax (e.g. acme/writer@1.2.0)
+            // Version-specific install is not yet supported by the registry API;
+            // the match is kept for future use when per-version package URLs are available.
+            const versionMatch = slugInput.match(/^(.+)@(\d+\.\d+\.\d+.*)$/);
+            const actualSlugInput = versionMatch ? versionMatch[1] : slugInput;
+            parsed = await (0, slug_js_1.resolveSlug)(actualSlugInput);
+            slug = parsed.full;
+            // Helper: ensure a valid token exists, triggering auto-login in TTY if needed.
+            // Returns the token string or null if login failed / not available.
+            async function ensureToken() {
+                let token = await (0, config_js_1.getValidToken)();
+                if (!token) {
+                    const isTTY = Boolean(process.stdin.isTTY);
+                    if (isTTY && !json) {
+                        console.error('\x1b[33m⚙ 이 에이전트는 로그인이 필요합니다. 로그인을 시작합니다...\x1b[0m');
+                        const { runLogin } = await import('./login.js');
+                        await runLogin();
+                        token = await (0, config_js_1.getValidToken)();
+                    }
+                }
+                return token ?? null;
+            }
+            // Pre-fetch auto-login: --code always requires auth.
+            if (_opts.code) {
+                const token = await ensureToken();
+                if (!token) {
+                    if (json) {
+                        console.error(JSON.stringify({
+                            error: 'LOGIN_REQUIRED',
+                            slug,
+                            message: '이 에이전트는 로그인이 필요합니다. anpm login을 먼저 실행하세요.',
+                            fix: 'anpm login 실행 후 재시도하세요.',
+                        }));
+                    }
+                    else {
+                        console.error('\x1b[31m이 에이전트는 로그인이 필요합니다. anpm login 을 먼저 실행하세요.\x1b[0m');
+                    }
+                    process.exit(1);
+                }
+            }
+            try {
+                agent = await (0, api_js_1.fetchAgentInfo)(slug);
+            }
+            catch (fetchErr) {
+                const fetchMsg = fetchErr instanceof Error ? fetchErr.message : String(fetchErr);
+                if (fetchMsg.includes('403')) {
+                    // Parse error body for membership_status, visibility, purchase_info
+                    let membershipStatus;
+                    let errorVisibility;
+                    let purchaseInfo;
+                    try {
+                        const errBody = JSON.parse(fetchMsg.replace(/^.*?(\{)/, '{'));
+                        membershipStatus = typeof errBody.membership_status === 'string' ? errBody.membership_status : undefined;
+                        errorVisibility = typeof errBody.visibility === 'string' ? errBody.visibility : undefined;
+                        if (errBody.purchase_info && typeof errBody.purchase_info === 'object') {
+                            purchaseInfo = errBody.purchase_info;
+                        }
+                    }
+                    catch { /* ignore parse errors */ }
+                    // --code provided → use unified access-codes API (handles both org join and agent grant)
+                    if (_opts.code) {
+                        if (!json) {
+                            console.error('\x1b[33m⚙ 접근 코드로 권한을 요청합니다...\x1b[0m');
+                        }
+                        const token = await (0, config_js_1.getValidToken)();
+                        if (!token) {
+                            if (json) {
+                                console.error(JSON.stringify({
+                                    error: 'LOGIN_REQUIRED',
+                                    slug,
+                                    message: '이 에이전트는 로그인이 필요합니다. anpm login을 먼저 실행하세요.',
+                                    fix: 'anpm login 실행 후 재시도하세요.',
+                                }));
+                            }
+                            else {
+                                console.error('\x1b[31m이 에이전트는 로그인이 필요합니다. anpm login 을 먼저 실행하세요.\x1b[0m');
+                            }
+                            process.exit(1);
+                        }
+                        const codeRes = await fetch(`${config_js_1.API_URL}/api/access-codes/${_opts.code}/use`, {
+                            method: 'POST',
+                            headers: {
+                                'Content-Type': 'application/json',
+                                Authorization: `Bearer ${token}`,
+                            },
+                            signal: AbortSignal.timeout(10000),
+                        });
+                        if (!codeRes.ok) {
+                            const codeBody = (await codeRes.json().catch(() => ({})));
+                            const codeErrCode = codeBody.error ?? String(codeRes.status);
+                            if (codeErrCode === 'INVALID_LINK')
+                                throw new Error('접근 코드가 유효하지 않거나 만료되었습니다.');
+                            throw new Error(codeBody.message ?? `접근 권한 요청 실패 (${codeRes.status})`);
+                        }
+                        agent = await (0, api_js_1.fetchAgentInfo)(slug);
+                    }
+                    // No code provided: show appropriate error messages
+                    else if (errorVisibility === 'private' || purchaseInfo) {
+                        // Private agent: show purchase info + relay access hint
+                        if (json) {
+                            console.error(JSON.stringify({
+                                error: 'ACCESS_REQUIRED',
+                                message: '이 에이전트는 접근 권한이 필요합니다.',
+                                slug,
+                                purchase_info: purchaseInfo ?? null,
+                                fix: '접근 링크 코드가 있으면: anpm install ' + slugInput + ' --code <코드>',
+                            }));
+                        }
+                        else {
+                            console.error('\x1b[31m이 에이전트는 접근 권한이 필요합니다.\x1b[0m');
+                            if (purchaseInfo?.message) {
+                                console.error(`\n  \x1b[36m${purchaseInfo.message}\x1b[0m`);
+                            }
+                            if (purchaseInfo?.url) {
+                                console.error(`  \x1b[36m${purchaseInfo.url}\x1b[0m`);
+                            }
+                            console.error(`\n\x1b[33m접근 링크 코드가 있으면: anpm install ${slugInput} --code <코드>\x1b[0m`);
+                        }
+                        process.exit(1);
+                    }
+                    else if (membershipStatus === 'member') {
+                        // Member but no access to this specific agent
+                        if (json) {
+                            console.error(JSON.stringify({
+                                error: 'NO_ACCESS',
+                                message: '이 에이전트에 대한 접근 권한이 없습니다.',
+                                slug,
+                                fix: '이 에이전트의 접근 링크 코드가 있으면 `anpm install ' + slugInput + ' --code <코드>`로 접근 권한을 얻으세요. 없으면 에이전트 제작자에게 문의하세요.',
+                            }));
+                        }
+                        else {
+                            console.error('\x1b[31m이 에이전트에 대한 접근 권한이 없습니다.\x1b[0m');
+                        }
+                        process.exit(1);
+                    }
+                    else {
+                        if (json) {
+                            console.error(JSON.stringify({
+                                error: 'ACCESS_REQUIRED',
+                                message: '이 에이전트는 접근 권한이 필요합니다.',
+                                slug,
+                                fix: '접근 코드가 있으면 `anpm install ' + slugInput + ' --code <코드>`로 설치하세요.',
+                            }));
+                        }
+                        else {
+                            console.error('\x1b[31m이 에이전트는 접근 권한이 필요합니다.\x1b[0m');
+                            console.error('\x1b[33m접근 코드가 있으면 `anpm install ' + slugInput + ' --code <코드>`로 설치하세요.\x1b[0m');
+                        }
+                        process.exit(1);
+                    }
+                }
+                else {
+                    throw fetchErr;
+                }
+            }
+            if (!agent)
+                throw new Error('에이전트 정보를 가져오지 못했습니다.');
+            // Re-bind as non-optional so TypeScript tracks the narrowing through nested scopes
+            let resolvedAgent = agent;
+            const isTTY = Boolean(process.stdin.isTTY);
+            const interactive = isTTY && !json;
+            const defaultScope = resolvedAgent.recommended_scope ?? (resolvedAgent.type === 'passive' ? 'local' : 'global');
+            // ── 1. AI tools 선택 (scope 무관, 항상 홈 디렉토리에서 감지) ──
+            let selectedTools;
+            if (interactive) {
+                const detected = (0, ai_tools_js_1.detectGlobalCLIs)();
+                if (!detected.some((t) => t.value === 'claude')) {
+                    detected.push({ name: 'Claude Code', value: 'claude', skillsDir: '.claude' });
+                }
+                const detectedValues = new Set(detected.map((t) => t.value));
+                const { checkbox } = await import('@inquirer/prompts');
+                selectedTools = await checkbox({
+                    message: '설치할 AI 도구를 선택하세요 (감지된 도구는 자동 선택됨)',
+                    choices: ai_tools_js_1.AI_TOOLS.map((t) => ({
+                        name: t.name,
+                        value: t,
+                        checked: detectedValues.has(t.value),
+                    })),
+                });
+            }
+            // ── 2. 글로벌 slash commands 설치/업데이트 ──
+            if (selectedTools) {
+                (0, init_js_1.installGlobalUserCommands)(selectedTools);
+            }
+            else if (!(0, init_js_1.hasGlobalUserCommands)()) {
+                if (!json) {
+                    console.error('\x1b[33m⚙ 글로벌 커맨드를 자동 설치합니다...\x1b[0m');
+                }
+                (0, init_js_1.installGlobalUserCommands)();
+            }
+            // ── 3. Scope 결정: 플래그 > TTY prompt > 자동결정 ──
+            let scope;
+            if (_opts.global) {
+                scope = 'global';
+            }
+            else if (_opts.local) {
+                scope = 'local';
+            }
+            else if (interactive) {
+                const { select } = await import('@inquirer/prompts');
+                const recommendLabel = defaultScope === 'global' ? '글로벌' : '로컬';
+                scope = await select({
+                    message: `설치 범위를 선택하세요 (제작자 권장: ${recommendLabel})`,
+                    choices: [
+                        { name: '글로벌 (~/.relay/agents/) — 모든 프로젝트에서 사용', value: 'global' },
+                        { name: '로컬 (./.relay/agents/) — 이 프로젝트에서만 사용', value: 'local' },
+                    ],
+                    default: defaultScope,
+                });
+            }
+            else {
+                scope = defaultScope;
+            }
+            const agentDir = scope === 'global'
+                ? path_1.default.join(os_1.default.homedir(), '.relay', 'agents', parsed.owner, parsed.name)
+                : path_1.default.join(projectPath, '.relay', 'agents', parsed.owner, parsed.name);
+            // 2. 로그인 필수 (git clone에 relay token 필요)
+            const token = await ensureToken();
+            if (!token) {
+                if (json) {
+                    console.error(JSON.stringify({
+                        error: 'LOGIN_REQUIRED',
+                        slug,
+                        message: '로그인이 필요합니다. anpm login을 먼저 실행하세요.',
+                        fix: 'anpm login 실행 후 재시도하세요.',
+                    }));
+                }
+                else {
+                    console.error('\x1b[31m로그인이 필요합니다. anpm login 을 먼저 실행하세요.\x1b[0m');
+                }
+                process.exit(1);
+            }
+            // 3. Download package via git clone
+            const requestedVersion = versionMatch ? versionMatch[2] : undefined;
+            if (!resolvedAgent.git_url) {
+                const errMsg = '이 에이전트는 재publish가 필요합니다. 빌더에게 문의하세요.';
+                if (json) {
+                    console.log(JSON.stringify({ error: 'NO_GIT_URL', message: errMsg }));
+                }
+                else {
+                    console.error(`\x1b[31m✖ ${errMsg}\x1b[0m`);
+                }
+                process.exit(1);
+            }
+            (0, git_operations_js_1.checkGitInstalled)();
+            const gitUrl = (0, git_operations_js_1.buildGitUrl)(resolvedAgent.git_url, { token });
+            await (0, storage_js_1.clonePackage)(gitUrl, agentDir, requestedVersion);
+            // Verify clone has actual files (not just .git)
+            const clonedEntries = fs_1.default.readdirSync(agentDir).filter((f) => f !== '.git');
+            if (clonedEntries.length === 0) {
+                fs_1.default.rmSync(agentDir, { recursive: true, force: true });
+                const errMsg = '에이전트 패키지가 비어있습니다. 빌더에게 재publish를 요청하세요.';
+                if (json) {
+                    console.log(JSON.stringify({ error: 'EMPTY_PACKAGE', message: errMsg }));
+                }
+                else {
+                    console.error(`\x1b[31m✖ ${errMsg}\x1b[0m`);
+                }
+                process.exit(1);
+            }
+            // 4.5. Inject preamble (update check) into SKILL.md and commands
+            (0, preamble_js_1.injectPreambleToAgent)(agentDir, slug);
+            // 5. Deploy symlinks to detected AI tool directories
+            const deploy = await (0, installer_js_1.deploySymlinks)(agentDir, scope, projectPath, selectedTools);
+            for (const w of deploy.warnings) {
+                if (!json)
+                    console.error(`\x1b[33m${w}\x1b[0m`);
+            }
+            // 6. Count extracted files
+            function countFiles(dir) {
+                let count = 0;
+                if (!fs_1.default.existsSync(dir))
+                    return 0;
+                for (const entry of fs_1.default.readdirSync(dir, { withFileTypes: true })) {
+                    if (entry.isDirectory()) {
+                        count += countFiles(path_1.default.join(dir, entry.name));
+                    }
+                    else {
+                        count++;
+                    }
+                }
+                return count;
+            }
+            const fileCount = countFiles(agentDir);
+            // 7. Record in installed.json (scope-aware)
+            const installRecord = {
+                agent_id: resolvedAgent.id,
+                version: resolvedAgent.version,
+                installed_at: new Date().toISOString(),
+                files: [agentDir],
+                deploy_scope: scope,
+                deployed_symlinks: deploy.symlinks,
+            };
+            if (scope === 'global') {
+                const globalInstalled = (0, config_js_1.loadGlobalInstalled)();
+                globalInstalled[slug] = installRecord;
+                (0, config_js_1.saveGlobalInstalled)(globalInstalled);
+            }
+            else {
+                const installed = (0, config_js_1.loadInstalled)();
+                installed[slug] = installRecord;
+                (0, config_js_1.saveInstalled)(installed);
+            }
+            // 8. Report install + usage ping (non-blocking, agent_id 기반)
+            await (0, api_js_1.reportInstall)(resolvedAgent.id, slug, resolvedAgent.version);
+            (0, api_js_1.sendUsagePing)(resolvedAgent.id, slug, resolvedAgent.version);
+            const result = {
+                status: 'ok',
+                agent: resolvedAgent.name,
+                slug,
+                version: resolvedAgent.version,
+                commands: resolvedAgent.commands,
+                files: fileCount,
+                install_path: agentDir,
+                scope,
+                symlinks: deploy.symlinks,
+                author: resolvedAgent.author ? {
+                    username: resolvedAgent.author.username,
+                    display_name: resolvedAgent.author.display_name ?? null,
+                    contact_links: resolvedAgent.author.contact_links ?? [],
+                } : null,
+                welcome: resolvedAgent.welcome ?? null,
+            };
+            if (json) {
+                console.log(JSON.stringify(result));
+            }
+            else {
+                const authorUsername = resolvedAgent.author?.username;
+                const authorSuffix = authorUsername ? `  \x1b[90mby @${authorUsername}\x1b[0m` : '';
+                const scopeLabel = scope === 'global' ? '글로벌' : '로컬';
+                console.log(`\n\x1b[32m✓ ${resolvedAgent.name} 설치 완료\x1b[0m  v${resolvedAgent.version}${authorSuffix}`);
+                console.log(`  위치: \x1b[36m${agentDir}\x1b[0m`);
+                console.log(`  범위: ${scopeLabel}`);
+                console.log(`  파일: ${fileCount}개, symlink: ${deploy.symlinks.length}개`);
+                const userCommands = resolvedAgent.commands.filter((c) => !c.name.startsWith('setup-'));
+                if (userCommands.length > 0) {
+                    console.log('\n  포함된 커맨드:');
+                    for (const cmd of userCommands) {
+                        console.log(`    \x1b[33m/${cmd.name}\x1b[0m - ${cmd.description}`);
+                    }
+                }
+                // Usage hint (type-aware, setup command 제외)
+                const agentType = resolvedAgent.type;
+                const mainCommand = userCommands[0];
+                if (agentType === 'passive') {
+                    console.log(`\n\x1b[33m💡 자동 적용됩니다. 별도 실행 없이 동작합니다.\x1b[0m`);
+                }
+                else if (agentType === 'hybrid' && mainCommand) {
+                    console.log(`\n\x1b[33m💡 자동 적용 + \x1b[1m/${mainCommand.name}\x1b[0m\x1b[33m 으로 추가 기능을 사용할 수 있습니다.\x1b[0m`);
+                }
+                else if (mainCommand) {
+                    console.log(`\n\x1b[33m💡 사용법: \x1b[1m/${mainCommand.name}\x1b[0m`);
+                }
+                else {
+                    console.log(`\n\x1b[33m💡 설치 완료! AI 에이전트에서 사용할 수 있습니다.\x1b[0m`);
+                }
+                // Requires check + setup CTA
+                const requiresResults = (0, installer_js_1.checkRequires)(agentDir);
+                (0, installer_js_1.printRequiresCheck)(requiresResults);
+                const setupCmd = resolvedAgent.commands.find((c) => c.name.startsWith('setup-'));
+                if (setupCmd && requiresResults.some((r) => r.status === 'missing' || r.status === 'warn')) {
+                    const toolNames = selectedTools
+                        ? selectedTools.map((t) => t.name).slice(0, 2).join(' 또는 ')
+                        : 'Claude Code';
+                    console.log(`\n  \x1b[36m👉 설정이 필요합니다.\x1b[0m`);
+                    console.log(`  \x1b[36m   ${toolNames}를 열고 \x1b[1m/${setupCmd.name}\x1b[0m\x1b[36m 을 입력하세요\x1b[0m`);
+                }
+                // Cloud deploy hint
+                const cloudConfig = resolvedAgent.cloud_config;
+                if (cloudConfig) {
+                    const providers = cloudConfig.supported_providers;
+                    const providerStr = providers?.join(', ') ?? 'anthropic';
+                    console.log(`\n  ☁️  Cloud deploy available. Run: \x1b[36manpm deploy ${slugInput} --to ${providerStr}\x1b[0m`);
+                }
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            (0, error_report_js_1.reportCliError)('install', 'INSTALL_FAILED', message);
+            console.error(JSON.stringify({ error: 'INSTALL_FAILED', message, fix: message }));
+            process.exit(1);
+        }
+        finally {
+            (0, storage_js_1.removeTempDir)(tempDir);
+        }
+    });
+}

package/dist/commands/join.d.ts

@@ -0,0 +1,6 @@
+import { Command } from 'commander';
+export declare function joinOrg(orgSlug: string, code: string): Promise<{
+    type: string;
+    role?: string;
+}>;
+export declare function registerJoin(program: Command): void;