agent-switchboard 0.1.25 → 0.1.27

package/dist/index.js

@@ -16,14 +16,14 @@ import { importCommandFromFile } from './commands/importer.js';
 import { buildCommandInventory } from './commands/inventory.js';
 import { resolveAgentSectionConfig } from './config/agent-config.js';
 import { loadMcpConfig, stripLegacyEnabledFlagsFromMcpJson } from './config/mcp-config.js';
-import { getAgentsHome, getClaudeDir, getCodexDir, getCommandsDir, getCursorDir, getGeminiDir, getOpencodePath, getSkillsDir, getSubagentsDir, } from './config/paths.js';
+import { getAgentsHome, getClaudeDir, getCodexDir, getCommandsDir, getCursorDir, getGeminiDir, getOpencodePath, getSkillsDir, getSourceCacheDir, getSubagentsDir, } from './config/paths.js';
 import { loadSwitchboardConfig, loadSwitchboardConfigWithLayers, } from './config/switchboard-config.js';
 import { ensureLibraryDirectories, writeFileSecure } from './library/fs.js';
+import { addLocalSource, addRemoteSource, getSources, inferSourceName, isGitUrl, parseGitUrl, removeSource, updateRemoteSources, validateSourcePath, } from './library/sources.js';
 import { loadMcpActiveState, saveMcpActiveState } from './library/state.js';
-import { addSubscription, getSubscriptions, removeSubscription, validateSubscriptionPath, } from './library/subscriptions.js';
 import { RULE_SUPPORTED_AGENTS } from './rules/agents.js';
 import { composeActiveRules } from './rules/composer.js';
-import { distributeRules, listIndirectAgents, listUnsupportedAgents, } from './rules/distribution.js';
+import { distributeRules, listIndirectAgents, listPerFileAgents, listUnsupportedAgents, } from './rules/distribution.js';
 import { buildRuleInventory } from './rules/inventory.js';
 import { loadRuleLibrary } from './rules/library.js';
 import { loadRuleState, updateRuleState } from './rules/state.js';
@@ -44,8 +44,17 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const packageJson = JSON.parse(fs.readFileSync(path.join(__dirname, '../package.json'), 'utf-8'));
 program
     .name('asb')
-    .description('Unified MCP server manager for AI coding agents')
-    .version(packageJson.version);
+    .description('Manage MCP servers, rules, commands, subagents, and skills across AI coding agents')
+    .version(packageJson.version)
+    .addHelpText('after', `
+Examples:
+  $ asb mcp                          Enable/disable MCP servers interactively
+  $ asb rule                         Select and order rule snippets
+  $ asb sync                         Push all libraries to every active agent
+  $ asb sync --project .             Sync with project-level overrides
+
+Alias: agent-switchboard
+Config: ~/.agent-switchboard/config.toml`);
 // Initialize library directories for commands/subagents (secure permissions)
 ensureLibraryDirectories();
 program
@@ -53,6 +62,7 @@ program
     .description('Synchronize active MCP servers, rules, commands, subagents, and skills to agent targets')
     .option('-p, --profile <name>', 'Profile configuration to use')
     .option('--project <path>', 'Project directory containing .asb.toml')
