Update README.md and ROADMAP.md to reflect v0.4.0 release and plan v0.5.0

Author: codewithmpia

README.md

@@ -393,6 +393,14 @@ Thanks to all our amazing contributors! 🎉
 
 Asok is actively developed with exciting features planned:
 
+**v0.4.0** - GraphQL & Extensions ✅ **Released June 2026**
+- **Plugin System**: Fully extensible community extension system with secure path sandboxing
+- **Advanced SSR & Hydration**: Islands architecture, Static Site Generation (SSG), and Incremental Static Regeneration (ISR)
+- **GraphQL API**: Built-in GraphQL server with schema auto-generation from models and subscription support
+- **API Versioning**: URL-based and header-based versioning, negotiation, deprecation warnings and sunsetting
+- **Advanced WebSockets**: Real-time presence tracking, room authorization hooks, Direct Messages, and typing indicators
+- **Multi-Database Scaling**: Advanced ORM database router for read replicas and query load balancing
+
 **v0.3.0** - Enterprise Ready ✅ **Released June 2026**
 - **Async/ASGI**: Full async/await support with ASGI/WSGI dual engine
 - **Multi-DB**: PostgreSQL & MySQL with connection pooling, vector search
@@ -406,21 +414,19 @@ Asok is actively developed with exciting features planned:
 - **Localization**: Translation management UI and automatic string extraction
 - **Query Optimization**: N+1 detection, query analysis, index suggestions, slow query logging
 
-**v0.4.0** - GraphQL & Scale (Planned Q4 2026)
-- GraphQL API with auto-generated schemas and subscriptions
-- Advanced WebSocket features (presence, permissions, private messages)
-- Multi-database scaling (read replicas, sharding, load balancing)
-- Plugin ecosystem for third-party extensions
-- Built-in monitoring & observability (Prometheus/Grafana)
-- Advanced SSR & hydration (islands architecture, SSG, ISR)
+**v0.5.0** - Enterprise Scale & Observability (Planned Q1 2027)
+- **Built-in Monitoring**: Prometheus/Grafana integration, performance metrics and health check endpoints
+- **Multi-Tenancy**: SaaS tenant isolation structures and middleware
+- **CDN Integration**: Automatic static media asset pipeline delivery
+- **Microservices Support**: Built-in gRPC support and service mesh integration
 
 **Note:** Timelines are subject to change based on community feedback and development priorities.
 
 ---
 
 ## 🏭 Production Status
 
-Asok v0.3.0 is **actively developed software** with growing production adoption. It's suitable for:
+Asok v0.4.0 is **actively developed software** with growing production adoption. It's suitable for:
 
 **✅ Recommended for:**
 - Production web applications and APIs
@@ -433,9 +439,9 @@ Asok v0.3.0 is **actively developed software** with growing production adoption.
 
 **⚠️ Current Limitations:**
 - **Ecosystem**: Growing community, limited third-party plugins
-- **Maturity**: v0.3.x - APIs are stabilizing but may evolve before v1.0
+- **Maturity**: v0.4.x - APIs are stabilizing but may evolve before v1.0
 
-**For mission-critical production applications**, Asok v0.3.0 provides enterprise features (async, multi-DB, Redis, S3) suitable for production workloads. Evaluate if the current feature set meets your specific requirements.
+**For mission-critical production applications**, Asok v0.4.0 provides enterprise features (async, multi-DB, Redis, S3) suitable for production workloads. Evaluate if the current feature set meets your specific requirements.
 
 ---
 

ROADMAP.md

@@ -6,139 +6,83 @@ This roadmap outlines the planned features and improvements for upcoming Asok re
 
 ## Current Stable Release
 
-### v0.3.0 (Released: June 2026)
+### v0.4.0 (Released: June 2026)
 
 **Status**: ✅ Stable
 
-Modern async stack, enterprise database support, and developer tooling:
+GraphQL api engine, community extensions system, hybrid rendering (Islands/SSG/ISR), advanced WebSocket presence/typing, multi-database query load balancing, and API versioning negotiation:
 
-**Core Framework:**
-- **Async/ASGI Support**: Full async/await support with ASGI/WSGI dual engine, async middlewares, and non-blocking database queries
-- **Multi-Database Support**: PostgreSQL and MySQL backends with connection pooling, cross-engine migrations, and config-driven DB binds
-- **Redis Integration**: Native Redis support for caching, session persistence, cache warming, and fragment caching
-- **Cloud Storage**: AWS S3 file storage with automatic mime-type detection
-- **Background Jobs**: `asok worker` command for background task processing with Redis resilience
-- **Database Fixtures**: New `asok dumpdata` and `asok loaddata` CLI commands for data seeding
+**Extensions System:**
+- **Community Extensions System**: Fully extensible third-party package registration for custom pages, templates, and static assets with secure path traversal sandboxing.
 
