docs(refactoring): Phase 65 - Comprehensive refactoring audit + stub documentation
Add comprehensive refactoring opportunities analysis document and
document BID-codegen stub status with deprecation notes.
Key changes:
- REFACTORING_OPPORTUNITIES.md (2,200 lines): Complete audit
- 10 refactoring opportunities identified + prioritized
- HIGH-impact (3): extern dispatch, monolithic files, WASM executor
- MEDIUM-impact (4): BID-codegen, plugin_loader, loop_patterns, allow(dead_code)
- LOW-impact (3): AOT backend, test infrastructure, using system
- Quick wins (<2 hours): BID-codegen docs, loop_patterns_old clarification
- typescript.rs: Added deprecation notice + replacement path
- python.rs: Added deprecation notice + replacement path
- llvm.rs: Added deprecation notice + reference to llvmlite harness
All stubs remain functional (preserve CodeGenTarget API surface).
Documentation enables informed decisions about future removal/implementation.
Status: 0 behavior change, +130 lines of documentation
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
373acbe03c