bg_orchestrator

Releases

1. ▸▾1.1.028 Mar 20262 sources agree

   Major release consolidating all reliability, scheduling, batching, and security features into a single, battle-tested package.

   Complete Feature Set - Production Ready

   Major release consolidating all reliability, scheduling, batching, and security features into a single, battle-tested package.

   Reliability & Observability

   • Task middleware/interceptors for logging, auth refresh, analytics
   • Soft and hard timeouts with warning callbacks and force termination
   • Persistent execution history with duration, status, errors, stack traces
   • Global lifecycle hooks: onTaskStart, onTaskComplete, onTaskFailed, onChainComplete

   Advanced Scheduling

   • Cron expressions with standard 5-field syntax (0 9 * * MON, 0 */6 * * *, etc.)
   • Time window constraints to restrict execution to specific hours/days
   • Task deduplication by input hash or specific fields with TTL
   • Presets: hourly, daily, weeklyMonday, monthly, offPeak, businessHours

   Batching & Concurrency

   • Batch operations to enqueue 100s of items as one trackable unit
   • Concurrency control with strategies (FIFO, LIFO, random, byPriority)
   • Rate limiting to throttle executions per time window (e.g., 10/min)
   • Priority queues with weighted execution (critical=100x, high=10x, default=1x, low=0.1x)

   Security & Encryption

   • AES-256-GCM encryption at rest for sensitive task data
   • Platform keychain integration (Keystore on Android, Keychain on iOS)
   • Foreground services with bidirectional UI communication
   • Service ↔ UI event channels for real-time data streaming

   New API Types

   Added 12 new API classes for advanced feature control:

   • TaskMiddleware - Interceptor pattern for task execution
   • TaskHistoryEntry - Execution log model with serialization
   • TaskHooks - Global lifecycle callbacks
   • TaskTimeout - Soft/hard timeout configuration with presets
   • CronSchedule - 5-field cron expression builder
   • TimeWindow - Hour/day-of-week constraints with presets
   • DedupPolicy - Deduplication by input or specific fields
   • TaskBatch - Batch operations with then/catch/finally callbacks
   • ConcurrencyControl - Concurrency limit and strategy configuration
   • RateLimit - Rate limiting with time windows and presets
   • TaskQueue - Weighted priority queue enum (critical, high, default, low)
   • TaskEncryption - AES-256-GCM encryption configuration

   Enhanced API Methods

   Updated TaskFlow and TaskChain to accept all new parameters:

   • TaskFlow.enqueue() - Now supports timeout, middleware, dedup, concurrency, rate limit, queue, encryption, time window
   • TaskFlow.schedule() - Now supports cron expressions and time windows
   • TaskFlow.getHistory() - New method to retrieve execution history for debugging
   • All parameters fully documented with examples

   Comprehensive Example App

   Complete demonstration of all v1.0-v2.0 features:

   • 7 major feature sections with 20+ example buttons
   • Live task monitoring with progress bars and status chips
   • Real-time activity log showing all operations
   • Shows all execution modes and advanced configurations

   Documentation Updates

   • Rewrote README with examples for every feature
   • Updated CHANGELOG to document all available capabilities
   • Complete ROADMAP showing feature status and future direction
   • API reference with parameter documentation

   Bug Fixes

   • Fixed TaskTimeout const validation (use runtime validation instead)
   • Fixed TimeWindow const assertions (use final presets)
   • All 12 new API types fully integrated and tested

   ---