ADR-147: Add ProgramDelegate support to CommandServiceBase

[Copilot]

Extends CommandServiceBase<T> and Command to support an optional ProgramDelegate action for IR command learning, with the same error handling, logging, and UI state lifecycle as ExecuteDelegate. Services that don't support programming return null from CreateProgramHandler() and are unaffected.

Model

• Command: Added ProgramAsync (ExecuteDelegate?) property with MVVM support. null means "not programmable."

CommandServiceBase

• CreateProgramHandler(CommandType): new virtual method, returns null by default; override to enable programming
• InitializeAsync: calls CreateProgramHandler per command; wraps non-null results and sets command.ProgramAsync, tracks programmable commands
• CleanUpAsync: sets a "was shut down" handler on programmable commands (consistent with ExecuteAsync behavior); non-programmable commands stay null
• CreateWrappedProgramHandler: mirrors execute wrapper — sets IsActive, logs start/success/cancel/error, propagates exceptions

// Subclass opts in by overriding CreateProgramHandler:
protected override Command.ExecuteDelegate? CreateProgramHandler(IRCommand command)
{
    return cancellationToken => _connection!.LearnIRAsync(cancellationToken);
}

Logging & Errors

• Five new MessageLogger entries (EventIds 607–611): Programming, Programmed, ProgramError, ProgramCancelled, ProgramWasShutDown
• Errors.CommandService_ProgramWasShutDown for post-shutdown calls

Tests

• MockProgrammableCommandService test double overrides both CreateHandler and CreateProgramHandler
• 13 new unit tests covering: constructor/init/cleanup state for programmable and non-programmable services; IsActive lifecycle; success, long-running (via TaskCompletionSource), error, and cancellation paths; cancellation token propagation; and shutdown handler behavior

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.