@orchagent/cli 0.3.0 → 0.3.1

package/dist/adapters/claude-code.js

@@ -21,11 +21,12 @@ function mapModelToAlias(model) {
 }
 // Convert agent name to valid Claude Code name (lowercase + hyphens)
 function normalizeAgentName(name) {
-    return 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',

package/dist/adapters/cursor.js

@@ -3,11 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.cursorAdapter = void 0;
 // Convert agent name to valid filename (lowercase + hyphens)
 function normalizeAgentName(name) {
-    return name
+    const normalized = name
         .toLowerCase()
         .replace(/[^a-z0-9-]/g, '-')
         .replace(/-+/g, '-')
         .replace(/^-|-$/g, '');
+    return normalized || 'agent'; // Fallback if empty
 }
 exports.cursorAdapter = {
     id: 'cursor',

package/dist/commands/config.js

@@ -3,6 +3,7 @@ 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");
 const SUPPORTED_KEYS = ['default-format'];
 function isValidKey(key) {
     return SUPPORTED_KEYS.includes(key);
@@ -13,10 +14,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 all format IDs against adapter registry
+        const validFormatIds = adapters_1.adapterRegistry.getIds();
+        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/install.js

@@ -14,6 +14,9 @@ const analytics_1 = require("../lib/analytics");
 const adapters_1 = require("../adapters");
 const installed_1 = require("../lib/installed");
 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;
@@ -96,7 +99,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 +107,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,6 +127,14 @@ function registerInstallCommand(program) {
             for (const warn of checkResult.warnings) {
                 process.stdout.write(`Warning (${formatId}): ${warn}\n`);
             }
+            // Check if adapter supports requested scope
+            const supportedScopes = adapter.installPaths.map(p => p.scope);
+            if (!supportedScopes.includes(scope)) {
+                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];
+            }
             // Convert
             const files = adapter.convert(agent);
             // Determine base directory
@@ -138,7 +150,31 @@ 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}`;
+                    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
+                }
                 await promises_1.default.writeFile(fullPath, file.content);
+                filesWritten++;
                 // Track installation
                 const installedAgent = {
                     agent: `${org}/${parsed.name}`,
@@ -155,17 +191,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,9 @@ 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, '\\$&');
+}
 async function fetchLatestAgent(config, agentRef) {
     const [org, name] = agentRef.split('/');
     if (!org || !name)
@@ -97,12 +100,39 @@ 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
+                            }
+                            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
+                        }
                         await promises_1.default.writeFile(fullPath, file.content);
                         // Update tracking
                         const updatedItem = {

package/package.json

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