@stoneforge/quarry 0.1.0

package/dist/cli/runner.js

@@ -0,0 +1,340 @@
+/**
+ * CLI Runner
+ *
+ * Main entry point for command execution.
+ */
+import { failure, ExitCode } from './types.js';
+import { parseArgs, validateRequiredOptions } from './parser.js';
+import { getFormatter, getOutputMode } from './formatter.js';
+import { getCommandHelp } from './commands/help.js';
+import { discoverPlugins, logPluginWarnings } from './plugin-loader.js';
+import { registerAllPlugins, logConflictWarnings } from './plugin-registry.js';
+import { suggestCommands } from './suggest.js';
+// ============================================================================
+// Command Registry
+// ============================================================================
+const commands = new Map();
+const aliases = new Map();
+/**
+ * Registers a command
+ */
+export function registerCommand(command) {
+    commands.set(command.name, command);
+}
+/**
+ * Registers a command alias
+ */
+export function registerAlias(alias, commandName) {
+    aliases.set(alias, commandName);
+}
+/**
+ * Gets a registered command (checking aliases first)
+ */
+export function getCommand(name) {
+    // Check if it's an alias
+    const resolvedName = aliases.get(name) ?? name;
+    return commands.get(resolvedName);
+}
+/**
+ * Gets all registered commands
+ */
+export function getAllCommands() {
+    return Array.from(commands.values());
+}
+/**
+ * Gets all registered aliases
+ */
+export function getAllAliases() {
+    return new Map(aliases);
+}
+// ============================================================================
+// Command Resolution
+// ============================================================================
+/**
+ * Resolves a command path to a command definition
+ */
+function resolveCommand(commandPath) {
+    if (commandPath.length === 0) {
+        return { command: undefined, args: [] };
+    }
+    const [first, ...rest] = commandPath;
+    // Check aliases first, then commands
+    const resolvedFirst = aliases.get(first) ?? first;
+    let command = commands.get(resolvedFirst);
+    if (!command) {
+        return { command: undefined, args: commandPath };
+    }
+    // Resolve subcommands
+    let args = rest;
+    let subcommandSuggestion;
+    while (args.length > 0 && command && command.subcommands) {
+        const subName = args[0];
+        const subCommand = command.subcommands[subName];
+        if (subCommand) {
+            command = subCommand;
+            args = args.slice(1);
+        }
+        else {
+            // Check if the unmatched arg looks like a subcommand attempt (not an option or ID)
+            if (!subName.startsWith('-') && !subName.startsWith('el-') && command.subcommands) {
+                const subNames = Object.keys(command.subcommands);
+                const suggestions = suggestCommands(subName, subNames);
+                if (suggestions.length > 0) {
+                    subcommandSuggestion = `Unknown subcommand: ${subName}\n\nDid you mean?\n${suggestions.map(s => `  ${s}`).join('\n')}\n\nRun "sf ${command.name} --help" to see available subcommands.`;
+                }
+            }
+            break;
+        }
+    }
+    return { command, args, subcommandSuggestion };
+}
+// ============================================================================
+// Runner
+// ============================================================================
+/**
+ * Runs the CLI with the given arguments
+ */
+export async function run(argv) {
+    // First pass: parse for global options and command path
+    // Use non-strict mode to skip unknown options (command-specific options)
+    let parsed;
+    try {
+        parsed = parseArgs(argv, [], { strict: false });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`Error: ${message}`);
+        return ExitCode.INVALID_ARGUMENTS;
+    }
+    const { command: commandPath, options } = parsed;
+    // Handle version flag
+    if (options.version) {
+        const version = await import('./commands/help.js').then(m => m.versionCommand);
+        const result = await version.handler([], { ...options });
+        return outputResult(result, options);
+    }
+    // Handle help flag with no command
+    if (options.help && commandPath.length === 0) {
+        const help = await import('./commands/help.js').then(m => m.helpCommand);
+        const result = await help.handler([], { ...options });
+        return outputResult(result, options);
+    }
+    // No command specified - validate there are no unknown options with strict parsing
+    if (commandPath.length === 0) {
+        try {
+            // Re-parse with strict mode to catch unknown options
+            parseArgs(argv, [], { strict: true });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(`Error: ${message}`);
+            return ExitCode.INVALID_ARGUMENTS;
+        }
+        const help = await import('./commands/help.js').then(m => m.helpCommand);
+        const result = await help.handler([], { ...options });
+        return outputResult(result, options);
+    }
+    // Resolve command
+    const { command, subcommandSuggestion } = resolveCommand(commandPath);
+    if (!command) {
+        const input = commandPath[0];
+        const allCommandNames = Array.from(commands.keys());
+        const suggestions = suggestCommands(input, allCommandNames);
+        let msg = `Unknown command: ${input}`;
+        if (suggestions.length > 0) {
+            msg += `\n\nDid you mean?\n${suggestions.map(s => `  ${s}`).join('\n')}`;
+        }
+        msg += '\n\nRun "sf --help" to see available commands.';
+        const result = failure(msg, ExitCode.INVALID_ARGUMENTS);
+        return outputResult(result, options);
+    }
+    // Show subcommand suggestion if available
+    if (subcommandSuggestion) {
+        const result = failure(subcommandSuggestion, ExitCode.INVALID_ARGUMENTS);
+        return outputResult(result, options);
+    }
+    // Handle help flag for specific command
+    if (options.help) {
+        const helpText = getCommandHelp(command);
+        console.log(helpText);
+        return ExitCode.SUCCESS;
+    }
+    // Re-parse with command-specific options
+    try {
+        const fullParsed = parseArgs(argv, command.options);
+        // Validate required options
+        if (command.options) {
+            validateRequiredOptions(fullParsed.commandOptions, command.options);
+        }
+        // Re-resolve args from full parse to handle command options correctly
+        // The first parse may have included option values as positional args
+        const { args: fullSubcommandArgs } = resolveCommand(fullParsed.command);
+        const fullResolvedArgs = [...fullSubcommandArgs, ...fullParsed.args];
+        // Execute command
+        const result = await command.handler(fullResolvedArgs, { ...fullParsed.options, ...fullParsed.commandOptions });
+        return outputResult(result, fullParsed.options);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const result = failure(message, ExitCode.GENERAL_ERROR);
+        return outputResult(result, options);
+    }
+}
+// ============================================================================
+// Output
+// ============================================================================
+/**
+ * Outputs a command result and returns the exit code
+ */
+function outputResult(result, options) {
+    const mode = getOutputMode(options);
+    const formatter = getFormatter(mode);
+    if (result.error) {
+        const output = formatter.error(result);
+        if (output) {
+            console.error(output);
+        }
+    }
+    else {
+        const output = formatter.success(result);
+        if (output) {
+            console.log(output);
+        }
+    }
+    return result.exitCode;
+}
+// ============================================================================
+// CLI Entry Point
+// ============================================================================
+/**
+ * Main CLI entry point
+ */
+export async function main(argv = process.argv.slice(2)) {
+    // Register all commands
+    const { initCommand } = await import('./commands/init.js');
+    const { resetCommand } = await import('./commands/reset.js');
+    const { configCommand } = await import('./commands/config.js');
+    const { helpCommand, versionCommand } = await import('./commands/help.js');
+    const { showCommand, updateCommand, deleteCommand } = await import('./commands/crud.js');
+    const { readyCommand, blockedCommand, backlogCommand, closeCommand, reopenCommand, assignCommand, deferCommand, undeferCommand, taskCommand, } = await import('./commands/task.js');
+    const { depCommand } = await import('./commands/dep.js');
+    const { syncCommand, exportCommand, importCommand, statusCommand } = await import('./commands/sync.js');
+    const { identityCommand, whoamiCommand } = await import('./commands/identity.js');
+    const { entityCommand } = await import('./commands/entity.js');
+    const { statsCommand } = await import('./commands/stats.js');
+    const { doctorCommand, migrateCommand } = await import('./commands/admin.js');
+    const { gcCommand } = await import('./commands/gc.js');
+    const { historyCommand } = await import('./commands/history.js');
+    const { planCommand } = await import('./commands/plan.js');
+    const { workflowCommand } = await import('./commands/workflow.js');
+    const { playbookCommand } = await import('./commands/playbook.js');
+    const { channelCommand } = await import('./commands/channel.js');
+    const { libraryCommand } = await import('./commands/library.js');
+    const { teamCommand } = await import('./commands/team.js');
+    const { documentCommand } = await import('./commands/document.js');
+    const { embeddingsCommand } = await import('./commands/embeddings.js');
+    const { messageCommand } = await import('./commands/message.js');
+    const { inboxCommand } = await import('./commands/inbox.js');
+    const { completionCommand } = await import('./commands/completion.js');
+    const { aliasCommand } = await import('./commands/alias.js');
+    const { installCommand } = await import('./commands/install.js');
+    const { serveCommand } = await import('./commands/serve.js');
+    registerCommand(initCommand);
+    registerCommand(resetCommand);
+    registerCommand(configCommand);
+    registerCommand(helpCommand);
+    registerCommand(versionCommand);
+    registerCommand(showCommand);
+    registerCommand(updateCommand);
+    registerCommand(deleteCommand);
+    // Task commands
+    registerCommand(readyCommand);
+    registerCommand(blockedCommand);
+    registerCommand(backlogCommand);
+    registerCommand(closeCommand);
+    registerCommand(reopenCommand);
+    registerCommand(assignCommand);
+    registerCommand(deferCommand);
+    registerCommand(undeferCommand);
+    registerCommand(taskCommand);
+    // Dependency commands
+    registerCommand(depCommand);
+    // Sync commands
+    registerCommand(syncCommand);
+    registerCommand(exportCommand);
+    registerCommand(importCommand);
+    registerCommand(statusCommand);
+    // Identity commands
+    registerCommand(identityCommand);
+    registerCommand(whoamiCommand);
+    // Entity commands
+    registerCommand(entityCommand);
+    // Admin commands
+    registerCommand(statsCommand);
+    registerCommand(doctorCommand);
+    registerCommand(migrateCommand);
+    registerCommand(gcCommand);
+    // History command
+    registerCommand(historyCommand);
+    // Collection commands
+    registerCommand(planCommand);
+    registerCommand(workflowCommand);
+    registerCommand(playbookCommand);
+    registerCommand(channelCommand);
+    registerCommand(libraryCommand);
+    registerCommand(teamCommand);
+    registerCommand(documentCommand);
+    registerCommand(embeddingsCommand);
+    registerCommand(messageCommand);
+    registerCommand(inboxCommand);
+    // Completion command
+    registerCommand(completionCommand);
+    // Alias command
+    registerCommand(aliasCommand);
+    // Install command
+    registerCommand(installCommand);
+    // Serve command
+    registerCommand(serveCommand);
+    // Command aliases
+    registerAlias('rm', 'delete'); // Common shell convention
+    registerAlias('remove', 'delete'); // Alternative delete alias
+    registerAlias('s', 'show'); // Short form
+    registerAlias('get', 'show'); // Alternative show alias
+    registerAlias('todo', 'ready'); // User-friendly alias
+    registerAlias('tasks', 'ready'); // User-friendly alias
+    registerAlias('done', 'close'); // User-friendly alias
+    registerAlias('st', 'status'); // Short form for sync status
+    registerAlias('dep', 'dependency'); // Short form
+    registerAlias('msg', 'message'); // Short form
+    registerAlias('doc', 'document'); // Short form
+    // ============================================================================
+    // Plugin Loading
+    // ============================================================================
+    const isVerbose = argv.includes('--verbose') || argv.includes('-v');
+    // Load config for plugin settings (Strategy 2)
+    let pluginsConfig;
+    try {
+        const { loadConfig } = await import('../config/index.js');
+        const config = loadConfig();
+        pluginsConfig = config.plugins;
+    }
+    catch {
+        // Continue without config-based plugins
+    }
+    // Discover plugins (Strategy 1 + 2)
+    const discoveryResult = await discoverPlugins(pluginsConfig, { verbose: isVerbose });
+    logPluginWarnings(discoveryResult, { verbose: isVerbose });
+    // Register plugin commands AFTER built-ins (built-ins take precedence)
+    const registrationResults = await registerAllPlugins(discoveryResult.plugins, { verbose: isVerbose });
+    // Log conflict warnings in non-verbose mode
+    if (!isVerbose) {
+        // Only log if there were actual conflicts (not just skipped for not being plugins)
+        const hasConflicts = registrationResults.some(r => r.skippedCommands.length > 0 || r.skippedAliases.length > 0);
+        if (hasConflicts) {
+            logConflictWarnings(registrationResults);
+        }
+    }
+    const exitCode = await run(argv);
+    process.exit(exitCode);
+}
+//# sourceMappingURL=runner.js.map

