fix(us-bf-057): improve step/calculateupdate exception messages in optimizerbase

[ooples]

Summary

Improves error messages in OptimizerBase for the Step() and CalculateUpdate() methods by including the specific optimizer type name and providing clearer guidance.

Changes

• Updated Step() exception message to include GetType().Name
• Updated CalculateUpdate() exception message to include GetType().Name
• Clarified when developers should override these methods vs. use Optimize()
• Improved developer experience with more actionable error messages

User Story

Implements US-BF-057 - Improve Step/CalculateUpdate Exceptions in OptimizerBase

Before

throw new NotImplementedException(
    "Step() method is not implemented for this optimizer type. " +
    "This optimizer may be a non-gradient-based optimizer that uses the Optimize() method instead, " +
    "or the derived class needs to implement the Step() method.");

After

throw new NotImplementedException(
    $"The 'Step()' method is not implemented for optimizer type '{GetType().Name}'. " +
    "For gradient-based optimizers, this method must be overridden by the derived class. " +
    "For non-gradient-based optimizers, consider using the 'Optimize()' method instead.");

Files Changed

• src/Optimizers/OptimizerBase.cs - Updated exception messages for Step() and CalculateUpdate()

Test Plan

• Code compiles successfully
• Exception messages now include optimizer type name
• Messages provide clear guidance for developers
• No functional changes to optimizer behavior

Risk Assessment

Level: Low
Justification: Minor change to exception messages only. No functional logic changes.

🤖 Generated with Claude Code

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch fix/us-bf-057-optimizer-step

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[ooples]

Closing due to merge conflicts from base branch change. Will recreate if needed after other PRs are merged.