@michaelhartmayer/agentctl 1.1.0 → 1.1.3

package/dist/src/index.js

@@ -1,351 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const commander_1 = require("commander");
-const path_1 = __importDefault(require("path"));
-require("fs-extra");
-const ctl_1 = require("./ctl");
-const resolve_1 = require("./resolve");
-const child_process_1 = require("child_process");
-const chalk_1 = __importDefault(require("chalk"));
-const program = new commander_1.Command();
-const package_json_1 = __importDefault(require("../package.json"));
-program
-    .name('agentctl')
-    .description('Agent Controller CLI - Unified control plane for humans and agents')
-    .version(package_json_1.default.version)
-    .allowUnknownOption()
-    .helpOption(false) // Disable default help to allow pass-through
-    .argument('[command...]', 'Command to run')
-    .action(async (args, _options, _command) => {
-    // If no args, check for help flag or just show help
-    if (!args || args.length === 0) {
-        // If they passed --help or -h, show help. If no args at all, show help.
-        // Since we ate options, we check raw args or just treat empty args as help.
-        // command.opts() won't have help if we disabled it? 
-        // Actually, if we disable helpOption, --help becomes an unknown option or arg.
-        // Let's check process.argv for -h or --help if args is empty?
-        // "agentctl --help" -> args=[], options might contain help if we didn't disable it?
-        // With helpOption(false), --help is just a flag in argv.
-        // If args is empty and we see help flag, show help.
-        if (process.argv.includes('--help') || process.argv.includes('-h') || process.argv.length <= 2) {
-            program.help();
-            return;
-        }
-    }
-    // If args are present, we try to resolve.
-    // BUT, "agentctl --help" will result in args being empty if it's parsed as option?
-    // Wait, if helpOption(false), then --help is an unknown option.
-    // If allowUnknownOption is true, it might not be in 'args' if it looks like a flag.
-    // Let's rely on resolveCommand. passed args are variadic.
-    // However, "agentctl dev --help" -> args=["dev", "--help"]? 
-    // My repro says yes: [ 'dev-tools', 'gh', '--help' ].
-    // So for "agentctl --help", args might be ["--help"].
-    if (args.length === 1 && (args[0] === '--help' || args[0] === '-h')) {
-        program.help();
-        return;
-    }
-    // Bypass for ctl subcommand if it slipped through (shouldn't if registered)
-    if (args[0] === 'ctl')
-        return;
-    try {
-        // resolveCommand needs to handle flags in args if they are part of the path?
-        // No, flags usually come after. resolveCommand stops at first non-matching path part?
-        // resolveCommand logic: iterates args.
-        // "dev-tools gh --help" -> path "dev-tools gh", remaining "--help"
-        const result = await (0, resolve_1.resolveCommand)(args);
-        if (!result) {
-            // If not found, and they asked for help, show root help?
-            // Or if they just typed a wrong command.
-            if (args.includes('--help') || args.includes('-h')) {
-                // Try to show help for the partial command? 
-                // For now, just show root list/help or error.
-                // If it's "agentctl dev --help" and "dev" is a group, resolveCommand SHOULD return the group.
-            }
-            console.error(chalk_1.default.red(`Command '${args.join(' ')}' not found.`));
-            console.log(`Run ${chalk_1.default.cyan('agentctl list')} to see available commands.`);
-            process.exit(1);
-        }
-        const { manifest, args: remainingArgs, scope } = result;
-        if (manifest.run) {
-            // ... run logic ...
-            // remainingArgs should contain --help if it was passed.
-            const cmdDir = path_1.default.dirname(result.manifestPath);
-            let runCmd = manifest.run;
-            // Resolve relative path
-            if (runCmd.startsWith('./') || runCmd.startsWith('.\\')) {
-                runCmd = path_1.default.resolve(cmdDir, runCmd);
-            }
-            // Interpolate {{DIR}}
-            runCmd = runCmd.replace(/{{DIR}}/g, cmdDir);
-            const fullCommand = `${runCmd} ${remainingArgs.join(' ')}`;
-            console.log(chalk_1.default.dim(`[${scope}] Running: ${fullCommand}`));
-            const child = (0, child_process_1.spawn)(fullCommand, {
-                cwd: process.cwd(), // Execute in CWD as discussed
-                shell: true,
-                stdio: 'inherit',
-                env: { ...process.env, AGENTCTL_SCOPE: scope }
-            });
-            child.on('exit', (code) => {
-                process.exit(code || 0);
-            });
-        }
-        else {
-            // Group
-            console.log(chalk_1.default.blue(chalk_1.default.bold(`${manifest.name}`)));
-            console.log(manifest.description || 'No description');
-            console.log('\nSubcommands:');
-            const all = await (0, ctl_1.list)();
-            const prefix = result.cmdPath + ' ';
-            // Filter logic roughly for direct children
-            const depth = result.cmdPath.split(' ').length;
-            const children = all.filter(c => c.path.startsWith(prefix) && c.path !== result.cmdPath);
-            const direct = children.filter(c => c.path.split(' ').length === depth + 1);
-            if (direct.length === 0 && children.length === 0) {
-                console.log(chalk_1.default.dim('  (No subcommands found)'));
-            }
-            for (const child of direct) {
-                console.log(`  ${child.path.split(' ').pop()}\t${chalk_1.default.dim(child.description)}`);
-            }
-        }
-    }
-    catch (e) {
-        if (e instanceof Error) {
-            console.error(chalk_1.default.red(e.message));
-        }
-        else {
-            console.error(chalk_1.default.red('An unknown error occurred'));
-        }
-        process.exit(1);
-    }
-});
-const ctl = program.command('ctl')
-    .description('Agent Controller Management - Create, organize, and manage commands');
-// --- Lifecycle Commands ---
-// We'll stick to flat list but with good descriptions.
-// Helper for consistent error handling
-// Helper for consistent error handling
-const withErrorHandling = (fn) => {
-    return async (...args) => {
-        try {
-            await fn(...args);
-        }
-        catch (e) {
-            if (e instanceof Error) {
-                console.error(chalk_1.default.red(e.message));
-            }
-            else {
-                console.error(chalk_1.default.red(String(e)));
-            }
-            process.exit(1);
-        }
-    };
-};
-ctl.command('scaffold')
-    .description('Scaffold a new command script (creates a manifest and a .sh/.cmd file)')
-    .argument('[path...]', 'The hierarchical path for the new command (e.g. "dev start")')
-    .addHelpText('after', `
-Description:
-  Scaffolding creates a new directory for your command containing a 'manifest.json' 
-  and a boilerplate script file (.sh on Linux/Mac, .cmd on Windows).
-  You can then edit the script to add your own logic.
-
-Examples:
-  $ agentctl ctl scaffold dev start
-  $ agentctl ctl scaffold utils/backup
-`)
-    .action(withErrorHandling(async (pathParts, _options, command) => {
-    if (!pathParts || pathParts.length === 0) {
-        command.help();
-        return;
-    }
-    await (0, ctl_1.scaffold)(pathParts);
-}));
-ctl.command('alias')
-    .description('Create an alias command that executes a shell string')
-    .argument('[path_and_cmd...]', 'Hierarchical path segments followed by the shell command')
-    .action(withErrorHandling(async (args, _options, command) => {
-    if (!args || args.length < 2) {
-        command.help();
-        return;
-    }
-    const target = args.pop();
-    const name = args;
-    await (0, ctl_1.alias)(name, target);
-}))
-    .addHelpText('after', `
-How it works:
-  The last argument is always treated as the shell command to execute. 
-  All preceding arguments form the hierarchical path.
-
-  If the shell command contains spaces, wrap it in quotes.
-
-Examples:
-  $ agentctl ctl alias tools git-status "git status"
-    -> Creates 'agentctl tools git-status' which runs 'git status'.
-
-  $ agentctl ctl alias dev build "npm run build"
-    -> Creates 'agentctl dev build' which runs 'npm run build'.
-`);
-ctl.command('group')
-    .description('Create a command group (namespace) to organize related commands')
-    .argument('[path...]', 'Hierarchical path for the group (e.g. "dev")')
-    .addHelpText('after', `
-Description:
-  Groups are essentially folders that contain other commands. 
-  They don't execute anything themselves but provide organization.
-
-Examples:
-  $ agentctl ctl group dev
-  $ agentctl ctl group tools/internal
-`)
-    .action(withErrorHandling(async (parts, _options, command) => {
-    if (!parts || parts.length === 0) {
-        command.help();
-        return;
-    }
-    await (0, ctl_1.group)(parts);
-}));
-ctl.command('rm')
-    .description('Remove a command or group permanently')
-    .argument('[path...]', 'Command path to remove')
-    .option('--global', 'Remove from global scope')
-    .addHelpText('after', `
-Examples:
-  $ agentctl ctl rm dev start
-  $ agentctl ctl rm tools --global
-`)
-    .action(withErrorHandling(async (parts, opts, command) => {
-    if (!parts || parts.length === 0) {
-        command.help();
-        return;
-    }
-    await (0, ctl_1.rm)(parts, { global: opts.global });
-}));
-ctl.command('mv')
-    .description('Move or rename a command or group')
-    .argument('[src]', 'Current path of the command')
-    .argument('[dest]', 'New path for the command')
-    .option('--global', 'Perform operation in global scope')
-    .addHelpText('after', `
-Examples:
-  $ agentctl ctl mv "dev start" "dev boot"
-  $ agentctl ctl mv tools/gh tools/github --global
-`)
-    .action(withErrorHandling(async (src, dest, opts, command) => {
-    if (!src || !dest) {
-        command.help();
-        return;
-    }
-    await (0, ctl_1.mv)(src.split(' '), dest.split(' '), { global: opts.global });
-}));
-// --- Introspection ---
-ctl.command('list')
-    .description('List all available commands across local and global scopes')
-    .action(withErrorHandling(async () => {
-    const items = await (0, ctl_1.list)();
-    console.log('TYPE      SCOPE     COMMAND             DESCRIPTION');
-    for (const item of items) {
-        console.log(`${item.type.padEnd(9)} ${item.scope.padEnd(9)} ${item.path.padEnd(19)} ${item.description}`);
-    }
-}));
-ctl.command('inspect')
-    .description('Inspect the internal manifest and details of a command')
-    .argument('[path...]', 'Command path to inspect')
-    .action(withErrorHandling(async (parts, _options, command) => {
-    if (!parts || parts.length === 0) {
-        command.help();
-        return;
-    }
-    const info = await (0, ctl_1.inspect)(parts);
-    if (info) {
-        console.log(JSON.stringify(info, null, 2));
-    }
-    else {
-        console.error('Command not found');
-        process.exit(1);
-    }
-}));
-// --- Scoping ---
-ctl.command('global')
-    .description('Push a local command to the global scope')
-    .argument('[path...]', 'Local command path')
-    .option('--move', 'Move instead of copy')
-    .option('--copy', 'Copy (default)')
-    .addHelpText('after', `
-Examples:
-  $ agentctl ctl global sys --move
-  $ agentctl ctl global tools --copy
-`)
-    .action(withErrorHandling(async (parts, opts, command) => {
-    if (!parts || parts.length === 0) {
-        command.help();
-        return;
-    }
-    await (0, ctl_1.pushGlobal)(parts, { move: opts.move, copy: opts.copy || !opts.move });
-}));
-ctl.command('local')
-    .description('Pull a global command to the local scope')
-    .argument('[path...]', 'Global command path')
-    .option('--move', 'Move instead of copy')
-    .option('--copy', 'Copy (default)')
-    .addHelpText('after', `
-Examples:
-  $ agentctl ctl local tools --copy
-`)
-    .action(withErrorHandling(async (parts, opts, command) => {
-    if (!parts || parts.length === 0) {
-        command.help();
-        return;
-    }
-    await (0, ctl_1.pullLocal)(parts, { move: opts.move, copy: opts.copy || !opts.move });
-}));
-// --- Agent Integration ---
-// We attach this to the root `ctl` as options or a sub-command? 
-// Original code had it as options on `ctl`. We can make it a command for better help.
-// But sticking to options maintains compatibility. We'll improve the option help.
-ctl.option('--install-skill <agent>', 'Install skill for agent (cursor, antigravity, agentsmd, gemini)')
-    .option('--global', 'Install skill globally (for supported agents)')
-    .addHelpText('after', `
-Examples:
-  $ agentctl ctl --install-skill cursor
-  $ agentctl ctl --install-skill antigravity --global
-  $ agentctl ctl --install-skill gemini
-`)
-    .action(withErrorHandling(async (op, command) => {
-    const opts = ctl.opts();
-    if (opts.installSkill) {
-        await (0, ctl_1.installSkill)(opts.installSkill, { global: opts.global });
-    }
-    else {
-        // If no subcmd and no option, show help
-        if (command.args.length === 0) {
-            ctl.help();
-        }
-    }
-}));
-// Inject dynamic commands into root help
-// We need to do this before parsing
-(async () => {
-    try {
-        const allCommands = await (0, ctl_1.list)();
-        const topLevel = allCommands.filter(c => !c.path.includes(' ')); // Only top level
-        if (topLevel.length > 0) {
-            const lines = [''];
-            lines.push('User Commands:');
-            for (const cmd of topLevel) {
-                // simple padding
-                lines.push(`  ${cmd.path.padEnd(27)}${cmd.description}`);
-            }
-            lines.push('');
-            program.addHelpText('after', lines.join('\n'));
-        }
-    }
-    catch {
-        // Ignore errors during help generation (e.g. if not initialized)
-    }
-    program.parse(process.argv);
-})();