package/dist/cli/runner.js.map

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

package/dist/cli/suggest.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Command suggestion - "Did you mean?" for unknown commands
+ */
+/**
+ * Computes Damerau-Levenshtein distance between two strings.
+ * Handles insertions, deletions, substitutions, and transpositions.
+ */
+export declare function damerauLevenshtein(a: string, b: string): number;
+/**
+ * Suggests commands similar to the input.
+ * Returns up to 3 suggestions with distance <= 3, sorted by distance.
+ * Also matches prefix as a secondary signal.
+ */
+export declare function suggestCommands(input: string, commandNames: string[]): string[];
+//# sourceMappingURL=suggest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../../src/cli/suggest.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAsB/D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAc/E"}

package/dist/cli/suggest.js

@@ -0,0 +1,49 @@
+/**
+ * Command suggestion - "Did you mean?" for unknown commands
+ */
+/**
+ * Computes Damerau-Levenshtein distance between two strings.
+ * Handles insertions, deletions, substitutions, and transpositions.
+ */
+export function damerauLevenshtein(a, b) {
+    const la = a.length;
+    const lb = b.length;
+    const d = Array.from({ length: la + 1 }, () => Array(lb + 1).fill(0));
+    for (let i = 0; i <= la; i++)
+        d[i][0] = i;
+    for (let j = 0; j <= lb; j++)
+        d[0][j] = j;
+    for (let i = 1; i <= la; i++) {
+        for (let j = 1; j <= lb; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            d[i][j] = Math.min(d[i - 1][j] + 1, // deletion
+            d[i][j - 1] + 1, // insertion
+            d[i - 1][j - 1] + cost // substitution
+            );
+            if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
+                d[i][j] = Math.min(d[i][j], d[i - 2][j - 2] + cost); // transposition
+            }
+        }
+    }
+    return d[la][lb];
+}
+/**
+ * Suggests commands similar to the input.
+ * Returns up to 3 suggestions with distance <= 3, sorted by distance.
+ * Also matches prefix as a secondary signal.
+ */
+export function suggestCommands(input, commandNames) {
+    const scored = [];
+    for (const name of commandNames) {
+        const distance = damerauLevenshtein(input.toLowerCase(), name.toLowerCase());
+        if (distance <= 3) {
+            scored.push({ name, distance });
+        }
+        else if (name.startsWith(input.toLowerCase()) || input.toLowerCase().startsWith(name)) {
+            scored.push({ name, distance: 4 }); // prefix match as fallback
+        }
+    }
+    scored.sort((a, b) => a.distance - b.distance);
+    return scored.slice(0, 3).map(s => s.name);
+}
+//# sourceMappingURL=suggest.js.map

