@stoneforge/quarry 0.1.0

package/dist/cli/plugin-registry.js

@@ -0,0 +1,206 @@
+/**
+ * CLI Plugin Registry
+ *
+ * Handles registration of plugin commands and aliases with conflict detection.
+ * Built-in commands always take precedence over plugin commands.
+ */
+import { registerCommand, registerAlias, getCommand, getAllAliases } from './runner.js';
+/**
+ * Merges subcommands from a plugin command into an existing command.
+ *
+ * @param existingCommand - The existing command to merge into
+ * @param pluginCommand - The plugin command with subcommands to merge
+ * @param pluginName - Name of the plugin (for logging)
+ * @param verbose - Whether to log verbose output
+ * @returns Result of the merge operation
+ */
+function mergeSubcommands(existingCommand, pluginCommand, pluginName, verbose) {
+    const merged = [];
+    const skipped = [];
+    for (const [name, subCmd] of Object.entries(pluginCommand.subcommands || {})) {
+        if (existingCommand.subcommands?.[name]) {
+            skipped.push(name);
+            if (verbose) {
+                console.error(`[plugin:${pluginName}] Skipping subcommand '${existingCommand.name} ${name}': already exists`);
+            }
+        }
+        else {
+            existingCommand.subcommands = existingCommand.subcommands || {};
+            existingCommand.subcommands[name] = subCmd;
+            merged.push(name);
+            if (verbose) {
+                console.error(`[plugin:${pluginName}] Merged subcommand '${existingCommand.name} ${name}'`);
+            }
+        }
+    }
+    return { merged, skipped };
+}
+/**
+ * Registers all commands and aliases from a single plugin.
+ *
+ * Built-in commands always take precedence - plugin commands that conflict
+ * with existing commands are skipped with a warning.
+ *
+ * @param plugin - The plugin to register
+ * @param options - Registration options
+ * @returns Registration result
+ */
+export function registerPluginCommands(plugin, options) {
+    const verbose = options?.verbose ?? false;
+    const registeredCommands = [];
+    const skippedCommands = [];
+    const registeredAliases = [];
+    const skippedAliases = [];
+    // Register commands
+    for (const command of plugin.commands) {
+        const existingCommand = getCommand(command.name);
+        if (existingCommand) {
+            // Check if both have subcommands - can merge
+            if (existingCommand.subcommands && command.subcommands) {
+                const mergeResult = mergeSubcommands(existingCommand, command, plugin.name, verbose);
+                if (mergeResult.merged.length > 0) {
+                    registeredCommands.push(`${command.name} (subcommands: ${mergeResult.merged.join(', ')})`);
+                }
+                if (mergeResult.skipped.length > 0) {
+                    skippedCommands.push({
+                        commandName: command.name,
+                        success: false,
+                        conflictReason: `Subcommand(s) '${mergeResult.skipped.join(', ')}' already exist`,
+                        subcommandsMerged: mergeResult,
+                    });
+                }
+                else if (mergeResult.merged.length > 0) {
+                    // Track successful merge without conflicts for logging purposes
+                    skippedCommands.push({
+                        commandName: command.name,
+                        success: true,
+                        subcommandsMerged: mergeResult,
+                    });
+                }
+            }
+            else {
+                // Cannot merge - skip entirely (existing behavior)
+                const result = {
+                    commandName: command.name,
+                    success: false,
+                    conflictReason: `Command '${command.name}' already registered`,
+                };
+                skippedCommands.push(result);
+                if (verbose) {
+                    console.error(`[plugin:${plugin.name}] Skipping command '${command.name}': already registered`);
+                }
+            }
+        }
+        else {
+            // Register the command
+            registerCommand(command);
+            registeredCommands.push(command.name);
+            if (verbose) {
+                console.error(`[plugin:${plugin.name}] Registered command '${command.name}'`);
+            }
+        }
+    }
+    // Register aliases
+    if (plugin.aliases) {
+        const existingAliases = getAllAliases();
+        for (const [alias, target] of Object.entries(plugin.aliases)) {
+            // Check if alias conflicts with existing command or alias
+            const existingCommand = getCommand(alias);
+            const existingAlias = existingAliases.get(alias);
+            if (existingCommand) {
+                skippedAliases.push(alias);
+                if (verbose) {
+                    console.error(`[plugin:${plugin.name}] Skipping alias '${alias}': conflicts with existing command`);
+                }
+            }
+            else if (existingAlias) {
+                skippedAliases.push(alias);
+                if (verbose) {
+                    console.error(`[plugin:${plugin.name}] Skipping alias '${alias}': already registered as alias for '${existingAlias}'`);
+                }
+            }
+            else {
+                registerAlias(alias, target);
+                registeredAliases.push(alias);
+                if (verbose) {
+                    console.error(`[plugin:${plugin.name}] Registered alias '${alias}' -> '${target}'`);
+                }
+            }
+        }
+    }
+    return {
+        pluginName: plugin.name,
+        registeredCommands,
+        skippedCommands,
+        registeredAliases,
+        skippedAliases,
+    };
+}
+/**
+ * Registers all plugins' commands and aliases.
+ *
+ * Plugins are registered in order, so earlier plugins take precedence
+ * for command names. Built-in commands always take precedence over all plugins.
+ *
+ * @param plugins - Plugins to register
+ * @param options - Registration options
+ * @returns Array of registration results
+ */
+export async function registerAllPlugins(plugins, options) {
+    const results = [];
+    for (const plugin of plugins) {
+        // Run plugin init if provided
+        if (plugin.init) {
+            try {
+                await plugin.init();
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                console.error(`[plugin:${plugin.name}] Init failed: ${message}`);
+                // Continue with registration even if init fails
+            }
+        }
+        const result = registerPluginCommands(plugin, options);
+        results.push(result);
+    }
+    return results;
+}
+/**
+ * Logs conflict warnings from registration results.
+ *
+ * @param results - Registration results to check for conflicts
+ */
+export function logConflictWarnings(results) {
+    for (const result of results) {
+        // Log skipped commands
+        for (const skipped of result.skippedCommands) {
+            // Skip warning if subcommands were successfully merged (partial or full success)
+            if (skipped.subcommandsMerged?.merged.length) {
+                continue;
+            }
+            if (skipped.conflictReason) {
+                console.error(`[plugin:${result.pluginName}] Warning: ${skipped.conflictReason}`);
+            }
+        }
+        // Log skipped aliases (only if there were any)
+        if (result.skippedAliases.length > 0) {
+            console.error(`[plugin:${result.pluginName}] Warning: Skipped ${result.skippedAliases.length} alias(es) due to conflicts`);
+        }
+    }
+}
+/**
+ * Gets a summary of registered plugin commands for the help menu.
+ *
+ * @param results - Registration results
+ * @returns Map of plugin name to registered command names
+ */
+export function getPluginCommandSummary(results) {
+    const summary = new Map();
+    for (const result of results) {
+        if (result.registeredCommands.length > 0) {
+            summary.set(result.pluginName, result.registeredCommands);
+        }
+    }
+    return summary;
+}
+//# sourceMappingURL=plugin-registry.js.map

