anpm-io 1.0.0

package/dist/commands/config.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerConfig = registerConfig;
+const anpm_config_js_1 = require("../lib/anpm-config.js");
+function registerConfig(program) {
+    const configCmd = program
+        .command('config')
+        .description('Manage anpm CLI configuration');
+    configCmd
+        .command('get <key>')
+        .description('Get a config value')
+        .action((key) => {
+        const json = program.opts().json ?? false;
+        const config = (0, anpm_config_js_1.loadConfig)();
+        const value = config[key] ?? anpm_config_js_1.CONFIG_DEFAULTS[key];
+        if (json) {
+            console.log(JSON.stringify({ key, value: value ?? null }));
+        }
+        else {
+            console.log(value ?? `(not set, default: ${anpm_config_js_1.CONFIG_DEFAULTS[key] ?? 'none'})`);
+        }
+    });
+    configCmd
+        .command('set <key> <value>')
+        .description('Set a config value (supports dot notation: provider.anthropic.api-key)')
+        .action((key, value) => {
+        const json = program.opts().json ?? false;
+        // Support dot-notation for nested keys
+        if (key.startsWith('provider.')) {
+            (0, anpm_config_js_1.setNestedConfigKey)(key, value);
+        }
+        else {
+            const config = (0, anpm_config_js_1.loadConfig)();
+            config[key] = value;
+            (0, anpm_config_js_1.saveConfig)(config);
+        }
+        if (json) {
+            console.log(JSON.stringify({ status: 'ok', key, value }));
+        }
+        else {
+            console.log(`\x1b[32m✓\x1b[0m ${key} = ${value}`);
+        }
+    });
+    configCmd
+        .command('delete <key>')
+        .description('Delete a config value (restore default)')
+        .action((key) => {
+        const json = program.opts().json ?? false;
+        (0, anpm_config_js_1.deleteConfigKey)(key);
+        if (json) {
+            console.log(JSON.stringify({ status: 'ok', key, deleted: true }));
+        }
+        else {
+            console.log(`\x1b[32m✓\x1b[0m ${key} deleted (restored to default)`);
+        }
+    });
+    configCmd
+        .command('list')
+        .description('Show all config values')
+        .action(() => {
+        const json = program.opts().json ?? false;
+        const config = (0, anpm_config_js_1.loadConfig)();
+        const merged = { ...anpm_config_js_1.CONFIG_DEFAULTS, ...config };
+        if (json) {
+            console.log(JSON.stringify(merged));
+        }
+        else {
+            for (const [key, value] of Object.entries(merged)) {
+                if (key === 'providers' && typeof value === 'object' && value) {
+                    for (const [prov, pConfig] of Object.entries(value)) {
+                        for (const [pk, pv] of Object.entries(pConfig ?? {})) {
+                            const display = pk.includes('key') ? (0, anpm_config_js_1.maskApiKey)(String(pv)) : pv;
+                            console.log(`  provider.${prov}.${pk} = ${display}`);
+                        }
+                    }
+                    continue;
+                }
+                const isDefault = !(key in config);
+                const suffix = isDefault ? ' \x1b[90m(default)\x1b[0m' : '';
+                console.log(`  ${key} = ${value}${suffix}`);
+            }
+        }
+    });
+}

package/dist/commands/create.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerCreate(program: Command): void;

package/dist/commands/create.js

