anpm-io 1.0.0

package/dist/commands/update.js

@@ -0,0 +1,171 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerUpdate = registerUpdate;
+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 installer_js_1 = require("../lib/installer.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 paths_js_1 = require("../lib/paths.js");
+function registerUpdate(program) {
+    program
+        .command('update <slug>')
+        .description('설치된 에이전트를 최신 버전으로 업데이트합니다')
+        .option('--path <install_path>', '설치 경로 지정 (기본: ./.claude)')
+        .option('--code <code>', '초대 코드 (비공개 에이전트 업데이트 시 필요)')
+        .action(async (slugInput, opts) => {
+        const json = program.opts().json ?? false;
+        const tempDir = (0, storage_js_1.makeTempDir)();
+        const projectPath = (0, paths_js_1.resolveProjectPath)(opts.path);
+        try {
+            // Resolve scoped slug
+            const localInstalled = (0, config_js_1.loadInstalled)();
+            const globalInstalled = (0, config_js_1.loadGlobalInstalled)();
+            let slug;
+            if ((0, slug_js_1.isScopedSlug)(slugInput)) {
+                slug = slugInput;
+            }
+            else {
+                const parsed = await (0, slug_js_1.resolveSlug)(slugInput);
+                slug = parsed.full;
+            }
+            // Find current entry (check both registries)
+            const currentEntry = localInstalled[slug] ?? globalInstalled[slug];
+            const currentVersion = currentEntry?.version ?? null;
+            const currentScope = globalInstalled[slug] ? 'global'
+                : currentEntry?.deploy_scope ?? 'global';
+            // Fetch latest agent metadata
+            const agent = await (0, api_js_1.fetchAgentInfo)(slug);
+            const latestVersion = agent.version;
+            if (currentVersion && currentVersion === latestVersion) {
+                if (json) {
+                    console.log(JSON.stringify({ status: 'up-to-date', slug, version: latestVersion }));
+                }
+                else {
+                    console.log(`이미 최신 버전입니다  (${slug} v${latestVersion})`);
+                }
+                return;
+            }
+            // Visibility check
+            const visibility = agent.visibility ?? 'public';
+            if (visibility === 'internal') {
+                const token = await (0, config_js_1.getValidToken)();
+                if (!token) {
+                    console.error('이 에이전트는 Org 멤버만 업데이트할 수 있습니다. `anpm login`을 먼저 실행하세요.');
+                    process.exit(1);
+                }
+            }
+            // Clean up old symlinks (new) and deployed_files (legacy migration)
+            if (currentEntry?.deployed_symlinks && currentEntry.deployed_symlinks.length > 0) {
+                (0, installer_js_1.removeSymlinks)(currentEntry.deployed_symlinks);
+            }
+            if (currentEntry?.deployed_files && currentEntry.deployed_files.length > 0) {
+                (0, installer_js_1.uninstallAgent)(currentEntry.deployed_files);
+            }
+            // Determine agent directory
+            const parsedSlug = (0, slug_js_1.parseSlug)(slug);
+            const owner = parsedSlug?.owner ?? 'unknown';
+            const name = parsedSlug?.name ?? slug;
+            const agentDir = currentScope === 'global'
+                ? path_1.default.join(os_1.default.homedir(), '.relay', 'agents', owner, name)
+                : path_1.default.join(projectPath, '.relay', 'agents', owner, name);
+            // Download & extract: prefer git, fallback to tar.gz
+            if (agent.git_url && fs_1.default.existsSync(path_1.default.join(agentDir, '.git'))) {
+                // Existing git clone — fetch + checkout latest tag
+                (0, git_operations_js_1.checkGitInstalled)();
+                (0, git_operations_js_1.gitFetch)(agentDir);
+                const latestTag = (0, git_operations_js_1.gitLatestTag)(agentDir);
+                if (latestTag) {
+                    (0, git_operations_js_1.gitCheckout)(agentDir, latestTag);
+                }
+            }
+            else if (agent.git_url) {
+                // No existing clone — fresh git clone
+                (0, git_operations_js_1.checkGitInstalled)();
+                await (0, storage_js_1.clonePackage)(agent.git_url, agentDir);
+            }
+            else {
+                throw new Error('이 에이전트는 재설치가 필요합니다. anpm install로 다시 설치하세요.');
+            }
+            // Inject preamble
+            (0, preamble_js_1.injectPreambleToAgent)(agentDir, slug);
+            // Deploy symlinks (always — handles migration from legacy deployed_files)
+            const deploy = await (0, installer_js_1.deploySymlinks)(agentDir, currentScope, projectPath);
+            // Update installed.json
+            const installRecord = {
+                agent_id: agent.id,
+                version: latestVersion,
+                installed_at: new Date().toISOString(),
+                files: [agentDir],
+                deploy_scope: currentScope,
+                deployed_symlinks: deploy.symlinks,
+            };
+            if (currentScope === 'global') {
+                globalInstalled[slug] = installRecord;
+                (0, config_js_1.saveGlobalInstalled)(globalInstalled);
+                // Clean up local entry if migrating
+                if (localInstalled[slug]) {
+                    delete localInstalled[slug];
+                    (0, config_js_1.saveInstalled)(localInstalled);
+                }
+            }
+            else {
+                localInstalled[slug] = installRecord;
+                (0, config_js_1.saveInstalled)(localInstalled);
+            }
+            // Report
+            await (0, api_js_1.reportInstall)(agent.id, slug, latestVersion);
+            const result = {
+                status: 'updated',
+                slug,
+                from_version: currentVersion,
+                version: latestVersion,
+                scope: currentScope,
+                symlinks: deploy.symlinks.length,
+            };
+            if (json) {
+                console.log(JSON.stringify(result));
+            }
+            else {
+                const fromLabel = currentVersion ? `v${currentVersion} → ` : '';
+                console.log(`\n\x1b[32m✓ ${agent.name} ${fromLabel}v${latestVersion} 업데이트 완료\x1b[0m`);
+                console.log(`  위치: \x1b[36m${agentDir}\x1b[0m`);
+                console.log(`  symlink: ${deploy.symlinks.length}개`);
+                // Show changelog
+                try {
+                    const versions = await (0, api_js_1.fetchAgentVersions)(slug);
+                    const thisVersion = versions.find((v) => v.version === latestVersion);
+                    if (thisVersion?.changelog) {
+                        console.log(`\n  \x1b[90m── Changelog ──────────────────────────────\x1b[0m`);
+                        for (const line of thisVersion.changelog.split('\n').slice(0, 5)) {
+                            console.log(`  ${line}`);
+                        }
+                        console.log(`  \x1b[90m───────────────────────────────────────────\x1b[0m`);
+                    }
+                }
+                catch {
+                    // Non-critical
+                }
+                // Requires check
+                const requiresResults = (0, installer_js_1.checkRequires)(agentDir);
+                (0, installer_js_1.printRequiresCheck)(requiresResults);
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(JSON.stringify({ error: 'UPDATE_FAILED', message, fix: 'npm update -g relayax-cli로 수동 업데이트하세요.' }));
+            process.exit(1);
+        }
+        finally {
+            (0, storage_js_1.removeTempDir)(tempDir);
+        }
+    });
+}

package/dist/commands/versions.d.ts

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

package/dist/commands/versions.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerVersions = registerVersions;
+const api_js_1 = require("../lib/api.js");
+const slug_js_1 = require("../lib/slug.js");
+function registerVersions(program) {
+    program
+        .command('versions <slug>')
+        .description('에이전트 버전 목록과 릴리즈 노트를 확인합니다')
+        .action(async (slugInput) => {
+        const json = program.opts().json ?? false;
+        try {
+            const resolved = await (0, slug_js_1.resolveSlug)(slugInput);
+            const versions = await (0, api_js_1.fetchAgentVersions)(resolved.full);
+            if (json) {
+                console.log(JSON.stringify({ slug: resolved.full, versions }));
+                return;
+            }
+            if (versions.length === 0) {
+                console.log(`\n${resolved.full} 버전 이력이 없습니다.`);
+                return;
+            }
+            console.log(`\n\x1b[1m${resolved.full} 버전 이력\x1b[0m (${versions.length}개):\n`);
+            for (const v of versions) {
+                const date = new Date(v.created_at).toLocaleDateString('ko-KR');
+                console.log(`  \x1b[36mv${v.version}\x1b[0m  (${date})`);
+                if (v.changelog) {
+                    console.log(`    \x1b[90m${v.changelog}\x1b[0m`);
+                }
+            }
+            console.log(`\n\x1b[33m  특정 버전 설치: anpm install ${resolved.full}@<version>\x1b[0m`);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (json) {
+                console.error(JSON.stringify({ error: 'VERSIONS_FAILED', message }));
+            }
+            else {
+                console.error(`\x1b[31m오류: ${message}\x1b[0m`);
+            }
+            process.exit(1);
+        }
+    });
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,91 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const init_js_1 = require("./commands/init.js");
+const create_js_1 = require("./commands/create.js");
+const status_js_1 = require("./commands/status.js");
+const search_js_1 = require("./commands/search.js");
+const install_js_1 = require("./commands/install.js");
+const list_js_1 = require("./commands/list.js");
+const uninstall_js_1 = require("./commands/uninstall.js");
+const package_js_1 = require("./commands/package.js");
+const publish_js_1 = require("./commands/publish.js");
+const login_js_1 = require("./commands/login.js");
+const update_js_1 = require("./commands/update.js");
+const outdated_js_1 = require("./commands/outdated.js");
+const check_update_js_1 = require("./commands/check-update.js");
+const changelog_js_1 = require("./commands/changelog.js");
+const join_js_1 = require("./commands/join.js");
+const orgs_js_1 = require("./commands/orgs.js");
+const deploy_record_js_1 = require("./commands/deploy-record.js");
+const ping_js_1 = require("./commands/ping.js");
+const access_js_1 = require("./commands/access.js");
+const grant_js_1 = require("./commands/grant.js");
+const versions_js_1 = require("./commands/versions.js");
+const diff_js_1 = require("./commands/diff.js");
+const feedback_js_1 = require("./commands/feedback.js");
+const link_js_1 = require("./commands/link.js");
+const config_js_1 = require("./commands/config.js");
+const adopt_js_1 = require("./commands/adopt.js");
+const run_js_1 = require("./commands/run.js");
+const deploy_js_1 = require("./commands/deploy.js");
+const server_js_1 = require("./mcp/server.js");
+const migration_js_1 = require("./lib/migration.js");
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const pkg = require('../package.json');
+const program = new commander_1.Command();
+program
+    .name('anpm')
+    .description('anpm — the agent package manager')
+    .version(pkg.version)
+    .option('--json', '구조화된 JSON 출력');
+(0, init_js_1.registerInit)(program);
+(0, create_js_1.registerCreate)(program);
+(0, status_js_1.registerStatus)(program);
+(0, search_js_1.registerSearch)(program);
+(0, install_js_1.registerInstall)(program);
+(0, list_js_1.registerList)(program);
+(0, uninstall_js_1.registerUninstall)(program);
+(0, package_js_1.registerPackage)(program);
+(0, publish_js_1.registerPublish)(program);
+(0, login_js_1.registerLogin)(program);
+(0, update_js_1.registerUpdate)(program);
+(0, outdated_js_1.registerOutdated)(program);
+(0, check_update_js_1.registerCheckUpdate)(program);
+(0, changelog_js_1.registerChangelog)(program);
+(0, join_js_1.registerJoin)(program);
+(0, orgs_js_1.registerOrgs)(program);
+(0, deploy_record_js_1.registerDeployRecord)(program);
+(0, ping_js_1.registerPing)(program);
+(0, access_js_1.registerAccess)(program);
+(0, grant_js_1.registerGrant)(program);
+(0, versions_js_1.registerVersions)(program);
+(0, diff_js_1.registerDiff)(program);
+(0, feedback_js_1.registerFeedback)(program);
+(0, link_js_1.registerLink)(program);
+(0, config_js_1.registerConfig)(program);
+(0, adopt_js_1.registerAdopt)(program);
+(0, run_js_1.registerRun)(program);
+(0, deploy_js_1.registerDeploy)(program);
+program
+    .command('mcp')
+    .description('MCP 서버 모드로 실행합니다 (stdio transport)')
+    .action(async () => {
+    await (0, server_js_1.startMcpServer)();
+});
+// 모든 명령 실행 전 마이그레이션 + 버전 표시
+program.hook('preAction', (_thisCommand, actionCommand) => {
+    const isJson = program.opts().json ?? false;
+    const isMcp = actionCommand.name() === 'mcp';
+    // 마이그레이션은 항상 실행 (mcp 제외)
+    if (!isMcp) {
+        (0, migration_js_1.migrateGlobalDir)();
+        (0, migration_js_1.migrateProjectDir)(process.env.RELAY_PROJECT_PATH ?? process.cwd());
+    }
+    // 버전 표시는 TTY + non-json만
+    if (!isJson && !isMcp && process.stderr.isTTY) {
+        process.stderr.write(`\x1b[2manpm v${pkg.version}\x1b[0m\n`);
+    }
+});
+program.parse();

package/dist/lib/agent-status.d.ts

@@ -0,0 +1,23 @@
+export interface AgentStatusEntry {
+    slug: string;
+    source: string;
+    version: string;
+    scope: 'global' | 'local';
+    status: 'active' | 'broken' | 'unknown';
+    harnesses: string[];
+    symlinkCount: number;
+    brokenSymlinks: string[];
+}
+/**
+ * Get detailed status of all installed agents with harness mapping.
+ */
+export declare function getAgentStatusEntries(): AgentStatusEntry[];
+/**
+ * Scan harness directories for unmanaged (non-relay) content.
+ */
+export declare function findUnmanagedContent(projectPath: string): {
+    harness: string;
+    type: string;
+    name: string;
+    path: string;
+}[];

package/dist/lib/agent-status.js

@@ -0,0 +1,127 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAgentStatusEntries = getAgentStatusEntries;
+exports.findUnmanagedContent = findUnmanagedContent;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const config_js_1 = require("./config.js");
+const ai_tools_js_1 = require("./ai-tools.js");
+/**
+ * Get detailed status of all installed agents with harness mapping.
+ */
+function getAgentStatusEntries() {
+    const { global: globalInstalled, local: localInstalled } = (0, config_js_1.loadMergedInstalled)();
+    const entries = [];
+    function processRegistry(registry, scope) {
+        for (const [slug, info] of Object.entries(registry)) {
+            const symlinks = info.deployed_symlinks ?? [];
+            const broken = [];
+            const harnessSet = new Set();
+            for (const link of symlinks) {
+                if (!isSymlink(link)) {
+                    broken.push(link);
+                }
+                else {
+                    // Extract harness name from path
+                    const harnessName = extractHarnessName(link);
+                    if (harnessName)
+                        harnessSet.add(harnessName);
+                }
+            }
+            entries.push({
+                slug,
+                source: info.source ?? 'registry',
+                version: info.version,
+                scope: (info.deploy_scope ?? scope),
+                status: broken.length > 0 ? 'broken' : symlinks.length > 0 ? 'active' : 'unknown',
+                harnesses: Array.from(harnessSet),
+                symlinkCount: symlinks.length - broken.length,
+                brokenSymlinks: broken,
+            });
+        }
+    }
+    processRegistry(globalInstalled, 'global');
+    processRegistry(localInstalled, 'local');
+    return entries;
+}
+/**
+ * Scan harness directories for unmanaged (non-relay) content.
+ */
+function findUnmanagedContent(projectPath) {
+    const unmanaged = [];
+    const homeDir = os_1.default.homedir();
+    const contentDirs = ['skills', 'commands', 'rules', 'agents'];
+    for (const tool of ai_tools_js_1.AI_TOOLS) {
+        // Check both global and local harness dirs
+        const dirs = [
+            { base: path_1.default.join(homeDir, tool.skillsDir), scope: 'global' },
+            { base: path_1.default.join(projectPath, tool.skillsDir), scope: 'local' },
+        ];
+        for (const { base } of dirs) {
+            for (const contentType of contentDirs) {
+                const dir = path_1.default.join(base, contentType);
+                if (!fs_1.default.existsSync(dir))
+                    continue;
+                for (const entry of fs_1.default.readdirSync(dir, { withFileTypes: true })) {
+                    if (entry.name.startsWith('.'))
+                        continue;
+                    if (entry.name === 'relay')
+                        continue; // skip relay's own dir
+                    const entryPath = path_1.default.join(dir, entry.name);
+                    // If it's not a symlink pointing into .relay/agents/, it's unmanaged
+                    if (!isRelaySymlink(entryPath)) {
+                        unmanaged.push({
+                            harness: tool.name,
+                            type: contentType,
+                            name: entry.name,
+                            path: entryPath,
+                        });
+                    }
+                }
+            }
+        }
+    }
+    // Deduplicate by path
+    const seen = new Set();
+    return unmanaged.filter((item) => {
+        if (seen.has(item.path))
+            return false;
+        seen.add(item.path);
+        return true;
+    });
+}
+function isSymlink(p) {
+    try {
+        const stat = fs_1.default.lstatSync(p);
+        if (!stat.isSymbolicLink())
+            return false;
+        // Also check if target exists
+        return fs_1.default.existsSync(p);
+    }
+    catch {
+        return false;
+    }
+}
+function isRelaySymlink(p) {
+    try {
+        if (!fs_1.default.lstatSync(p).isSymbolicLink())
+            return false;
+        const target = fs_1.default.readlinkSync(p);
+        return target.includes('.relay/agents/') || target.includes('.relay\\agents\\');
+    }
+    catch {
+        return false;
+    }
+}
+function extractHarnessName(symlinkPath) {
+    for (const tool of ai_tools_js_1.AI_TOOLS) {
+        if (symlinkPath.includes(tool.skillsDir)) {
+            return tool.name;
+        }
+    }
+    return undefined;
+}

package/dist/lib/ai-tools.d.ts

@@ -0,0 +1,34 @@
+export interface AITool {
+    name: string;
+    value: string;
+    skillsDir: string;
+}
+/**
+ * Agent Skills 표준을 지원하는 에이전트 CLI 목록.
+ * @fission-ai/openspec의 AI_TOOLS에서 차용.
+ */
+export declare const AI_TOOLS: AITool[];
+/**
+ * 프로젝트 디렉토리에서 에이전트 CLI 디렉토리를 감지한다.
+ */
+export declare function detectAgentCLIs(projectPath: string): AITool[];
+/**
+ * 홈 디렉토리에서 글로벌 에이전트 CLI 디렉토리를 감지한다.
+ * ~/{skillsDir}/ 가 존재하는 CLI를 반환.
+ */
+export declare function detectGlobalCLIs(home?: string): AITool[];
+export type ContentType = 'skill' | 'agent' | 'command' | 'rule';
+export interface ContentItem {
+    name: string;
+    type: ContentType;
+    /** 소스 디렉토리 기준 상대 경로 (예: skills/code-review) */
+    relativePath: string;
+}
+/**
+ * 프로젝트 로컬 소스의 개별 스킬/에이전트/커맨드/룰 항목을 반환한다.
+ */
+export declare function scanLocalItems(projectPath: string, tool: AITool): ContentItem[];
+/**
+ * 글로벌 홈 디렉토리 소스의 개별 스킬/에이전트/커맨드/룰 항목을 반환한다.
+ */
+export declare function scanGlobalItems(tool: AITool, home?: string): ContentItem[];

package/dist/lib/ai-tools.js

@@ -0,0 +1,104 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AI_TOOLS = void 0;
+exports.detectAgentCLIs = detectAgentCLIs;
+exports.detectGlobalCLIs = detectGlobalCLIs;
+exports.scanLocalItems = scanLocalItems;
+exports.scanGlobalItems = scanGlobalItems;
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+/**
+ * Agent Skills 표준을 지원하는 에이전트 CLI 목록.
+ * @fission-ai/openspec의 AI_TOOLS에서 차용.
+ */
+exports.AI_TOOLS = [
+    { name: 'Amazon Q Developer', value: 'amazon-q', skillsDir: '.amazonq' },
+    { name: 'Antigravity', value: 'antigravity', skillsDir: '.agent' },
+    { name: 'Auggie', value: 'auggie', skillsDir: '.augment' },
+    { name: 'Claude Code', value: 'claude', skillsDir: '.claude' },
+    { name: 'Cline', value: 'cline', skillsDir: '.cline' },
+    { name: 'Codex', value: 'codex', skillsDir: '.codex' },
+    { name: 'CodeBuddy', value: 'codebuddy', skillsDir: '.codebuddy' },
+    { name: 'Continue', value: 'continue', skillsDir: '.continue' },
+    { name: 'CoStrict', value: 'costrict', skillsDir: '.cospec' },
+    { name: 'Crush', value: 'crush', skillsDir: '.crush' },
+    { name: 'Cursor', value: 'cursor', skillsDir: '.cursor' },
+    { name: 'Factory Droid', value: 'factory', skillsDir: '.factory' },
+    { name: 'Gemini CLI', value: 'gemini', skillsDir: '.gemini' },
+    { name: 'GitHub Copilot', value: 'github-copilot', skillsDir: '.github' },
+    { name: 'Hermes Agent', value: 'hermes', skillsDir: '.hermes' },
+    { name: 'iFlow', value: 'iflow', skillsDir: '.iflow' },
+    { name: 'Kilo Code', value: 'kilocode', skillsDir: '.kilocode' },
+    { name: 'Kiro', value: 'kiro', skillsDir: '.kiro' },
+    { name: 'OpenClaw', value: 'openclaw', skillsDir: '.openclaw' },
+    { name: 'OpenCode', value: 'opencode', skillsDir: '.opencode' },
+    { name: 'Pi', value: 'pi', skillsDir: '.pi' },
+    { name: 'Qoder', value: 'qoder', skillsDir: '.qoder' },
+    { name: 'Qwen Code', value: 'qwen', skillsDir: '.qwen' },
+    { name: 'RooCode', value: 'roocode', skillsDir: '.roo' },
+    { name: 'Trae', value: 'trae', skillsDir: '.trae' },
+    { name: 'Windsurf', value: 'windsurf', skillsDir: '.windsurf' },
+];
+/**
+ * 프로젝트 디렉토리에서 에이전트 CLI 디렉토리를 감지한다.
+ */
+function detectAgentCLIs(projectPath) {
+    return exports.AI_TOOLS.filter((tool) => fs_1.default.existsSync(path_1.default.join(projectPath, tool.skillsDir)));
+}
+/**
+ * 홈 디렉토리에서 글로벌 에이전트 CLI 디렉토리를 감지한다.
+ * ~/{skillsDir}/ 가 존재하는 CLI를 반환.
+ */
+function detectGlobalCLIs(home) {
+    const homeDir = home ?? os_1.default.homedir();
+    return exports.AI_TOOLS.filter((tool) => fs_1.default.existsSync(path_1.default.join(homeDir, tool.skillsDir)));
+}
+const CONTENT_DIRS = [
+    { dir: 'skills', type: 'skill' },
+    { dir: 'agents', type: 'agent' },
+    { dir: 'commands', type: 'command' },
+    { dir: 'rules', type: 'rule' },
+];
+const EXCLUDE_SUBDIRS = ['relay'];
+/**
+ * 소스 디렉토리(basePath) 안의 skills/, agents/, commands/, rules/에서
+ * 개별 항목을 스캔하여 반환한다.
+ */
+function scanItemsIn(basePath) {
+    const items = [];
+    for (const { dir, type } of CONTENT_DIRS) {
+        const fullDir = path_1.default.join(basePath, dir);
+        if (!fs_1.default.existsSync(fullDir))
+            continue;
+        for (const entry of fs_1.default.readdirSync(fullDir, { withFileTypes: true })) {
+            if (entry.name.startsWith('.'))
+                continue;
+            if (entry.isDirectory() && EXCLUDE_SUBDIRS.includes(entry.name))
+                continue;
+            items.push({
+                name: entry.name.replace(/\.\w+$/, ''), // 파일이면 확장자 제거
+                type,
+                relativePath: path_1.default.join(dir, entry.name),
+            });
+        }
+    }
+    return items;
+}
+/**
+ * 프로젝트 로컬 소스의 개별 스킬/에이전트/커맨드/룰 항목을 반환한다.
+ */
+function scanLocalItems(projectPath, tool) {
+    const basePath = path_1.default.join(projectPath, tool.skillsDir);
+    return scanItemsIn(basePath);
+}
+/**
+ * 글로벌 홈 디렉토리 소스의 개별 스킬/에이전트/커맨드/룰 항목을 반환한다.
+ */
+function scanGlobalItems(tool, home) {
+    const basePath = path_1.default.join(home ?? os_1.default.homedir(), tool.skillsDir);
+    return scanItemsIn(basePath);
+}

package/dist/lib/anpm-config.d.ts

@@ -0,0 +1,39 @@
+export interface ProviderConfig {
+    api_key?: string;
+    default_model?: string;
+}
+export interface AnpmConfig {
+    registry?: string;
+    locale?: string;
+    providers?: {
+        anthropic?: ProviderConfig;
+        [provider: string]: ProviderConfig | undefined;
+    };
+    [key: string]: unknown;
+}
+/** @deprecated Use AnpmConfig */
+export type RelayConfig = AnpmConfig;
+export declare const CONFIG_DEFAULTS: AnpmConfig;
+export declare function loadConfig(): AnpmConfig;
+export declare function saveConfig(config: AnpmConfig): void;
+export declare function deleteConfigKey(key: string): void;
+/**
+ * Get the registry URL from config, with fallback to default.
+ */
+export declare function getRegistryUrl(): string;
+/**
+ * Resolve provider API key with priority:
+ * 1. explicit flag (--api-key)
+ * 2. environment variable (ANTHROPIC_API_KEY etc.)
+ * 3. config.json providers section
+ */
+export declare function resolveProviderApiKey(provider: string, flagValue?: string): string | undefined;
+/**
+ * Mask an API key for display: sk-ant-xxx...xxxx
+ */
+export declare function maskApiKey(key: string): string;
+/**
+ * Set a nested config key using dot notation.
+ * e.g. "provider.anthropic.api-key" → config.providers.anthropic.api_key
+ */
+export declare function setNestedConfigKey(dotPath: string, value: string): void;