@orchagent/cli 0.3.0 → 0.3.2

package/dist/adapters/agents-md.js

@@ -29,7 +29,8 @@ exports.agentsMdAdapter = {
         return { canConvert: true, warnings, errors };
     },
     convert(agent) {
-        const agentRef = `${agent.org_slug}/${agent.name}`;
+        const orgSlug = agent.org_slug || 'unknown';
+        const agentRef = `${orgSlug}/${agent.name}`;
         const description = agent.description || '';
         // Use orchagent markers for managed section
         const content = `<!-- orchagent:${agentRef} -->

package/dist/adapters/claude-code.js

@@ -4,29 +4,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.claudeCodeAdapter = void 0;
+const utils_1 = require("./utils");
 const yaml_1 = __importDefault(require("yaml"));
-// Map Anthropic model names to Claude Code aliases
-function mapModelToAlias(model) {
-    if (!model)
-        return 'inherit';
-    const lower = model.toLowerCase();
-    if (lower.includes('opus'))
-        return 'opus';
-    if (lower.includes('haiku'))
-        return 'haiku';
-    // Default to sonnet for any Claude model
-    if (lower.includes('claude') || lower.includes('sonnet'))
-        return 'sonnet';
-    return 'inherit';
-}
-// Convert agent name to valid Claude Code name (lowercase + hyphens)
-function normalizeAgentName(name) {
-    return name
-        .toLowerCase()
-        .replace(/[^a-z0-9-]/g, '-')
-        .replace(/-+/g, '-')
-        .replace(/^-|-$/g, '');
-}
 exports.claudeCodeAdapter = {
     id: 'claude-code',
     name: 'Claude Code Sub-Agent',
@@ -68,7 +47,7 @@ exports.claudeCodeAdapter = {
         return { canConvert: true, warnings, errors };
     },
     convert(agent) {
-        const normalizedName = normalizeAgentName(agent.name);
+        const normalizedName = (0, utils_1.normalizeAgentName)(agent.name);
         // Build frontmatter
         const frontmatter = {
             name: normalizedName,
@@ -77,7 +56,7 @@ exports.claudeCodeAdapter = {
         };
         // Map model if specified
         if (agent.default_models?.anthropic) {
-            const modelAlias = mapModelToAlias(agent.default_models.anthropic);
+            const modelAlias = (0, utils_1.mapModelToAlias)(agent.default_models.anthropic);
             if (modelAlias !== 'inherit') {
                 frontmatter.model = modelAlias;
             }

package/dist/adapters/cursor.js

@@ -1,14 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.cursorAdapter = void 0;
-// Convert agent name to valid filename (lowercase + hyphens)
-function normalizeAgentName(name) {
-    return name
-        .toLowerCase()
-        .replace(/[^a-z0-9-]/g, '-')
-        .replace(/-+/g, '-')
-        .replace(/^-|-$/g, '');
-}
+const utils_1 = require("./utils");
 exports.cursorAdapter = {
     id: 'cursor',
     name: 'Cursor Rules',
@@ -43,7 +36,7 @@ exports.cursorAdapter = {
         return { canConvert: true, warnings, errors };
     },
     convert(agent) {
-        const normalizedName = normalizeAgentName(agent.name);
+        const normalizedName = (0, utils_1.normalizeAgentName)(agent.name);
         const description = agent.description || `Rules from ${agent.name}`;
         // Cursor .mdc format
         const content = `---

package/dist/adapters/index.js

@@ -14,9 +14,13 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.agentsMdAdapter = exports.cursorAdapter = exports.claudeCodeAdapter = exports.adapterRegistry = exports.AdapterRegistry = void 0;
+exports.agentsMdAdapter = exports.cursorAdapter = exports.claudeCodeAdapter = exports.adapterRegistry = exports.AdapterRegistry = exports.mapModelToAlias = exports.normalizeAgentName = void 0;
 // Export types
 __exportStar(require("./types"), exports);
+// Export utilities
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "normalizeAgentName", { enumerable: true, get: function () { return utils_1.normalizeAgentName; } });
+Object.defineProperty(exports, "mapModelToAlias", { enumerable: true, get: function () { return utils_1.mapModelToAlias; } });
 // Export registry
 const registry_1 = require("./registry");
 var registry_2 = require("./registry");