@@ -0,0 +1,227 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCreate = registerCreate;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
+const ai_tools_js_1 = require("../lib/ai-tools.js");
+const step_tracker_js_1 = require("../lib/step-tracker.js");
+const command_adapter_js_1 = require("../lib/command-adapter.js");
+const init_js_1 = require("./init.js");
+const slug_js_1 = require("../lib/slug.js");
+const paths_js_1 = require("../lib/paths.js");
+const DEFAULT_DIRS = ['.anpm/skills', '.anpm/commands'];
+/**
+ * 글로벌 User 커맨드가 없으면 설치한다.
+ */
+function ensureGlobalUserCommands() {
+    if ((0, init_js_1.hasGlobalUserCommands)())
+        return false;
+    (0, init_js_1.installGlobalUserCommands)();
+    return true;
+}
+function registerCreate(program) {
+    program
+        .command('create <name>')
+        .description('새 에이전트 프로젝트를 생성합니다')
+        .option('--description <desc>', '에이전트 설명')
+        .option('--slug <slug>', 'URL용 식별자 (영문 소문자, 숫자, 하이픈)')
+        .option('--tags <tags>', '태그 (쉼표 구분)')
+        .option('--visibility <visibility>', '공개 범위 (public, private, internal)')
+        .option('--project <dir>', '프로젝트 루트 경로 (기본: cwd, 환경변수: RELAY_PROJECT_PATH)')
+        .action(async (name, opts) => {
+        const json = program.opts().json ?? false;
+        (0, step_tracker_js_1.trackCommand)('create');
+        const projectPath = (0, paths_js_1.resolveProjectPath)(opts.project);
+        const relayDir = path_1.default.join(projectPath, '.anpm');
+        const relayYamlPath = path_1.default.join(relayDir, 'anpm.yaml');
+        const isTTY = Boolean(process.stdin.isTTY) && !json;
+        // 1. .anpm/anpm.yaml 이미 존재하면 에러
+        if (fs_1.default.existsSync(relayYamlPath)) {
+            if (json) {
+                console.error(JSON.stringify({ error: 'ALREADY_EXISTS', message: '.anpm/anpm.yaml이 이미 존재합니다.', fix: '기존 .anpm/anpm.yaml을 확인하세요. 새로 시작하려면 삭제 후 재시도.' }));
+            }
+            else {
+                console.error('.anpm/anpm.yaml이 이미 존재합니다. 기존 에이전트 프로젝트에서는 `anpm init`을 사용하세요.');
+            }
+            process.exit(1);
+        }
+        // 2. 메타데이터 수집
+        let slug = opts.slug ?? (0, slug_js_1.slugify)(name);
+        let description = opts.description ?? '';
+        let tags = opts.tags ? opts.tags.split(',').map((t) => t.trim()).filter(Boolean) : [];
+        let visibility = opts.visibility ?? 'public';
+        if (json) {
+            // --json 모드: slug가 비어있으면 에러
+            if (!slug) {
+                console.error(JSON.stringify({
+                    error: 'INVALID_SLUG',
+                    message: '이름에서 유효한 slug를 생성할 수 없습니다. 영문 이름을 사용하거나 --slug 옵션을 지정하세요.',
+                    fix: `anpm create "${name}" --slug <영문-slug> --description <설명> --json`,
+                }));
+                process.exit(1);
+            }
+            // --json 모드: 필수 값 부족 시 에러 반환 (프롬프트 없음)
+            if (!opts.description) {
+                console.error(JSON.stringify({
+                    error: 'MISSING_FIELD',
+                    message: '에이전트 설명이 필요합니다.',
+                    fix: `relay create ${name} --description <설명> --json`,
+                    field: 'description',
+                }));
+                process.exit(1);
+            }
+            if (!opts.visibility) {
+                console.error(JSON.stringify({
+                    error: 'MISSING_VISIBILITY',
+                    message: '공개 범위를 선택하세요.',
+                    fix: `relay create ${name} --description "${description}" --visibility <visibility> --json`,
+                    options: [
+                        { value: 'public', label: '공개 — 누구나 검색 및 설치 가능' },
+                        { value: 'private', label: '비공개 — 허가 코드 등록자만 사용 가능' },
+                        { value: 'internal', label: '내부 — 조직 내의 누구나 사용 가능' },
+                    ],
+                }));
+                process.exit(1);
+            }
+            if (!['public', 'private', 'internal'].includes(opts.visibility)) {
+                console.error(JSON.stringify({
+                    error: 'INVALID_FIELD',
+                    message: `유효하지 않은 visibility 값: ${opts.visibility}`,
+                    fix: `visibility는 public, private, internal 중 하나여야 합니다.`,
+                    options: [
+                        { value: 'public', label: '공개' },
+                        { value: 'private', label: '비공개' },
+                        { value: 'internal', label: '내부' },
+                    ],
+                }));
+                process.exit(1);
+            }
+        }
+        else if (isTTY) {
+            const { input: promptInput, select: promptSelect } = await import('@inquirer/prompts');
+            console.log(`\n  \x1b[33m⚡\x1b[0m \x1b[1mrelay create\x1b[0m — 새 에이전트 프로젝트\n`);
+            // slug가 비어있으면 (한국어 등 비ASCII 이름) slug를 직접 입력받음
+            if (!slug) {
+                slug = await promptInput({
+                    message: 'Slug (URL/설치에 사용되는 영문 식별자):',
+                    validate: (v) => {
+                        const trimmed = v.trim();
+                        if (!trimmed)
+                            return 'slug를 입력해주세요.';
+                        if (!/^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/.test(trimmed))
+                            return '소문자, 숫자, 하이픈만 사용 가능합니다.';
+                        return true;
+                    },
+                });
+                slug = slug.trim();
+            }
+            if (!description) {
+                description = await promptInput({
+                    message: '에이전트 설명:',
+                    validate: (v) => v.trim().length > 0 ? true : '설명을 입력해주세요.',
+                });
+            }
+            if (!opts.tags) {
+                const tagsRaw = await promptInput({
+                    message: '태그 (쉼표로 구분, 선택):',
+                    default: '',
+                });
+                tags = tagsRaw.split(',').map((t) => t.trim()).filter(Boolean);
+            }
+            if (!opts.visibility) {
+                visibility = await promptSelect({
+                    message: '공개 범위:',
+                    choices: [
+                        { name: '공개 — 누구나 검색 및 설치 가능', value: 'public' },
+                        { name: '비공개 — 허가 코드 등록자만 사용 가능', value: 'private' },
+                        { name: '내부 — 조직 내의 누구나 사용 가능', value: 'internal' },
+                    ],
+                });
+            }
+        }
+        // 3. recommended_scope 자동 추천
+        //    rules/ 존재 or 프레임워크 태그 → local, 그 외 → global
+        const frameworkTags = ['nextjs', 'react', 'vue', 'angular', 'svelte', 'nuxt', 'remix', 'astro', 'django', 'rails', 'laravel', 'spring', 'express', 'fastapi', 'flask'];
+        const hasRules = fs_1.default.existsSync(path_1.default.join(projectPath, '.relay', 'rules'))
+            || fs_1.default.existsSync(path_1.default.join(projectPath, 'rules'));
+        const hasFrameworkTag = tags.some((t) => frameworkTags.includes(t.toLowerCase()));
+        const recommendedScope = (hasRules || hasFrameworkTag) ? 'local' : 'global';
+        // 4. .relay/relay.yaml 생성
+        fs_1.default.mkdirSync(relayDir, { recursive: true });
+        const yamlData = {
+            name,
+            slug: slug,
+            description,
+            version: '1.0.0',
+            type: 'hybrid',
+            recommended_scope: recommendedScope,
+            tags,
+            visibility,
+            contents: [],
+        };
+        fs_1.default.writeFileSync(relayYamlPath, js_yaml_1.default.dump(yamlData, { lineWidth: 120 }), 'utf-8');
+        // 4. 디렉토리 구조 생성
+        const createdDirs = [];
+        for (const dir of DEFAULT_DIRS) {
+            const dirPath = path_1.default.join(projectPath, dir);
+            if (!fs_1.default.existsSync(dirPath)) {
+                fs_1.default.mkdirSync(dirPath, { recursive: true });
+                createdDirs.push(dir);
+            }
+        }
+        // 5. 로컬 Builder 슬래시 커맨드 설치
+        const detected = (0, ai_tools_js_1.detectAgentCLIs)(projectPath);
+        const localResults = [];
+        for (const tool of detected) {
+            const adapter = (0, command_adapter_js_1.createAdapter)(tool);
+            const installed = [];
+            for (const cmd of command_adapter_js_1.BUILDER_COMMANDS) {
+                const filePath = path_1.default.join(projectPath, adapter.getFilePath(cmd.id));
+                fs_1.default.mkdirSync(path_1.default.dirname(filePath), { recursive: true });
+                fs_1.default.writeFileSync(filePath, adapter.formatFile(cmd));
+                installed.push(cmd.id);
+            }
+            localResults.push({ tool: tool.name, commands: installed });
+        }
+        // 6. 글로벌 User 커맨드 (없으면 설치)
+        const globalInstalled = ensureGlobalUserCommands();
+        // 7. 출력
+        if (json) {
+            console.log(JSON.stringify({
+                status: 'ok',
+                name,
+                slug: slug,
+                recommended_scope: recommendedScope,
+                relay_yaml: 'created',
+                directories: createdDirs,
+                local_commands: localResults,
+                global_commands: globalInstalled ? 'installed' : 'already',
+            }));
+        }
+        else {
+            const scopeLabel = recommendedScope === 'global' ? '\x1b[32m글로벌\x1b[0m' : '\x1b[33m로컬\x1b[0m';
+            const scopeReason = hasRules ? 'rules/ 감지' : hasFrameworkTag ? '프레임워크 태그 감지' : '범용 에이전트';
+            console.log(`\n\x1b[32m✓ ${name} 에이전트 프로젝트 생성 완료\x1b[0m\n`);
+            console.log(`  .relay/relay.yaml 생성됨`);
+            console.log(`  recommended_scope: ${scopeLabel} (${scopeReason})`);
+            if (createdDirs.length > 0) {
+                console.log(`  디렉토리 생성: ${createdDirs.join(', ')}`);
+            }
+            if (localResults.length > 0) {
+                console.log(`\n  \x1b[36mBuilder 커맨드 (로컬)\x1b[0m`);
+                for (const r of localResults) {
+                    console.log(`    ${r.tool}: ${r.commands.map((c) => `/${c}`).join(', ')}`);
+                }
+            }
+            if (globalInstalled) {
+                console.log(`\n  \x1b[36mUser 커맨드 (글로벌)\x1b[0m — 설치됨`);
+            }
+            console.log(`\n  다음 단계: \x1b[33m/relay-publish\x1b[0m로 Space에 배포`);
+            console.log('  IDE를 재시작하면 슬래시 커맨드가 활성화됩니다.\n');
+        }
+    });
+}