package/dist/cli/plugin-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-registry.js","sourceRoot":"","sources":["../../src/cli/plugin-registry.ts"],"names":[],"mappings":"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"}

package/dist/cli/plugin-types.d.ts

@@ -0,0 +1,106 @@
+/**
+ * CLI Plugin Types
+ *
+ * Type definitions for the CLI plugin system.
+ * Plugins can register commands and aliases to extend the CLI.
+ */
+import type { Command } from './types.js';
+/**
+ * CLI Plugin interface for extending the `sf` CLI.
+ *
+ * Plugins can provide additional commands and aliases to the CLI.
+ * They are discovered via known packages or user-specified config.
+ */
+export interface CLIPlugin {
+    /** Plugin name (should be unique) */
+    name: string;
+    /** Plugin version */
+    version: string;
+    /** Commands provided by this plugin */
+    commands: Command[];
+    /** Command aliases (e.g., 'agents' -> 'agent list') */
+    aliases?: Record<string, string>;
+    /** Optional initialization function called before commands are registered */
+    init?: () => Promise<void>;
+}
+/**
+ * Plugin configuration for user-specified packages
+ */
+export interface PluginsConfig {
+    /** Package names that export CLI plugins */
+    packages: string[];
+}
+/**
+ * Result of attempting to load a single plugin
+ */
+export interface PluginLoadResult {
+    /** Package name that was attempted */
+    packageName: string;
+    /** Whether the plugin was successfully loaded */
+    success: boolean;
+    /** The loaded plugin (if successful) */
+    plugin?: CLIPlugin;
+    /** Error message (if failed) */
+    error?: string;
+    /** Whether the package was not found (vs load error) */
+    notFound?: boolean;
+}
+/**
+ * Result of plugin discovery process
+ */
+export interface PluginDiscoveryResult {
+    /** Successfully loaded plugins */
+    plugins: CLIPlugin[];
+    /** Load results for all attempted packages */
+    results: PluginLoadResult[];
+    /** Packages that were not found (silent skip) */
+    notFoundPackages: string[];
+    /** Packages that failed to load (warning) */
+    failedPackages: string[];
+}
+/**
+ * Result of merging subcommands from a plugin command into an existing command
+ */
+export interface SubcommandMergeResult {
+    /** Subcommand names that were successfully merged */
+    merged: string[];
+    /** Subcommand names that were skipped due to conflicts */
+    skipped: string[];
+}
+/**
+ * Result of registering a command
+ */
+export interface CommandRegistrationResult {
+    /** Command name */
+    commandName: string;
+    /** Whether registration succeeded */
+    success: boolean;
+    /** Conflict reason if registration failed */
+    conflictReason?: string;
+    /** Result of subcommand merging (when both commands have subcommands) */
+    subcommandsMerged?: SubcommandMergeResult;
+}
+/**
+ * Result of registering a plugin's commands
+ */
+export interface PluginRegistrationResult {
+    /** Plugin name */
+    pluginName: string;
+    /** Commands that were successfully registered */
+    registeredCommands: string[];
+    /** Commands that were skipped due to conflicts */
+    skippedCommands: CommandRegistrationResult[];
+    /** Aliases that were successfully registered */
+    registeredAliases: string[];
+    /** Aliases that were skipped due to conflicts */
+    skippedAliases: string[];
+}
+/**
+ * Validates that an object is a valid CLIPlugin
+ */
+export declare function isValidCLIPlugin(obj: unknown): obj is CLIPlugin;
+/**
+ * Validates plugin configuration
+ */
+export declare function isValidPluginsConfig(obj: unknown): obj is PluginsConfig;
+//# sourceMappingURL=plugin-types.d.ts.map