+    .option('--no-update', 'Skip updating remote sources')
     .action(async (options) => {
     try {
         const scope = resolveScope(options);
@@ -62,6 +72,21 @@ program
         console.log(`${chalk.bgRed.white(' WARNING ')} ${chalk.red('`asb sync` overwrites target files without diff checks.')}`);
         console.log(chalk.red('Proceeding with synchronization...'));
         console.log();
+        if (options.update !== false) {
+            const remoteResults = updateRemoteSources();
+            if (remoteResults.length > 0) {
+                console.log(chalk.blue('Remote source updates:'));
+                for (const result of remoteResults) {
+                    if (result.status === 'updated') {
+                        console.log(`  ${chalk.green('✓')} ${chalk.cyan(result.namespace)} ${chalk.dim(result.url)}`);
+                    }
+                    else {
+                        console.log(`  ${chalk.yellow('⚠')} ${chalk.cyan(result.namespace)} ${chalk.yellow(result.error ?? 'update failed')}`);
+                    }
+                }
+                console.log();
+            }
+        }
         console.log(chalk.blue('Configuration layers:'));
         const layerEntries = [
             { label: 'User', exists: layers.user.exists, path: layers.user.path },
@@ -335,7 +360,7 @@ program
 });
 const ruleCommand = program
     .command('rule')
-    .description('Manage rule snippets and synchronization')
+    .description('Select and order rule snippets interactively, then sync to agents')
     .option('-p, --profile <name>', 'Profile configuration to use')
     .option('--project <path>', 'Project directory containing .asb.toml');
 ruleCommand
@@ -396,6 +421,10 @@ ruleCommand
             console.log();
             console.log(chalk.gray(`Unsupported agents (manual update required): ${unsupportedAgents.join(', ')}`));
         }
+        const perFileAgents = listPerFileAgents();
+        if (perFileAgents.length > 0) {
+            console.log(chalk.gray(`Per-file rules (.mdc): ${perFileAgents.join(', ')}`));
+        }
         const indirectAgents = listIndirectAgents();
         if (indirectAgents.length > 0) {
             console.log(chalk.gray(`Indirect rules support (reads CLAUDE.md + AGENTS.md): ${indirectAgents.join(', ')}`));
@@ -474,6 +503,10 @@ ruleCommand.action(async (options) => {
             console.log();
             console.log(chalk.gray(`Unsupported agents (manual update required): ${unsupportedAgents.join(', ')}`));
         }
+        const perFileAgents = listPerFileAgents();
+        if (perFileAgents.length > 0) {
+            console.log(chalk.gray(`Per-file rules (.mdc): ${perFileAgents.join(', ')}`));
+        }
         const indirectAgents = listIndirectAgents();
         if (indirectAgents.length > 0) {
             console.log(chalk.gray(`Indirect rules support (reads CLAUDE.md + AGENTS.md): ${indirectAgents.join(', ')}`));
@@ -489,7 +522,7 @@ ruleCommand.action(async (options) => {
 // Commands library: manage and distribute commands
 const commandRoot = program
     .command('command')
-    .description('Manage command library')
+    .description('Select slash commands interactively and distribute to agents')
     .option('-p, --profile <name>', 'Profile configuration to use')
     .option('--project <path>', 'Project directory containing .asb.toml');
 commandRoot.action(async (options) => {
@@ -638,7 +671,7 @@ commandRoot
 // Subagents library: scaffold, load, list, and interactive distribute
 const subagentRoot = program
     .command('subagent')
-    .description('Manage subagent (persona) library')
+    .description('Select subagent definitions interactively and distribute to agents')
     .option('-p, --profile <name>', 'Profile configuration to use')
     .option('--project <path>', 'Project directory containing .asb.toml');
 subagentRoot.action(async (options) => {
@@ -671,6 +704,62 @@ subagentRoot.action(async (options) => {
         process.exit(1);
     }
 });
+subagentRoot
+    .command('load')
+    .description('Import existing platform files into the subagent library')
+    .argument('<platform>', 'claude-code | opencode | cursor')
+    .argument('[path]', 'Source file or directory (defaults by platform)')
+    .option('-r, --recursive', 'When [path] is a directory, import files recursively')
+    .option('-f, --force', 'Overwrite existing library files without confirmation')
+    .action(async (platform, srcPath, opts) => {
+    try {
+        const exts = ['.md', '.markdown'];
+        const source = srcPath && srcPath.trim().length > 0 ? srcPath : defaultSubagentSourceDir(platform);
+        if (!fs.existsSync(source)) {
+            console.error(chalk.red(`\n✗ Source not found: ${source}`));
+            process.exit(1);
+        }
+        const inputs = [];
+        if (isFile(source)) {
+            inputs.push(source);
+        }
+        else if (isDir(source)) {
+            if (!opts.recursive) {
+                console.error(chalk.red('\n✗ Source is a directory. Use -r/--recursive to import recursively.'));
+                process.exit(1);
+            }
+            inputs.push(...listFilesRecursively(source, exts));
+        }
+        if (inputs.length === 0) {
+            console.log(chalk.yellow('\n⚠ No files to import.'));
+            return;
+        }
+        const outDir = getSubagentsDir();
+        let imported = 0;
+        for (const file of inputs) {
+            try {
+                const { slug, content } = importSubagentFromFile(platform, file);
+                const target = path.join(outDir, `${slug}.md`);
+                if (!(await confirmOverwrite(target, opts.force)))
+                    continue;
+                writeFileSecure(target, content);
+                imported++;
+                console.log(`${chalk.green('✓')} ${chalk.cyan(slug)} → ${chalk.dim(target)}`);
+            }
+            catch (error) {
+                const msg = error instanceof Error ? error.message : String(error);
+                console.log(`${chalk.red('✗')} ${chalk.dim(file)} ${chalk.red(msg)}`);
+            }
+        }
+        console.log(`\n${chalk.green('✓')} Imported ${imported} file(s) into subagent library.`);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error(chalk.red(`\n✗ Error: ${error.message}`));
+        }
+        process.exit(1);
+    }
+});
 subagentRoot
     .command('list')
     .description('Display subagent inventory and sync information')
@@ -728,66 +817,10 @@ subagentRoot
         process.exit(1);
     }
 });
-subagentRoot
-    .command('load')
-    .description('Import existing platform files into the subagent library')
-    .argument('<platform>', 'claude-code | opencode | cursor')
-    .argument('[path]', 'Source file or directory (defaults by platform)')
-    .option('-r, --recursive', 'When [path] is a directory, import files recursively')
-    .option('-f, --force', 'Overwrite existing library files without confirmation')
-    .action(async (platform, srcPath, opts) => {
-    try {
-        const exts = ['.md', '.markdown'];
-        const source = srcPath && srcPath.trim().length > 0 ? srcPath : defaultSubagentSourceDir(platform);
-        if (!fs.existsSync(source)) {
-            console.error(chalk.red(`\n✗ Source not found: ${source}`));
-            process.exit(1);
-        }
-        const inputs = [];
-        if (isFile(source)) {
-            inputs.push(source);
-        }
-        else if (isDir(source)) {
-            if (!opts.recursive) {
-                console.error(chalk.red('\n✗ Source is a directory. Use -r/--recursive to import recursively.'));
-                process.exit(1);
-            }
-            inputs.push(...listFilesRecursively(source, exts));
-        }
-        if (inputs.length === 0) {
-            console.log(chalk.yellow('\n⚠ No files to import.'));
-            return;
-        }
-        const outDir = getSubagentsDir();
-        let imported = 0;
-        for (const file of inputs) {
-            try {
-                const { slug, content } = importSubagentFromFile(platform, file);
-                const target = path.join(outDir, `${slug}.md`);
-                if (!(await confirmOverwrite(target, opts.force)))
-                    continue;
-                writeFileSecure(target, content);
-                imported++;
-                console.log(`${chalk.green('✓')} ${chalk.cyan(slug)} → ${chalk.dim(target)}`);
-            }
-            catch (error) {
-                const msg = error instanceof Error ? error.message : String(error);
-                console.log(`${chalk.red('✗')} ${chalk.dim(file)} ${chalk.red(msg)}`);
-            }
-        }
-        console.log(`\n${chalk.green('✓')} Imported ${imported} file(s) into subagent library.`);
-    }
-    catch (error) {
-        if (error instanceof Error) {
-            console.error(chalk.red(`\n✗ Error: ${error.message}`));
-        }
-        process.exit(1);
-    }
-});
 // Skills library: manage and distribute skill bundles
 const skillRoot = program
     .command('skill')
-    .description('Manage skill library')
+    .description('Select skill bundles interactively and distribute to agents')
     .option('-p, --profile <name>', 'Profile configuration to use')
     .option('--project <path>', 'Project directory containing .asb.toml');
 skillRoot.action(async (options) => {
@@ -1007,25 +1040,64 @@ function showSummary(selectedServers, scope) {
     }
     console.log();
 }
-// Library subscription commands
-program
-    .command('subscribe')
-    .description('Add a library subscription with a namespace')
-    .argument('<name>', 'Namespace for this subscription (e.g., "team", "project")')
-    .argument('<path>', 'Path to the library directory')
-    .action((name, libraryPath) => {
+// Library source management commands
+const sourceRoot = program
+    .command('source')
+    .description('Manage external library sources (local paths or git repos)');
+sourceRoot
+    .command('add')
+    .description('Add a library source (local path or git URL)')
+    .argument('<location>', 'Local path or git URL (e.g., https://github.com/org/repo)')
+    .argument('[name]', 'Namespace (defaults to repo or directory name)')
+    .action((location, nameArg) => {
     try {
-        // Validate the path has library structure
-        const validation = validateSubscriptionPath(libraryPath);
-        if (!validation.valid) {
-            console.error(chalk.red(`\n✗ Path does not contain any library folders (rules/, commands/, subagents/, skills/).`));
-            process.exit(1);
+        const name = nameArg ?? inferSourceName(location);
+        if (isGitUrl(location)) {
+            const parsed = parseGitUrl(location);
+            const spinner = ora(`Cloning ${parsed.url}...`).start();
+            try {
+                addRemoteSource(name, {
+                    url: parsed.url,
+                    ref: parsed.ref,
+                    subdir: parsed.subdir,
+                });
+                spinner.succeed(chalk.green(`✓ Cloned ${parsed.url}`));
+            }
+            catch (err) {
+                spinner.fail(chalk.red('Failed to clone'));
+                throw err;
+            }
+            let effectivePath = getSourceCacheDir(name);
+            if (parsed.subdir)
+                effectivePath = path.join(effectivePath, parsed.subdir);
+            const validation = validateSourcePath(effectivePath);
+            if (!validation.valid) {
+                removeSource(name);
+                console.error(chalk.red('\n✗ Cloned repository does not contain any library folders (rules/, commands/, subagents/, skills/).'));
+                process.exit(1);
+            }
+            console.log(chalk.green(`\n✓ Added source "${name}" from ${parsed.url}`));
+            if (parsed.ref)
+                console.log(chalk.dim(`  Ref: ${parsed.ref}`));
+            if (parsed.subdir)
+                console.log(chalk.dim(`  Subdir: ${parsed.subdir}`));
+            console.log(chalk.dim(`  Found: ${validation.found.join(', ')}`));
+            if (validation.missing.length > 0) {
+                console.log(chalk.dim(`  Missing: ${validation.missing.join(', ')}`));
+            }
         }
-        addSubscription(name, libraryPath);
-        console.log(chalk.green(`\n✓ Subscribed to "${name}" at ${path.resolve(libraryPath)}`));
-        console.log(chalk.dim(`  Found: ${validation.found.join(', ')}`));
-        if (validation.missing.length > 0) {
-            console.log(chalk.dim(`  Missing: ${validation.missing.join(', ')}`));
+        else {
+            const validation = validateSourcePath(location);
+            if (!validation.valid) {
+                console.error(chalk.red('\n✗ Path does not contain any library folders (rules/, commands/, subagents/, skills/).'));
+                process.exit(1);
+            }
+            addLocalSource(name, location);
+            console.log(chalk.green(`\n✓ Added source "${name}" at ${path.resolve(location)}`));
+            console.log(chalk.dim(`  Found: ${validation.found.join(', ')}`));
+            if (validation.missing.length > 0) {
+                console.log(chalk.dim(`  Missing: ${validation.missing.join(', ')}`));
+            }
         }
         console.log();
         console.log(chalk.dim('Library entries will now use the namespace prefix, e.g., ') +
@@ -1038,14 +1110,21 @@ program
         process.exit(1);
     }
 });
-program
-    .command('unsubscribe')
-    .description('Remove a library subscription by namespace')
+sourceRoot
+    .command('remove')
+    .description('Remove a library source by namespace')
     .argument('<name>', 'Namespace to remove')
     .action((name) => {
     try {
-        removeSubscription(name);
-        console.log(chalk.green(`\n✓ Unsubscribed from "${name}"`));
+        const sources = getSources();
+        const source = sources.find((s) => s.namespace === name);
+        removeSource(name);
+        if (source?.remote) {
+            console.log(chalk.green(`\n✓ Removed source "${name}" and cleaned up cache`));
+        }
+        else {
+            console.log(chalk.green(`\n✓ Removed source "${name}"`));
+        }
     }
     catch (error) {
         if (error instanceof Error) {
@@ -1054,32 +1133,45 @@ program
         process.exit(1);
     }
 });
-program
-    .command('subscriptions')
-    .description('List all library subscriptions')
+sourceRoot
+    .command('list')
+    .description('List all library sources')
     .option('--json', 'Output as JSON')
     .action((options) => {
     try {
-        const subscriptions = getSubscriptions();
+        const sources = getSources();
         if (options.json) {
-            console.log(JSON.stringify(subscriptions, null, 2));
+            console.log(JSON.stringify(sources, null, 2));
             return;
         }
-        if (subscriptions.length === 0) {
-            console.log(chalk.yellow('\n⚠ No library subscriptions configured.'));
-            console.log(chalk.dim('  Use `asb subscribe <name> <path>` to add one.'));
+        if (sources.length === 0) {
+            console.log(chalk.yellow('\n⚠ No library sources configured.'));
+            console.log(chalk.dim('  Use `asb source add <location> [name]` to add one.'));
             return;
         }
-        console.log(chalk.blue('\nLibrary subscriptions:'));
-        const header = ['Namespace', 'Path', 'Status', 'Contains'];
-        const rows = subscriptions.map((sub) => {
-            const exists = fs.existsSync(sub.path);
-            const validation = exists ? validateSubscriptionPath(sub.path) : { found: [], missing: [] };
-            const statusPlain = exists ? 'ok' : 'missing';
+        console.log(chalk.blue('\nLibrary sources:'));
+        const header = ['Namespace', 'Type', 'Source', 'Status', 'Contains'];
+        const rows = sources.map((src) => {
+            const isRemote = !!src.remote;
+            const typePlain = isRemote ? 'remote' : 'local';
+            const sourcePlain = isRemote ? (src.remote?.url ?? src.path) : src.path;
+            const exists = fs.existsSync(src.path);
+            const validation = exists ? validateSourcePath(src.path) : { found: [], missing: [] };
+            let statusPlain;
+            if (isRemote) {
+                statusPlain = exists ? 'cached' : 'not cached';
+            }
+            else {
+                statusPlain = exists ? 'ok' : 'missing';
+            }
             const containsPlain = validation.found.length > 0 ? validation.found.join(', ') : '-';
             return [
-                { plain: sub.namespace, formatted: chalk.cyan(sub.namespace) },
-                { plain: sub.path, formatted: chalk.dim(sub.path) },
+                { plain: src.namespace, formatted: chalk.cyan(src.namespace) },
+                {
+                    plain: typePlain,
+                    formatted: isRemote ? chalk.blue(typePlain) : chalk.gray(typePlain),
+                },
+                { plain: sourcePlain, formatted: chalk.dim(sourcePlain) },
                 {
                     plain: statusPlain,
                     formatted: exists ? chalk.green(statusPlain) : chalk.red(statusPlain),
@@ -1097,5 +1189,8 @@ program
         process.exit(1);
     }
 });
+sourceRoot.action(() => {
+    sourceRoot.commands.find((c) => c.name() === 'list')?.parse(process.argv);
+});
 program.parse(process.argv);
 //# sourceMappingURL=index.js.map