package/dist/adapters/utils.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * Shared utilities for format adapters
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeAgentName = normalizeAgentName;
+exports.mapModelToAlias = mapModelToAlias;
+/**
+ * Convert agent name to valid format (lowercase + hyphens only).
+ * Used for filenames and identifiers across all adapters.
+ */
+function normalizeAgentName(name) {
+    const normalized = name
+        .toLowerCase()
+        .replace(/[^a-z0-9-]/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+    return normalized || 'agent'; // Fallback if empty
+}
+/**
+ * Map Anthropic model names to Claude Code aliases.
+ */
+function mapModelToAlias(model) {
+    if (!model)
+        return 'inherit';
+    const lower = model.toLowerCase();
+    if (lower.includes('opus'))
+        return 'opus';
+    if (lower.includes('haiku'))
+        return 'haiku';
+    // Default to sonnet for any Claude model
+    if (lower.includes('claude') || lower.includes('sonnet'))
+        return 'sonnet';
+    return 'inherit';
+}

package/dist/commands/config.js

@@ -3,6 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerConfigCommand = registerConfigCommand;
 const config_1 = require("../lib/config");
 const errors_1 = require("../lib/errors");
+const adapters_1 = require("../adapters");
+// Valid formats: union of skill directory formats and agent export adapters
+function getAllValidFormatIds() {
+    const adapterIds = adapters_1.adapterRegistry.getIds();
+    const skillFormatIds = [...config_1.VALID_FORMAT_IDS];
+    return [...new Set([...adapterIds, ...skillFormatIds])];
+}
 const SUPPORTED_KEYS = ['default-format'];
 function isValidKey(key) {
     return SUPPORTED_KEYS.includes(key);
@@ -13,10 +20,11 @@ async function setConfigValue(key, value) {
     }
     if (key === 'default-format') {
         const formats = value.split(',').map((f) => f.trim()).filter(Boolean);
-        // Validate all format IDs
-        const invalidFormats = formats.filter((f) => !config_1.VALID_FORMAT_IDS.includes(f));
+        // Validate format IDs against union of skill formats and agent adapters
+        const validFormatIds = getAllValidFormatIds();
+        const invalidFormats = formats.filter((f) => !validFormatIds.includes(f));
         if (invalidFormats.length > 0) {
-            throw new errors_1.CliError(`Invalid format ID(s): ${invalidFormats.join(', ')}. Valid formats: ${config_1.VALID_FORMAT_IDS.join(', ')}`);
+            throw new errors_1.CliError(`Invalid format ID(s): ${invalidFormats.join(', ')}. Valid formats: ${validFormatIds.join(', ')}`);
         }
         await (0, config_1.setDefaultFormats)(formats);
         process.stdout.write(`Set default-format to: ${formats.join(',')}\n`);

package/dist/commands/formats.js

@@ -31,10 +31,7 @@ function registerFormatsCommand(program) {
             process.stdout.write(`               Supports: ${adapter.supportsAgentTypes.join(', ')} agents\n`);
             process.stdout.write(`               Format version: ${adapter.formatVersion}\n`);
             for (const installPath of adapter.installPaths) {
-                const pathDisplay = installPath.scope === 'user'
-                    ? installPath.path
-                    : installPath.path;
-                process.stdout.write(`               ${installPath.scope}: ${pathDisplay}\n`);
+                process.stdout.write(`               ${installPath.scope}: ${installPath.path}\n`);
             }
             process.stdout.write('\n');
         }

package/dist/commands/install.js

@@ -13,6 +13,7 @@ const errors_1 = require("../lib/errors");
 const analytics_1 = require("../lib/analytics");
 const adapters_1 = require("../adapters");
 const installed_1 = require("../lib/installed");
+const agents_md_utils_1 = require("../lib/agents-md-utils");
 const DEFAULT_VERSION = 'v1';
 function parseAgentRef(value) {
     const [ref, versionPart] = value.split('@');
@@ -96,7 +97,7 @@ function registerInstallCommand(program) {
             }
         }
         // Validate scope
-        const scope = options.scope;
+        let scope = options.scope;
         if (scope !== 'user' && scope !== 'project') {
             throw new errors_1.CliError('Scope must be "user" or "project"');
         }
@@ -104,6 +105,7 @@ function registerInstallCommand(program) {
         process.stdout.write(`Fetching ${org}/${parsed.name}@${parsed.version}...\n`);
         const agent = await downloadAgentWithFallback(resolved, org, parsed.name, parsed.version);
         // Install for each format
+        let filesWritten = 0;
         for (const formatId of targetFormats) {
             const adapter = adapters_1.adapterRegistry.get(formatId);
             if (!adapter) {
@@ -123,10 +125,18 @@ function registerInstallCommand(program) {
             for (const warn of checkResult.warnings) {
                 process.stdout.write(`Warning (${formatId}): ${warn}\n`);
             }
+            // Determine scope for this adapter (use local variable to not affect other formats)
+            let effectiveScope = scope;
+            const supportedScopes = adapter.installPaths.map(p => p.scope);
+            if (!supportedScopes.includes(effectiveScope)) {
+                process.stderr.write(`Warning: ${adapter.name} doesn't support '${scope}' scope. ` +
+                    `Supported: ${supportedScopes.join(', ')}. Using '${supportedScopes[0]}' instead.\n`);
+                effectiveScope = supportedScopes[0];
+            }
             // Convert
             const files = adapter.convert(agent);
             // Determine base directory
-            const baseDir = scope === 'user' ? os_1.default.homedir() : process.cwd();
+            const baseDir = effectiveScope === 'user' ? os_1.default.homedir() : process.cwd();
             // Install each file
             for (const file of files) {
                 const fullDir = path_1.default.join(baseDir, file.installPath);
@@ -138,13 +148,26 @@ function registerInstallCommand(program) {
                 }
                 // Create directory and write file
                 await promises_1.default.mkdir(fullDir, { recursive: true });
+                // Special handling for AGENTS.md - append/replace instead of overwrite
+                if (file.filename === 'AGENTS.md') {
+                    let existingContent = '';
+                    try {
+                        existingContent = await promises_1.default.readFile(fullPath, 'utf-8');
+                    }
+                    catch {
+                        // File doesn't exist, will create new
+                    }
+                    const agentRef = `${org}/${parsed.name}`;
+                    file.content = (0, agents_md_utils_1.mergeAgentsMdContent)(existingContent, file.content, agentRef);
+                }
                 await promises_1.default.writeFile(fullPath, file.content);
+                filesWritten++;
                 // Track installation
                 const installedAgent = {
                     agent: `${org}/${parsed.name}`,
                     version: parsed.version,
                     format: formatId,
-                    scope,
+                    scope: effectiveScope,
                     path: fullPath,
                     installedAt: new Date().toISOString(),
                     adapterVersion: adapter.version,
@@ -155,17 +178,23 @@ function registerInstallCommand(program) {
             }
         }
         if (!options.dryRun) {
-            await (0, analytics_1.track)('cli_agent_install', {
-                agent: `${org}/${parsed.name}`,
-                formats: targetFormats,
-                scope,
-            });
-            process.stdout.write(`\nAgent installed successfully!\n`);
-            if (scope === 'user') {
-                process.stdout.write(`Available in all your projects.\n`);
+            if (filesWritten > 0) {
+                await (0, analytics_1.track)('cli_agent_install', {
+                    agent: `${org}/${parsed.name}`,
+                    formats: targetFormats,
+                    scope,
+                });
+                process.stdout.write(`\nAgent installed successfully!\n`);
+                if (scope === 'user') {
+                    process.stdout.write(`Available in all your projects.\n`);
+                }
+                else {
+                    process.stdout.write(`Available in this project only.\n`);
+                }
             }
             else {
-                process.stdout.write(`Available in this project only.\n`);
+                process.stderr.write(`\nNo files were installed. Check warnings above.\n`);
+                process.exit(1);
             }
         }
     });

package/dist/commands/skill.js

@@ -178,7 +178,12 @@ Instructions and guidance for AI agents...
         else {
             const defaults = await (0, config_1.getDefaultFormats)();
             if (defaults.length > 0) {
-                targetFormats = defaults;
+                // Filter to formats that have skill directories
+                targetFormats = defaults.filter(f => config_1.VALID_FORMAT_IDS.includes(f));
+                const skipped = defaults.filter(f => !config_1.VALID_FORMAT_IDS.includes(f));
+                if (skipped.length > 0) {
+                    process.stderr.write(`Note: Skipping ${skipped.join(', ')} (no skill directory)\n`);
+                }
             }
         }
         // Determine target directories

package/dist/commands/update.js

@@ -12,6 +12,7 @@ const api_1 = require("../lib/api");
 const analytics_1 = require("../lib/analytics");
 const adapters_1 = require("../adapters");
 const installed_1 = require("../lib/installed");
+const agents_md_utils_1 = require("../lib/agents-md-utils");
 async function fetchLatestAgent(config, agentRef) {
     const [org, name] = agentRef.split('/');
     if (!org || !name)
@@ -97,12 +98,27 @@ function registerUpdateCommand(program) {
                     continue;
                 }
                 const files = adapter.convert(latest.agent);
+                if (files.length > 1) {
+                    process.stderr.write(`    Skipped: Multi-file adapters not supported for update. Reinstall instead.\n`);
+                    continue;
+                }
                 for (const file of files) {
                     // Use the original path from tracking
                     const fullPath = item.path;
                     try {
                         const dir = path_1.default.dirname(fullPath);
                         await promises_1.default.mkdir(dir, { recursive: true });
+                        // Special handling for AGENTS.md - append/replace instead of overwrite
+                        if (file.filename === 'AGENTS.md') {
+                            let existingContent = '';
+                            try {
+                                existingContent = await promises_1.default.readFile(fullPath, 'utf-8');
+                            }
+                            catch {
+                                // File doesn't exist, will create new
+                            }
+                            file.content = (0, agents_md_utils_1.mergeAgentsMdContent)(existingContent, file.content, item.agent);
+                        }
                         await promises_1.default.writeFile(fullPath, file.content);
                         // Update tracking
                         const updatedItem = {

package/dist/lib/agents-md-utils.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Utilities for handling AGENTS.md file updates
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeAgentsMdContent = mergeAgentsMdContent;
+const string_utils_1 = require("./string-utils");
+/**
+ * Merge new content into an existing AGENTS.md file.
+ *
+ * - If the agent's section already exists (identified by markers), replace it
+ * - If the file has content but no section for this agent, append
+ * - If the file is empty/new, use the new content as-is
+ *
+ * @param existingContent - Current content of AGENTS.md (empty string if file doesn't exist)
+ * @param newContent - New content to merge (should include orchagent markers)
+ * @param agentRef - Agent reference like "org/agent-name" used in markers
+ * @returns Merged content
+ */
+function mergeAgentsMdContent(existingContent, newContent, agentRef) {
+    const markerStart = `<!-- orchagent:${agentRef} -->`;
+    const markerEnd = `<!-- /orchagent:${agentRef} -->`;
+    if (existingContent.includes(markerStart)) {
+        // Replace existing section
+        const regex = new RegExp(`${(0, string_utils_1.escapeRegex)(markerStart)}[\\s\\S]*?${(0, string_utils_1.escapeRegex)(markerEnd)}`, 'g');
+        return existingContent.replace(regex, newContent.trim());
+    }
+    else if (existingContent.trim()) {
+        // Append to existing file
+        return existingContent.trimEnd() + '\n\n' + newContent;
+    }
+    // New file, use content as-is
+    return newContent;
+}

package/dist/lib/string-utils.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Shared string utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.escapeRegex = escapeRegex;
+/**
+ * Escape special regex characters in a string
+ */
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orchagent/cli",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Command-line interface for the orchagent AI agent marketplace",
   "license": "MIT",
   "author": "orchagent <hello@orchagent.io>",