Skip to content

ROADMAP.md

Latest commit

聽

History

History
141 lines (90 loc) 路 4.18 KB

ROADMAP.md

File metadata and controls

141 lines (90 loc) 路 4.18 KB
Raw

async-inspect Roadmap

Vision: The best debugging experience for async Rust.

This roadmap outlines planned features and improvements. We welcome community input鈥攐pen an issue or discussion to share your ideas!

v0.2.0 - Enhanced Debugging

Focus: Deeper insights into async behavior

Planned Features

  • Await Point Source Maps - Click-to-navigate from blocked await to source code location

Improvements

  • Reduce memory overhead per tracked task (string interning, compact storage)
  • Improve TUI responsiveness with 10,000+ tasks
  • Add task filtering by duration, state, or name pattern

v0.3.0 - Production Observability

Focus: Safe for production use with minimal overhead

Planned Features

  • Adaptive Sampling - Automatically adjust sampling rate based on load
  • Ring Buffer Mode - Fixed memory usage, keep only recent N events
  • Remote Dashboard - Connect dashboard to remote running processes
  • Alerting - Configurable alerts for deadlocks, slow tasks, or high contention

Documentation

  • API Reference - Comprehensive public API documentation (API.md)
  • Quickstart Guide - Get started in under 5 minutes (QUICKSTART.md)
  • Enhanced Error Messages - Actionable error messages with suggestions

Integrations

  • AWS CloudWatch Metrics export
  • Datadog APM integration
  • Grafana Tempo trace export

v0.4.0 - Distributed Tracing

Focus: Multi-service async debugging

Planned Features

  • Trace Context Propagation - Track async operations across service boundaries
  • Distributed Deadlock Detection - Detect cross-service circular waits
  • Service Topology Map - Visualize async call patterns between services

Integrations

  • gRPC/tonic automatic instrumentation
  • HTTP client tracing (reqwest, hyper)
  • Message queue tracing (Kafka, RabbitMQ, NATS)

v1.0.0 - Stable Release

Focus: API stability and ecosystem maturity

Goals

  • Stable public API with semantic versioning guarantees
  • Comprehensive documentation with video tutorials
  • Published IDE extensions (VS Code Marketplace, JetBrains Marketplace)
  • Battle-tested in production environments

Future Ideas

These are longer-term ideas we're considering. Vote with a thumbs-up on the linked issues!

Runtime Support

  • Glommio integration (io_uring-based runtime)
  • Monoio integration (thread-per-core runtime)
  • Embassy integration (embedded async)

Analysis & ML

  • Anomaly detection for unusual task patterns
  • Performance regression prediction
  • Automatic bottleneck recommendations

Developer Experience

  • VS Code debugger integration (step through await points)
  • Time-travel debugging (replay recorded sessions)
  • Interactive REPL for inspecting live tasks

Contributing

We'd love your help! Here's how to get involved:

  1. Feature Requests - Open an issue describing your use case
  2. Bug Reports - Include reproduction steps and async-inspect version
  3. Pull Requests - See CONTRIBUTING.md for guidelines
  4. Documentation - Help improve examples and guides

Good First Issues

Look for issues labeled good first issue - these are great starting points for new contributors.

Priority Areas

  • Additional runtime support (async-std, smol are done; more welcome!)
  • Performance optimizations
  • Documentation improvements
  • Example applications

Version History

See CHANGELOG.md for detailed release notes.

Version Status Highlights
v0.1.0 Released Core tracking, deadlock detection, TUI, dashboard, IDE plugins, LSP
v0.2.0 Released Initial production features
v0.2.1 Current Ring buffer, adaptive sampling, memory optimization, enhanced errors
v0.3.0 Planned Production observability, cloud integrations
v0.4.0 Planned Distributed tracing
v1.0.0 Planned Stable API

Last updated: 2025-12-23

Have ideas? Open a discussion or issue!