package/dist/commands/deploy-record.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerDeployRecord(program: Command): void;

package/dist/commands/deploy-record.js

@@ -0,0 +1,93 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDeployRecord = registerDeployRecord;
+const path_1 = __importDefault(require("path"));
+const config_js_1 = require("../lib/config.js");
+const slug_js_1 = require("../lib/slug.js");
+function registerDeployRecord(program) {
+    program
+        .command('deploy-record <slug>')
+        .description('에이전트가 배치한 파일 정보를 installed.json에 기록합니다')
+        .requiredOption('--scope <scope>', '배치 범위 (global 또는 local)')
+        .option('--files <paths...>', '배치된 파일 경로 목록')
+        .action((slugInput, opts) => {
+        const json = program.opts().json ?? false;
+        const scope = opts.scope;
+        if (scope !== 'global' && scope !== 'local') {
+            const msg = { error: 'INVALID_SCOPE', message: '--scope는 global 또는 local이어야 합니다.' };
+            if (json) {
+                console.error(JSON.stringify(msg));
+            }
+            else {
+                console.error(`\x1b[31m오류:\x1b[0m ${msg.message}`);
+            }
+            process.exit(1);
+        }
+        const files = opts.files ?? [];
+        // Resolve absolute paths
+        const resolvedFiles = files.map((f) => f.startsWith('/') || f.startsWith('~')
+            ? f
+            : path_1.default.resolve(f));
+        // Find the agent in the appropriate registry
+        const localRegistry = (0, config_js_1.loadInstalled)();
+        const globalRegistry = (0, config_js_1.loadGlobalInstalled)();
+        // Resolve slug — check both registries for short name match
+        let slug;
+        if ((0, slug_js_1.isScopedSlug)(slugInput)) {
+            slug = slugInput;
+        }
+        else {
+            const allKeys = [...Object.keys(localRegistry), ...Object.keys(globalRegistry)];
+            const match = allKeys.find((key) => {
+                const parsed = (0, slug_js_1.parseSlug)(key);
+                return parsed && parsed.name === slugInput;
+            });
+            slug = match ?? slugInput;
+        }
+        // Check if agent exists in either registry
+        const entry = localRegistry[slug] ?? globalRegistry[slug];
+        if (!entry) {
+            const msg = { error: 'NOT_INSTALLED', message: `'${slugInput}'는 설치되어 있지 않습니다.` };
+            if (json) {
+                console.error(JSON.stringify(msg));
+            }
+            else {
+                console.error(`\x1b[31m오류:\x1b[0m ${msg.message}`);
+            }
+            process.exit(1);
+        }
+        // Update deploy info
+        entry.deploy_scope = scope;
+        entry.deployed_files = resolvedFiles;
+        // Save to the correct registry based on scope
+        if (scope === 'global') {
+            globalRegistry[slug] = entry;
+            (0, config_js_1.saveGlobalInstalled)(globalRegistry);
+            // Also update local registry if entry exists there
+            if (localRegistry[slug]) {
+                localRegistry[slug] = entry;
+                (0, config_js_1.saveInstalled)(localRegistry);
+            }
+        }
+        else {
+            localRegistry[slug] = entry;
+            (0, config_js_1.saveInstalled)(localRegistry);
+        }
+        const result = {
+            status: 'ok',
+            slug,
+            deploy_scope: scope,
+            deployed_files: resolvedFiles.length,
+        };
+        if (json) {
+            console.log(JSON.stringify(result));
+        }
+        else {
+            const scopeLabel = scope === 'global' ? '글로벌' : '로컬';
+            console.log(`\x1b[32m✓ ${slug} 배치 정보 기록 완료\x1b[0m (${scopeLabel}, ${resolvedFiles.length}개 파일)`);
+        }
+    });
+}

package/dist/commands/deploy.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerDeploy(program: Command): void;