Mindtpy docs

[bernalde]

Fixes N/A.

Summary/Motivation:

This PR ports the MindtPy polishing work from tarikLG/pyomo#3 into Pyomo main.
It improves MindtPy docstrings, standardizes terminology and helper naming, preserves the no-discrete-variable solve behavior, and clarifies Feasibility Pump dispatch so strategy-specific iteration loops run through the intended path.

Local verification:

• python -m black . --check --diff
• python -m pytest -q -W ignore::Warning pyomo/contrib/mindtpy/tests

Changes proposed in this PR:

• Add and refine MindtPy solver, algorithm, utility, and configuration docstrings using Pyomo documentation conventions.
• Rename and standardize MindtPy test model files/classes for consistency, while preserving compatibility aliases where appropriate.
• Refactor MindtPy cut/feasibility component setup naming and Feasibility Pump iteration dispatch for clearer control flow.
• Add/update MindtPy tests covering the no-discrete-variable solve path and updated test model imports.

AI-Use Disclosure

• AI tools contributed to the development of this PR

  • AI tools generated documentation (including the PR description/comments, code comments, and/or Sphinx documentation)
  • AI tools generated tests (baselines, examples, and/or code)
  • AI tools generated code (apart from tests)

  Review process (select ONE):

  • Rewritten: All AI-generated content was rewritten by me before being committed.
  • Reviewed/verified: I retained AI-generated content and verified it before committing. Verification included (as applicable):
    • Ran the code and fixed issues
    • Added and ran tests
    • Checked correctness/logic of code and tests
    • Checked for alignment with the contribution guide
    • Considered security implications
  • As-is: AI-generated content was commited directly to the repository

Notes for reviewers (optional): Please focus review on the MindtPy Feasibility Pump dispatch path, the no-discrete-variable behavior, and whether the renamed test models and compatibility aliases match Pyomo conventions.

Legal Acknowledgement

By contributing to this software project, I have read the contribution guide and agree to the following terms and conditions for my contribution:

1. I agree my contributions are submitted under the BSD license.
2. I represent I am authorized to make the contributions and grant the license. If my employer has rights to intellectual property that includes these contributions, I represent that I have received permission to make contributions and grant the required license on behalf of that employer.

[bernalde]

Tests are failing because of another contrib package (iis)