Add SolverForge production readiness review (2026-03-20)

[blackopsrepl]

Motivation

• Document a workspace-wide audit to assess completeness, coherence, and production readiness across all crates.
• Capture current blockers, duplication, and generator-produced placeholders that prevent some crates from being production-ready.
• Produce concrete, high-value follow-ups to raise the overall project quality and testing coverage.

Description

• Add PRODUCTION_REVIEW_2026-03-20.md containing scope, workspace-level assessment, crate-by-crate audits, production-readiness rankings, and recommended remediation steps.
• Call out global strengths and blockers, including failing Clippy lint (module_inception) in solverforge-cli tests and remaining todo!() placeholders in generated code.
• Flag weaker crates (solverforge-cvrp, solverforge-cli, solverforge-console, solverforge-macros) and recommend concrete actions such as adding tests, consolidating duplicate helpers, gating unfinished CLI commands, and improving generated scaffolding.
• Provide a prioritized list of highest-value improvements to make the workspace more production-ready.

Testing

• Run existing workspace unit tests and doctests, which were observed to be passing during the review.
• Run Clippy across the workspace, which surfaced module_inception warnings in two test modules under solverforge-cli.
• No new automated tests were added in this change and all existing crate tests referenced in the review remained green except for the reported Clippy lint findings.

---

Codex Task

[blackopsrepl]

Converted the proposed backlog in PRODUCTION_REVIEW_ISSUES_2026-03-20.md into individual GitHub issues and opened them one by one:

• solverforge-cli: make strict Clippy pass across all targets #4 solverforge-cli: make strict Clippy pass across all targets
• Gate or implement the solverforge console command #5 Gate or implement the solverforge console command
• Finish or hide the generic list-variable scaffold #6 Finish or hide the generic list-variable scaffold
• Make generated constraints compile without raw todo placeholders #7 Make generated constraints compile without raw todo placeholders
• Replace scaffolded data-loader stubs with compile-safe templates #8 Replace scaffolded data-loader stubs with compile-safe templates
• Add direct unit tests for solverforge-cvrp #9 Add direct unit tests for solverforge-cvrp
• Reduce unsafe surface and duplicate wrappers in solverforge-cvrp #10 Reduce unsafe surface and duplicate wrappers in solverforge-cvrp
• Add direct tests for solverforge-console #11 Add direct tests for solverforge-console
• Add compile-pass, compile-fail, and golden tests for solverforge-macros #12 Add compile-pass, compile-fail, and golden tests for solverforge-macros
• Publish a crate stability matrix and release checklist #13 Publish a crate stability matrix and release checklist
• Add scaffold smoke tests for generated projects and workflows #14 Add scaffold smoke tests for generated projects and workflows

Closing this PR without merging because its actionable output has now been transferred into tracked issues.

[blackopsrepl]

Closing without merge. The actionable backlog from this review was split into issues #4 through #14 for tracking.