package/dist/src/manifest.js

@@ -1,19 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.readManifest = readManifest;
-exports.isCappedManifest = isCappedManifest;
-const fs_extra_1 = __importDefault(require("fs-extra"));
-async function readManifest(p) {
-    try {
-        return await fs_extra_1.default.readJson(p);
-    }
-    catch {
-        return null;
-    }
-}
-function isCappedManifest(m) {
-    return !!m.run || m.type === 'scaffold' || m.type === 'alias';
-}

package/dist/src/resolve.js

@@ -1,112 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveCommand = resolveCommand;
-const path_1 = __importDefault(require("path"));
-const fs_extra_1 = __importDefault(require("fs-extra"));
-const fs_utils_1 = require("./fs-utils");
-const manifest_1 = require("./manifest");
-async function resolveCommand(args, options = {}) {
-    const cwd = options.cwd || process.cwd();
-    const localRoot = !options.global ? (0, fs_utils_1.findLocalRoot)(cwd) : null;
-    const globalRoot = options.globalDir || (0, fs_utils_1.getGlobalRoot)();
-    const localAgentctl = localRoot ? path_1.default.join(localRoot, '.agentctl') : null;
-    let currentMatch = null;
-    // Iterate through args to find longest match
-    for (let i = 0; i < args.length; i++) {
-        // Path corresponding to args[0..i]
-        const currentArgs = args.slice(0, i + 1);
-        const relPath = currentArgs.join(path_1.default.sep);
-        const cmdPath = currentArgs.join(' ');
-        const localPath = localAgentctl ? path_1.default.join(localAgentctl, relPath) : null;
-        const globalPath = path_1.default.join(globalRoot, relPath);
-        let localManifest = null;
-        let globalManifest = null;
-        // check local
-        if (localPath && await fs_extra_1.default.pathExists(localPath)) {
-            const mPath = path_1.default.join(localPath, 'manifest.json');
-            if (await fs_extra_1.default.pathExists(mPath)) {
-                localManifest = await (0, manifest_1.readManifest)(mPath);
-            }
-            if (!localManifest && (await fs_extra_1.default.stat(localPath)).isDirectory()) {
-                // Implicit group
-                localManifest = { name: args[i], type: 'group' };
-            }
-        }
-        // check global
-        if (await fs_extra_1.default.pathExists(globalPath)) {
-            const mPath = path_1.default.join(globalPath, 'manifest.json');
-            if (await fs_extra_1.default.pathExists(mPath)) {
-                globalManifest = await (0, manifest_1.readManifest)(mPath);
-            }
-            if (!globalManifest && (await fs_extra_1.default.stat(globalPath)).isDirectory()) {
-                globalManifest = { name: args[i], type: 'group' };
-            }
-        }
-        if (!localManifest && !globalManifest) {
-            break;
-        }
-        const remainingArgs = args.slice(i + 1);
-        // Priority logic
-        // 1. Local Capped -> Return Match immediately.
-        if (localManifest && (0, manifest_1.isCappedManifest)(localManifest)) {
-            return {
-                manifest: localManifest,
-                manifestPath: path_1.default.join(localPath, 'manifest.json'),
-                args: remainingArgs,
-                scope: 'local',
-                cmdPath
-            };
-        }
-        // 2. Global Capped
-        if (globalManifest && (0, manifest_1.isCappedManifest)(globalManifest)) {
-            // Check if shadowed by Local Group
-            if (localManifest) {
-                // Local exists (must be group since checked capped above).
-                // Shadowed. Treat as Local Group.
-                currentMatch = {
-                    manifest: localManifest,
-                    manifestPath: path_1.default.join(localPath, 'manifest.json'),
-                    args: remainingArgs,
-                    scope: 'local',
-                    cmdPath
-                };
-            }
-            else {
-                // Not shadowed. Global Capped wins. Return immediately.
-                return {
-                    manifest: globalManifest,
-                    manifestPath: path_1.default.join(globalPath, 'manifest.json'),
-                    args: remainingArgs,
-                    scope: 'global',
-                    cmdPath
-                };
-            }
-        }
-        else {
-            // Neither is capped. Both are groups (or one is).
-            // Local wins if exists.
-            if (localManifest) {
-                currentMatch = {
-                    manifest: localManifest,
-                    manifestPath: path_1.default.join(localPath, 'manifest.json'),
-                    args: remainingArgs,
-                    scope: 'local',
-                    cmdPath
-                };
-            }
-            else {
-                currentMatch = {
-                    manifest: globalManifest,
-                    manifestPath: path_1.default.join(globalPath, 'manifest.json'),
-                    args: remainingArgs,
-                    scope: 'global',
-                    cmdPath
-                };
-            }
-        }
-    }
-    return currentMatch;
-}

