@orchagent/cli 0.3.1 → 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,30 +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) {
-    const normalized = name
-        .toLowerCase()
-        .replace(/[^a-z0-9-]/g, '-')
-        .replace(/-+/g, '-')
-        .replace(/^-|-$/g, '');
-    return normalized || 'agent'; // Fallback if empty
-}
 exports.claudeCodeAdapter = {
     id: 'claude-code',
     name: 'Claude Code Sub-Agent',
@@ -69,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,
@@ -78,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,15 +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) {
-    const normalized = name
-        .toLowerCase()
-        .replace(/[^a-z0-9-]/g, '-')
-        .replace(/-+/g, '-')
-        .replace(/^-|-$/g, '');
-    return normalized || 'agent'; // Fallback if empty
-}
+const utils_1 = require("./utils");
 exports.cursorAdapter = {
     id: 'cursor',
     name: 'Cursor Rules',
@@ -44,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

@@ -4,6 +4,12 @@ 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);
@@ -14,8 +20,8 @@ async function setConfigValue(key, value) {
     }
     if (key === 'default-format') {
         const formats = value.split(',').map((f) => f.trim()).filter(Boolean);
-        // Validate all format IDs against adapter registry
-        const validFormatIds = adapters_1.adapterRegistry.getIds();
+        // 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: ${validFormatIds.join(', ')}`);

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,10 +13,8 @@ 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 escapeRegex(str) {
-    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
 function parseAgentRef(value) {
     const [ref, versionPart] = value.split('@');
     const version = versionPart?.trim() || DEFAULT_VERSION;
@@ -127,18 +125,18 @@ function registerInstallCommand(program) {
             for (const warn of checkResult.warnings) {
                 process.stdout.write(`Warning (${formatId}): ${warn}\n`);
             }
-            // Check if adapter supports requested scope
+            // 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(scope)) {
+            if (!supportedScopes.includes(effectiveScope)) {
                 process.stderr.write(`Warning: ${adapter.name} doesn't support '${scope}' scope. ` +
                     `Supported: ${supportedScopes.join(', ')}. Using '${supportedScopes[0]}' instead.\n`);
-                // Use the first supported scope
-                scope = supportedScopes[0];
+                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);
@@ -160,18 +158,7 @@ function registerInstallCommand(program) {
                         // File doesn't exist, will create new
                     }
                     const agentRef = `${org}/${parsed.name}`;
-                    const markerStart = `<!-- orchagent:${agentRef} -->`;
-                    const markerEnd = `<!-- /orchagent:${agentRef} -->`;
-                    if (existingContent.includes(markerStart)) {
-                        // Replace existing section
-                        const regex = new RegExp(`${escapeRegex(markerStart)}[\\s\\S]*?${escapeRegex(markerEnd)}`, 'g');
-                        file.content = existingContent.replace(regex, file.content.trim());
-                    }
-                    else if (existingContent) {
-                        // Append to existing file
-                        file.content = existingContent.trimEnd() + '\n\n' + file.content;
-                    }
-                    // else: new file, use content as-is
+                    file.content = (0, agents_md_utils_1.mergeAgentsMdContent)(existingContent, file.content, agentRef);
                 }
                 await promises_1.default.writeFile(fullPath, file.content);
                 filesWritten++;
@@ -180,7 +167,7 @@ function registerInstallCommand(program) {
                     agent: `${org}/${parsed.name}`,
                     version: parsed.version,
                     format: formatId,
-                    scope,
+                    scope: effectiveScope,
                     path: fullPath,
                     installedAt: new Date().toISOString(),
                     adapterVersion: adapter.version,

package/dist/commands/update.js

@@ -12,9 +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");
-function escapeRegex(str) {
-    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
+const agents_md_utils_1 = require("../lib/agents-md-utils");
 async function fetchLatestAgent(config, agentRef) {
     const [org, name] = agentRef.split('/');
     if (!org || !name)
@@ -119,19 +117,7 @@ function registerUpdateCommand(program) {
                             catch {
                                 // File doesn't exist, will create new
                             }
-                            const agentRef = item.agent;
-                            const markerStart = `<!-- orchagent:${agentRef} -->`;
-                            const markerEnd = `<!-- /orchagent:${agentRef} -->`;
-                            if (existingContent.includes(markerStart)) {
-                                // Replace existing section
-                                const regex = new RegExp(`${escapeRegex(markerStart)}[\\s\\S]*?${escapeRegex(markerEnd)}`, 'g');
-                                file.content = existingContent.replace(regex, file.content.trim());
-                            }
-                            else if (existingContent) {
-                                // Append to existing file
-                                file.content = existingContent.trimEnd() + '\n\n' + file.content;
-                            }
-                            // else: new file, use content as-is
+                            file.content = (0, agents_md_utils_1.mergeAgentsMdContent)(existingContent, file.content, item.agent);
                         }
                         await promises_1.default.writeFile(fullPath, file.content);
                         // Update tracking

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.1",
+  "version": "0.3.2",
   "description": "Command-line interface for the orchagent AI agent marketplace",
   "license": "MIT",
   "author": "orchagent <hello@orchagent.io>",