From cda8ddb88e095968f8757b52bfccc2905aac25c5 Mon Sep 17 00:00:00 2001
From: Roman Onishchenko <romanindev@gmail.com>
Date: Tue, 7 Apr 2026 18:22:45 +0200
Subject: [PATCH] update roadmap

---
 ROADMAP.md | 85 +++++++++++++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 78 insertions(+), 7 deletions(-)

diff --git a/ROADMAP.md b/ROADMAP.md
index 222cb7c..df1c1a9 100644
--- a/ROADMAP.md
+++ b/ROADMAP.md
@@ -20,13 +20,13 @@ Delivered:
 
 ### 0.6.x — Request lifecycle
 
-**Focus**: request control and lifecycle management.
+Focus: request control and lifecycle management.
 
 Status: completed
 
 Delivered:
 
-- AbortSignal support (extended and stabilized)
+- abortSignal support (extended and stabilized)
 - request context object for passing metadata through lifecycle
 - correlation ID support (`x-request-id` propagation across services)
 - improved hook context with additional execution details
@@ -35,7 +35,7 @@ Delivered:
 
 ### 0.7.x — Observability
 
-**Focus**: logging, monitoring, and request insights.
+Focus: logging, monitoring, and request insights.
 
 Status: completed
 
@@ -51,15 +51,86 @@ Delivered:
 
 ### 0.8.x — Integration safety
 
-**Focus**: safer and more predictable integrations.
+Focus: safer and more predictable integrations.
+
+Status: in progress
 
 Planned features:
 
 - response validation (schema-based or custom)
 - idempotency key support for safe retries
 
+### 0.9.x — Platform readiness & API stabilization
+
+Focus: stabilizing core APIs, improving extensibility, and preparing dfsync for production-scale usage and future SaaS integration.
+
+Planned features:
+
+- stable validation API (finalized `responseSchema` contract)
+- validation adapters (starting with `zod`)
+- serializer / parser extensibility (custom request/response handling)
+- improved retry model:
+  - retry budget (`maxElapsedMs`)
+  - jitter support
+  - advanced retry conditions
+- finalized error model:
+  - `HttpError`
+  - `NetworkError`
+  - `TimeoutError`
+  - `AbortError`
+  - `ValidationError`
+- extended error metadata:
+  - `requestId`
+  - `attempt`
+  - `duration`
+  - optional response details
+- stable public extension interfaces:
+  - telemetry exporter interface
+  - auth provider interface
+  - validation adapter interface
+  - retry policy interface
+- operation naming support (`operationName` for requests)
+- documentation restructuring (use-case oriented)
+
+### 1.0.x — Stable core & production readiness
+
+Focus: delivering a stable, well-documented, and production-ready API with long-term support guarantees.
+
+Planned features:
+
+- stable and fully documented public API
+- finalized request lifecycle model
+- production-ready retry and timeout behavior
+- first-class validation support
+- stable and versioned extension interfaces
+- migration guide from 0.x
+- production best practices documentation:
+  - retries
+  - timeouts
+  - idempotency
+  - observability
+- compatibility guarantees (Node.js/runtime support)
+- improved examples:
+  - internal APIs
+  - external integrations
+  - background jobs / workers
+
+### Future direction — dfsync Cloud (SaaS)
+
+Focus: extending dfsync as a platform with observability, control, and reliability tooling for service-to-service communication.
+
+Planned areas:
+
+- request observability dashboard (latency, errors, retries)
+- request tracing by `requestId`
+- integration health monitoring
+- centralized retry / timeout policy management
+- alerting (error spikes, high latency)
+- secure data handling (redaction / filtering)
+- telemetry ingestion and analytics
+
 ### Notes
 
-- Versions below `1.0.0` may introduce breaking changes.
-- The API will be stabilized before the `1.0.0` release.
-- The roadmap may evolve based on real-world usage and feedback.
+- versions below `1.0.0` may introduce breaking changes.
+- the API will be stabilized before the `1.0.0` release.
+- the roadmap may evolve based on real-world usage and feedback.