Skip to content

ROADMAP-v2.md

Latest commit

 

History

History
117 lines (91 loc) · 4.31 KB

ROADMAP-v2.md

File metadata and controls

117 lines (91 loc) · 4.31 KB

Ruchy Book Roadmap - v2.0 (Based on v1.84.0 Analysis)

📊 Current Status: 77% Pass Rate (85/111 examples)

Last Updated: 2025-09-08
Ruchy Version: v1.84.0
Book Pass Rate: 77% (up from 63%)
Remaining Failures: 26 examples

🎯 HIGHEST PRIORITY ISSUES (Based on Failure Analysis)

Priority 1: Fix Error Handling (6 failures in ch17)

Impact: Critical for production code reliability
Failures: Result/Option types, error propagation, try-catch
Action: Implement proper Result<T,E> and Option support

Priority 2: Fix Testing Framework (3 failures in ch16)

Impact: Blocks TDD workflow
Failures: assert_eq!, test macros, module imports
Action: Implement testing macros and test runner

Priority 3: Fix Advanced Control Flow (3 failures in ch05)

Impact: Limits expressiveness
Failures: Pattern matching, advanced match expressions
Action: Complete pattern matching implementation

Priority 4: Fix Practical Patterns (5 failures in ch04)

Impact: Real-world code patterns broken
Failures: Builder patterns, iterators, closures
Action: Implement iterator traits and closure support

Priority 5: Fix Binary Compilation (3 failures in ch15)

Impact: Deployment blocked
Failures: Binary generation, optimization, cross-compilation
Action: Improve compilation pipeline

Priority 6: Complete DataFrame Transpilation (4 failures in ch18)

Impact: Data processing limited to interpreter
Failures: Transpiler generates incorrect Polars code
Action: Fix transpiler to generate correct Polars API calls

📋 Sprint Plan

Sprint 1: Error Handling & Testing (Target: 85% pass rate)

  • RUCHY-001: Implement Result<T,E> type
  • RUCHY-002: Implement Option type
  • RUCHY-003: Add ? operator for error propagation
  • RUCHY-004: Implement assert_eq! macro
  • RUCHY-005: Add test runner with #[test] support

Sprint 2: Advanced Language Features (Target: 90% pass rate)

  • RUCHY-006: Complete pattern matching
  • RUCHY-007: Add closure support
  • RUCHY-008: Implement iterator trait
  • RUCHY-009: Add builder pattern support
  • RUCHY-010: Fix function imports/modules

Sprint 3: Compilation & Deployment (Target: 95% pass rate)

  • RUCHY-011: Fix binary compilation
  • RUCHY-012: Add optimization passes
  • RUCHY-013: Support cross-compilation
  • RUCHY-014: Add release builds
  • RUCHY-015: Package management

Sprint 4: DataFrame Completion (Target: 100% pass rate)

  • RUCHY-016: Fix DataFrame transpilation to Polars
  • RUCHY-017: Add Series::new() generation
  • RUCHY-018: Support DataFrame operations
  • RUCHY-019: Add CSV/JSON I/O
  • RUCHY-020: Complete DataFrame API

📈 Success Metrics

Milestone Current Target Impact
Basic Examples 77% 85% Error handling fixed
Intermediate 77% 90% Testing & patterns work
Advanced 77% 95% Full language features
Complete 77% 100% Production ready

🔄 Feedback Loop

  1. Fix compiler issues → Test with book examples
  2. Update book → Remove workarounds for fixed issues
  3. Add tests → Ensure no regressions
  4. Document → Update user guide with new features
  5. Release → Push new version to crates.io

⚡ Quick Wins (Can do immediately)

  1. Remove broken examples that use unimplemented features
  2. Add workarounds for common patterns
  3. Document limitations clearly
  4. Create compatibility matrix showing what works/doesn't

📝 Notes from Analysis

What's Working Well (100% pass rate chapters):

  • Ch01: Hello World basics
  • Ch06: Data structures (arrays, tuples)
  • Ch14: Toolchain usage
  • Ch21: Professional tooling

What Needs Most Work:

  • Error handling (36% pass rate in ch17)
  • Testing framework (62% pass rate in ch16)
  • Binary compilation (25% pass rate in ch15)
  • Advanced patterns (40% pass rate in ch04)

DataFrame Status:

  • ✅ Interpreter mode: Fully working
  • ❌ Compilation mode: Transpiler generates wrong Polars API
  • 📝 Need: Update transpiler to generate Series::new() instead of .column()

🎯 North Star Goal

Make Ruchy production-ready by achieving 100% book example pass rate, which proves the language can handle real-world programming tasks effectively.