package/dist/src/skills.js

@@ -1,39 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SUPPORTED_AGENTS = void 0;
-exports.copySkill = copySkill;
-const path_1 = __importDefault(require("path"));
-const fs_extra_1 = __importDefault(require("fs-extra"));
-exports.SUPPORTED_AGENTS = ['cursor', 'antigravity', 'agentsmd', 'gemini'];
-async function copySkill(targetDir, agent) {
-    // We assume the skill file is located at ../skills/agentctl/SKILL.md relative to specific dist/src/ location
-    // Or we find it in the project root if running from source.
-    // In production (dist), structure might be:
-    // dist/index.js
-    // skills/agentctl/SKILL.md (if we copy it to dist)
-    // Let's try to locate the source SKILL.md
-    // If we are in /src, it is in ../skills/agentctl/SKILL.md
-    // If we are in /dist/src (tsc default?), it depends on build.
-    // Robust finding:
-    let sourcePath = path_1.default.resolve(__dirname, '../../skills/agentctl/SKILL.md');
-    if (!fs_extra_1.default.existsSync(sourcePath)) {
-        // Try looking in src check (dev mode)
-        sourcePath = path_1.default.resolve(__dirname, '../skills/agentctl/SKILL.md');
-    }
-    if (!fs_extra_1.default.existsSync(sourcePath)) {
-        // Fallback for when running from dist/src
-        sourcePath = path_1.default.resolve(__dirname, '../../../skills/agentctl/SKILL.md');
-    }
-    if (!fs_extra_1.default.existsSync(sourcePath)) {
-        throw new Error(`Could not locate source SKILL.md. Checked: ${path_1.default.resolve(__dirname, '../../skills/agentctl/SKILL.md')}`);
-    }
-    await fs_extra_1.default.ensureDir(targetDir);
-    // Determine filename
-    const filename = agent === 'cursor' ? 'agentctl.md' : 'SKILL.md';
-    const targetFile = path_1.default.join(targetDir, filename);
-    await fs_extra_1.default.copy(sourcePath, targetFile, { overwrite: true });
-    return targetFile;
-}