Nabs.Launchpad.Core.Ai.Menu 10.0.229

Nabs.Launchpad.Core.Ai.Menu

Nabs.Launchpad.Core.Ai.Menu provides a strongly typed command registry for building reliable, discoverable AI-driven console menus without fragile reflection or duplicated plumbing.

Installation

dotnet add package Nabs.Launchpad.Core.Ai.Menu

The Problem

// 1) Duplicate command names silently overwrite intent in ad-hoc dictionaries
var commands = new Dictionary<string, Func<Task>>();
commands["run"] = () => Task.CompletedTask;
commands["run"] = () => Task.Delay(1); // accidental replacement

// 2) Exit behavior gets scattered and can appear in inconsistent positions
menuItems.Add("Exit", ExitAsync);
menuItems.Insert(0, "Exit", ExitAsync); // multiple paths, unclear behavior

// 3) Input conversion is hand-rolled and fails late at runtime
var retries = int.Parse(userInput); // throws on invalid input

// 4) Generic command results are hard to normalize
var result = await command.Run(); // each command returns different shapes
if (result == null) { /* unclear failure handling */ }

Features

• Strongly typed menu command registration with IMenuCommand<TResult> and IMenuCommand<TInput, TResult> support.
• Duplicate name protection to prevent conflicting command registrations.
• Consistent exit command ordering, keeping exit actions at the end of the menu.
• Built-in string-to-input conversion for typed commands (including enum support).
• Unified execution result model via MenuCommandExecutionResult.

Usage

using Ardalis.Result;
using Nabs.Launchpad.Core.Ai;
using Nabs.Launchpad.Core.Ai.Menu;

public sealed class GreetCommand : IMenuCommand<string, string>
{
	public string ChoiceLabel => "Say hello";
	public string Name => "greet";
	public string Description => "Greets a user by name.";

	public Task<Result<string>> RunMenuAsync(string input)
	{
		return Task.FromResult(Result.Success($"Hello, {input}!"));
	}
}

var registry = new MenuCommandRegistry();
registry.AddHeading("AI Utility Menu");
registry.ConfigureMenuCommands(
[
	new GreetCommand(),
	new ExitMenuCommand()
]);

var greet = registry.MenuCommands.Single(c => c.Name == "greet");
var execution = await greet.RunMenuAsync("Launchpad");

if (execution.IsSuccess)
{
	Console.WriteLine(execution.Value);
}

Configuration

No package-level configuration is required. Register commands at runtime through MenuCommandRegistry.

Project Structure

• MenuCommandRegistry - registers commands, validates uniqueness, orders exit commands, and executes commands.
• MenuCommandRegistration - immutable registration record containing metadata and executable delegate.
• MenuCommandExecutionResult - normalized execution response (IsSuccess, Value, ValidationErrors).
• ExitMenuCommand - default exit command implementation.
• IMenuPrompt - minimal prompt contract exposing a command registry.

License

Copyright (c) Net Advantage Business Solutions.