package/dist/cli/plugin-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-types.d.ts","sourceRoot":"","sources":["../../src/cli/plugin-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAM1C;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IAEb,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAEhB,uCAAuC;IACvC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAEpB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAMD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAMD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IAEpB,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAC;IAEjB,wCAAwC;IACxC,MAAM,CAAC,EAAE,SAAS,CAAC;IAEnB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,wDAAwD;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,OAAO,EAAE,SAAS,EAAE,CAAC;IAErB,8CAA8C;IAC9C,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAE5B,iDAAiD;IACjD,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAE3B,6CAA6C;IAC7C,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAMD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,qDAAqD;IACrD,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IAEpB,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IAEjB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,qBAAqB,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IAEnB,iDAAiD;IACjD,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAE7B,kDAAkD;IAClD,eAAe,EAAE,yBAAyB,EAAE,CAAC;IAE7C,gDAAgD;IAChD,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAE5B,iDAAiD;IACjD,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,SAAS,CA2C/D;AAyCD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,aAAa,CAkBvE"}

package/dist/cli/plugin-types.js

@@ -0,0 +1,103 @@
+/**
+ * CLI Plugin Types
+ *
+ * Type definitions for the CLI plugin system.
+ * Plugins can register commands and aliases to extend the CLI.
+ */
+// ============================================================================
+// Type Guards
+// ============================================================================
+/**
+ * Validates that an object is a valid CLIPlugin
+ */
+export function isValidCLIPlugin(obj) {
+    if (typeof obj !== 'object' || obj === null) {
+        return false;
+    }
+    const plugin = obj;
+    // Required fields
+    if (typeof plugin.name !== 'string' || plugin.name.length === 0) {
+        return false;
+    }
+    if (typeof plugin.version !== 'string' || plugin.version.length === 0) {
+        return false;
+    }
+    if (!Array.isArray(plugin.commands)) {
+        return false;
+    }
+    // Validate commands array
+    for (const cmd of plugin.commands) {
+        if (!isValidCommand(cmd)) {
+            return false;
+        }
+    }
+    // Optional aliases
+    if (plugin.aliases !== undefined) {
+        if (typeof plugin.aliases !== 'object' || plugin.aliases === null) {
+            return false;
+        }
+        for (const [key, value] of Object.entries(plugin.aliases)) {
+            if (typeof key !== 'string' || typeof value !== 'string') {
+                return false;
+            }
+        }
+    }
+    // Optional init function
+    if (plugin.init !== undefined && typeof plugin.init !== 'function') {
+        return false;
+    }
+    return true;
+}
+/**
+ * Validates that an object is a valid Command
+ */
+function isValidCommand(obj) {
+    if (typeof obj !== 'object' || obj === null) {
+        return false;
+    }
+    const cmd = obj;
+    // Required fields
+    if (typeof cmd.name !== 'string' || cmd.name.length === 0) {
+        return false;
+    }
+    if (typeof cmd.description !== 'string') {
+        return false;
+    }
+    if (typeof cmd.usage !== 'string') {
+        return false;
+    }
+    if (typeof cmd.handler !== 'function') {
+        return false;
+    }
+    // Optional subcommands
+    if (cmd.subcommands !== undefined) {
+        if (typeof cmd.subcommands !== 'object' || cmd.subcommands === null) {
+            return false;
+        }
+        for (const subCmd of Object.values(cmd.subcommands)) {
+            if (!isValidCommand(subCmd)) {
+                return false;
+            }
+        }
+    }
+    return true;
+}
+/**
+ * Validates plugin configuration
+ */
+export function isValidPluginsConfig(obj) {
+    if (typeof obj !== 'object' || obj === null) {
+        return false;
+    }
+    const config = obj;
+    if (!Array.isArray(config.packages)) {
+        return false;
+    }
+    for (const pkg of config.packages) {
+        if (typeof pkg !== 'string' || pkg.length === 0) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=plugin-types.js.map

package/dist/cli/plugin-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-types.js","sourceRoot":"","sources":["../../src/cli/plugin-types.ts"],"names":[],"mappings":"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"}

package/dist/cli/runner.d.ts

@@ -0,0 +1,35 @@
+/**
+ * CLI Runner
+ *
+ * Main entry point for command execution.
+ */
+import type { Command } from './types.js';
+/**
+ * Registers a command
+ */
+export declare function registerCommand(command: Command): void;
+/**
+ * Registers a command alias
+ */
+export declare function registerAlias(alias: string, commandName: string): void;
+/**
+ * Gets a registered command (checking aliases first)
+ */
+export declare function getCommand(name: string): Command | undefined;
+/**
+ * Gets all registered commands
+ */
+export declare function getAllCommands(): Command[];
+/**
+ * Gets all registered aliases
+ */
+export declare function getAllAliases(): Map<string, string>;
+/**
+ * Runs the CLI with the given arguments
+ */
+export declare function run(argv: string[]): Promise<number>;
+/**
+ * Main CLI entry point
+ */
+export declare function main(argv?: string[]): Promise<never>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/cli/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/cli/runner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAgC,MAAM,YAAY,CAAC;AAiBxE;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEtD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAEtE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAI5D;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,EAAE,CAE1C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAEnD;AAwDD;;GAEG;AACH,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkGzD;AAgCD;;GAEG;AACH,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,KAAK,CAAC,CA+JjF"}