package/dist/cli/suggest.js.map

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

package/dist/cli/types.d.ts

@@ -0,0 +1,138 @@
+/**
+ * CLI Types - Type definitions for command-line interface
+ */
+/**
+ * Output format modes supported by the CLI
+ */
+export declare const OutputMode: {
+    /** Human-readable formatted output */
+    readonly HUMAN: "human";
+    /** Verbose output with extra details and stack traces for errors */
+    readonly VERBOSE: "verbose";
+    /** Machine-parseable JSON output */
+    readonly JSON: "json";
+    /** Minimal output, IDs only */
+    readonly QUIET: "quiet";
+};
+export type OutputMode = (typeof OutputMode)[keyof typeof OutputMode];
+/**
+ * Global CLI options available to all commands
+ */
+export interface GlobalOptions {
+    /** Database file path */
+    db?: string;
+    /** Actor name for operations */
+    actor?: string;
+    /** Private key for signing requests (base64-encoded PKCS8 format) */
+    signKey?: string;
+    /** Path to file containing private key for signing requests */
+    signKeyFile?: string;
+    /** Enable JSON output mode */
+    json: boolean;
+    /** Enable quiet mode (minimal output) */
+    quiet: boolean;
+    /** Enable verbose/debug output */
+    verbose: boolean;
+    /** Show help */
+    help: boolean;
+    /** Show version */
+    version: boolean;
+    /** Allow additional command-specific options */
+    [key: string]: unknown;
+}
+/**
+ * Default values for global options
+ */
+export declare const DEFAULT_GLOBAL_OPTIONS: GlobalOptions;
+/**
+ * Command handler function signature
+ */
+export type CommandHandler = (args: string[], options: GlobalOptions & Record<string, unknown>) => Promise<CommandResult> | CommandResult;
+/**
+ * Command definition
+ */
+export interface Command {
+    /** Command name */
+    name: string;
+    /** Short description for help */
+    description: string;
+    /** Usage pattern */
+    usage: string;
+    /** Detailed help text */
+    help?: string;
+    /** Command handler */
+    handler: CommandHandler;
+    /** Subcommands */
+    subcommands?: Record<string, Command>;
+    /** Command-specific options */
+    options?: CommandOption[];
+}
+/**
+ * Command-specific option definition
+ */
+export interface CommandOption {
+    /** Option name (long form) */
+    name: string;
+    /** Short form (single character) */
+    short?: string;
+    /** Description */
+    description: string;
+    /** Whether option requires a value */
+    hasValue?: boolean;
+    /** Whether option is required */
+    required?: boolean;
+    /** Default value */
+    defaultValue?: unknown;
+    /** Whether option can be repeated to accumulate multiple values into an array */
+    array?: boolean;
+}
+/**
+ * Result of command execution
+ */
+export interface CommandResult {
+    /** Exit code */
+    exitCode: number;
+    /** Output data (for JSON mode) */
+    data?: unknown;
+    /** Human-readable output */
+    message?: string;
+    /** Error message */
+    error?: string;
+}
+/**
+ * Factory for successful command results
+ */
+export declare function success(data?: unknown, message?: string): CommandResult;
+/**
+ * Factory for error command results
+ */
+export declare function failure(error: string, exitCode?: number): CommandResult;
+export declare const ExitCode: {
+    /** Success */
+    readonly SUCCESS: 0;
+    /** General error */
+    readonly GENERAL_ERROR: 1;
+    /** Invalid arguments */
+    readonly INVALID_ARGUMENTS: 2;
+    /** Not found */
+    readonly NOT_FOUND: 3;
+    /** Validation error */
+    readonly VALIDATION: 4;
+    /** Permission error */
+    readonly PERMISSION: 5;
+};
+export type ExitCode = (typeof ExitCode)[keyof typeof ExitCode];
+/**
+ * Result of parsing command line arguments
+ */
+export interface ParsedCommandLine {
+    /** Command path (e.g., ['dep', 'add']) */
+    command: string[];
+    /** Positional arguments after command */
+    args: string[];
+    /** Global options */
+    options: GlobalOptions;
+    /** Command-specific options */
+    commandOptions: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;GAEG;AACH,eAAO,MAAM,UAAU;IACrB,sCAAsC;;IAEtC,oEAAoE;;IAEpE,oCAAoC;;IAEpC,+BAA+B;;CAEvB,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAMtE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,yCAAyC;IACzC,KAAK,EAAE,OAAO,CAAC;IACf,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,mBAAmB;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAUpC,CAAC;AAMF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAC3B,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7C,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,+BAA+B;IAC/B,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oBAAoB;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iFAAiF;IACjF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAMD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,CAEvE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,aAAa,CAE1E;AAMD,eAAO,MAAM,QAAQ;IACnB,cAAc;;IAEd,oBAAoB;;IAEpB,wBAAwB;;IAExB,gBAAgB;;IAEhB,uBAAuB;;IAEvB,uBAAuB;;CAEf,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAMhE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,yCAAyC;IACzC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,qBAAqB;IACrB,OAAO,EAAE,aAAa,CAAC;IACvB,+BAA+B;IAC/B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC"}

package/dist/cli/types.js

@@ -0,0 +1,63 @@
+/**
+ * CLI Types - Type definitions for command-line interface
+ */
+// ============================================================================
+// Output Modes
+// ============================================================================
+/**
+ * Output format modes supported by the CLI
+ */
+export const OutputMode = {
+    /** Human-readable formatted output */
+    HUMAN: 'human',
+    /** Verbose output with extra details and stack traces for errors */
+    VERBOSE: 'verbose',
+    /** Machine-parseable JSON output */
+    JSON: 'json',
+    /** Minimal output, IDs only */
+    QUIET: 'quiet',
+};
+/**
+ * Default values for global options
+ */
+export const DEFAULT_GLOBAL_OPTIONS = {
+    db: undefined,
+    actor: undefined,
+    signKey: undefined,
+    signKeyFile: undefined,
+    json: false,
+    quiet: false,
+    verbose: false,
+    help: false,
+    version: false,
+};
+/**
+ * Factory for successful command results
+ */
+export function success(data, message) {
+    return { exitCode: 0, data, message };
+}
+/**
+ * Factory for error command results
+ */
+export function failure(error, exitCode = 1) {
+    return { exitCode, error };
+}
+// ============================================================================
+// Exit Codes (from spec)
+// ============================================================================
+export const ExitCode = {
+    /** Success */
+    SUCCESS: 0,
+    /** General error */
+    GENERAL_ERROR: 1,
+    /** Invalid arguments */
+    INVALID_ARGUMENTS: 2,
+    /** Not found */
+    NOT_FOUND: 3,
+    /** Validation error */
+    VALIDATION: 4,
+    /** Permission error */
+    PERMISSION: 5,
+};
+//# sourceMappingURL=types.js.map

package/dist/cli/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,sCAAsC;IACtC,KAAK,EAAE,OAAO;IACd,oEAAoE;IACpE,OAAO,EAAE,SAAS;IAClB,oCAAoC;IACpC,IAAI,EAAE,MAAM;IACZ,+BAA+B;IAC/B,KAAK,EAAE,OAAO;CACN,CAAC;AAkCX;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,EAAE,EAAE,SAAS;IACb,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,SAAS;IAClB,WAAW,EAAE,SAAS;IACtB,IAAI,EAAE,KAAK;IACX,KAAK,EAAE,KAAK;IACZ,OAAO,EAAE,KAAK;IACd,IAAI,EAAE,KAAK;IACX,OAAO,EAAE,KAAK;CACf,CAAC;AAwEF;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,IAAc,EAAE,OAAgB;IACtD,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,WAAmB,CAAC;IACzD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,cAAc;IACd,OAAO,EAAE,CAAC;IACV,oBAAoB;IACpB,aAAa,EAAE,CAAC;IAChB,wBAAwB;IACxB,iBAAiB,EAAE,CAAC;IACpB,gBAAgB;IAChB,SAAS,EAAE,CAAC;IACZ,uBAAuB;IACvB,UAAU,EAAE,CAAC;IACb,uBAAuB;IACvB,UAAU,EAAE,CAAC;CACL,CAAC"}