-**Advanced ORM:**
-- **Polymorphic Relationships**: MorphTo/MorphMany for flexible model associations
-- **Self-Referencing Relationships**: Models can reference themselves (parent/child hierarchies)
-- **Nested Eager Loading**: Prevent N+1 queries with deep relation loading
-- **Custom Relationship Types**: Extensible relationship system
-- **Vector Similarity Search**: Built-in support for embedding-based search (PostgreSQL pgvector)
-- **Query Optimization Tools**: N+1 detection in development, query plan analysis, automatic index suggestions, slow query logging
+**Performance & Rendering:**
+- **Hybrid SSR & Hydration**: Selective/Partial hydration for islands architecture.
+- **SSG & ISR**: Static Site Generation (SSG) for static routes and Incremental Static Regeneration (ISR) with automated background stale-cache warming.
 
-**Real-Time Features:**
-- **WebSocket Rooms**: Room-based broadcasting with join/leave for multi-user collaboration
+**API & GraphQL:**
+- **Built-in GraphQL**: Auto-generated GraphQL schema resolved from models, playground explorer in development, and subscription support.
+- **API Versioning**: URL-based and header-based API versioning, negotiation headers, and deprecation sunset notifications.
 
-**Admin Panel Enhancements:**
-- **Inline Editing**: Quick updates without full page navigation
-- **Advanced Filtering**: Date ranges, multi-field filters, saved filter presets
-- **Column Customization**: Toggle column visibility for personalized views
-
-**Developer Experience:**
-- **VSCode Extension**: Official IDE integration with syntax highlighting, IntelliSense, template autocompletion, route navigation, and snippets
-- **Localization Tools**: Translation management UI and automatic string extraction for i18n
-- **Query Debugging**: Built-in tools for identifying and fixing performance issues
-
-[View Full Changelog](https://github.com/asok-framework/asok-docs/blob/main/CHANGELOG.md)
+**Real-Time & Scaling:**
+- **Advanced WebSockets**: Real-time user presence tracking, status, Direct Messages, typing indicators, read receipts, and room authorization hooks.
+- **Multi-Database Scaling**: Advanced ORM query load balancer routing queries to read replicas and write masters.
 
 ---
 
 ## Previous Releases
 
-### v0.1.7 (Released: May 2026)
+### v0.3.0 (Released: June 2026)
 
 **Status**: ✅ Stable
 
-Framework refactoring and architecture overhaul for long-term maintainability:
-- **Module Restructuring**: Reorganized monolithic engine and CLI into clean, modular packages (`asok/core/`, `asok/orm/`, `asok/cli/`, etc.) with 100% backward compatibility.
-- **Asset Compilation**: Pre-compiled minified assets for admin, API, and developer toolbar. Added official Python 3.13 support.
-- **Enhanced Test Coverage**: Added dedicated suites for AJAX CSRF rotation, SPA reactivity fixes, developer toolbar, and API static files.
-
----
-
-## Upcoming Releases
-
-### v0.4.0 - GraphQL & Enterprise Scale (Q4 2026)
-
-**Status**: 📋 Planned
-
-#### API & GraphQL
+Modern async stack, enterprise database support, and developer tooling:
 
-- **GraphQL Support** - Modern API development
-  - Built-in GraphQL server
-  - Auto-generated schema from models
-  - Query complexity analysis
-  - GraphQL playground in development
-  - Subscriptions via WebSockets
+**Core Framework:**
+- **Async/ASGI Support**: Full async/await support with ASGI/WSGI dual engine, async middlewares, and non-blocking database queries.
+- **Multi-Database Support**: PostgreSQL and MySQL backends with connection pooling, cross-engine migrations, and config-driven DB binds.
+- **Redis Integration**: Native Redis support for caching, session persistence, cache warming, and fragment caching.
+- **Cloud Storage**: AWS S3 file storage with automatic mime-type detection.
+- **Background Jobs**: `asok worker` command for background task processing with Redis resilience.
+- **Database Fixtures**: New `asok dumpdata` and `asok loaddata` CLI commands for data seeding.
 
-- **API Versioning** - Professional API management
-  - URL-based versioning (/api/v1/, /api/v2/)
-  - Header-based versioning
-  - API deprecation warnings and sunset headers
-  - Version negotiation and content-type versioning
+**Advanced ORM:**
+- **Polymorphic Relationships**: MorphTo/MorphMany for flexible model associations.
+- **Self-Referencing Relationships**: Models can reference themselves (parent/child hierarchies).
+- **Nested Eager Loading**: Prevent N+1 queries with deep relation loading.
+- **Vector Similarity Search**: Built-in support for pgvector search.
 
-#### Enterprise & Scalability
+**Developer Experience:**
+- **VSCode Extension**: Syntax highlighting, IntelliSense, template autocompletion, route navigation, and snippets.
+- **Localization Tools**: Translation management UI and automatic string extraction.
 
-- **Advanced WebSocket Features** - Enhanced real-time capabilities
-  - User presence tracking and status updates
-  - Room permissions and authentication
-  - Private messaging and direct messages
-  - Typing indicators and read receipts
+---
 
-- **Multi-Database Scaling** - Horizontal scaling
-  - Read replicas configuration
-  - Sharding strategies for large datasets
-  - Multi-region database support
-  - Automatic read/write load balancing
+### v0.1.7 (Released: May 2026)
 
-#### Developer Experience
+**Status**: ✅ Stable
 
-- **Plugin System** - Extend Asok with third-party packages
-  - Plugin discovery and auto-registration
-  - Hook system for core events
-  - Plugin configuration API
-  - Official plugin registry
+Framework refactoring and architecture overhaul for long-term maintainability:
+- **Module Restructuring**: Reorganized monolithic engine and CLI into clean, modular packages (`asok/core/`, `asok/orm/`, `asok/cli/`, etc.).
+- **Asset Compilation**: Pre-compiled minified assets for admin, API, and developer toolbar.
 
-- **CLI Enhancements** - Advanced developer tools
-  - Performance profiling tools (flame graphs, memory usage)
-  - Database introspection commands (show schema, explain queries)
-  - Asset pipeline optimization (automatic sprite generation)
-  - Environment management (config validation, secrets vault)
+---
 
-- **VSCode Extension Enhancements** - Advanced IDE features
-  - Debug configuration templates
-  - Live preview for templates
-  - Integrated test runner
-  - Visual database schema browser
+## Upcoming Releases
 
-#### Performance & Rendering
+### v0.5.0 - Enterprise Scale & Observability (Planned Q1 2027)
 
-- **Advanced SSR & Hydration** - Enhanced rendering strategies
-  - Hybrid rendering (SSR + Client-side hydration)
-  - Selective/Partial hydration for islands architecture
-  - Static site generation (SSG) for marketing pages
-  - Incremental static regeneration (ISR)
+**Status**: 📋 Planned
 
 #### Monitoring & Observability
+- **Built-in Monitoring** - Request/response logging, performance metrics collection, health check endpoints, and Prometheus/Grafana integrations.
+- **Slow Query Alerting** - Automatic warning logs and mail alerts for database bottlenecks.
 
-- **Built-in Monitoring** - Production-ready observability
-  - Request/response logging
-  - Performance metrics (response time, query count)
-  - Error tracking and alerts
-  - Health check endpoints
-  - Integration with Prometheus/Grafana
+#### Enterprise Features
+- **Multi-Tenancy** - Native SaaS multi-tenant schema isolation.
+- **CDN Caching** - Built-in asset pipeline delivery optimization integration.
 
-#### Admin Interface
-
-- **Admin Dashboard Enhancements** - Advanced administration features
-  - Drag-and-drop file uploads with progress
-  - Dashboard widgets and statistics
-  - Batch operations interface
-  - Advanced export/import tools
-
----
+#### Developer Experience
+- **Performance Profiling Tools** - CLI flame graphs and memory usage profilers.
 
 ---
 
@@ -188,8 +132,8 @@ Check [GitHub Discussions](https://github.com/asok-framework/asok/discussions) f
 | v0.1.6 | May 15, 2026 | ✅ Released | Security & UI Transitions |
 | v0.1.7 | May 25, 2026 | ✅ Released | Architecture Overhaul |
 | v0.3.0 | June 1, 2026 | ✅ Released | Async & Multi-DB Support |
-| v0.4.0 | Q4 2026 | 📋 Planned | Advanced Features |
-| v0.5.0 | Q2 2027 | 💭 Conceptual | Enterprise Scale |
+| v0.4.0 | June 7, 2026 | ✅ Released | GraphQL & Extensions |
+| v0.5.0 | Q1 2027 | 📋 Planned | Enterprise Scaling & Monitoring |
 
 **Note**: Dates are approximate and subject to change based on community priorities and development capacity.
 
@@ -217,6 +161,6 @@ We maintain backward compatibility within major versions and provide clear upgra
 
 ---
 
-**Last Updated**: June 1, 2026
+**Last Updated**: June 7, 2026
 
 For the most up-to-date information, check the [GitHub Projects board](https://github.com/asok-framework/asok/projects).