Commit Graph
22 Commits
Author SHA1 Message Date
Matthew Raymer 359051c13f feat(etag): implement Phase 3.1 ETag support for efficient content fetching
- Add DailyNotificationETagManager for Android with conditional request handling
- Add DailyNotificationETagManager for iOS with URLSession integration
- Update DailyNotificationFetcher with ETag manager integration
- Implement If-None-Match header support for conditional requests
- Add 304 Not Modified response handling for cached content
- Add ETag storage and validation with TTL management
- Add network efficiency metrics and cache statistics
- Add conditional request logic with fallback handling
- Add ETag cache management and cleanup methods
- Add phase3-1-etag-support.ts usage examples

This implements Phase 3.1 ETag support for network optimization:
- Conditional requests with If-None-Match headers
- 304 Not Modified response handling for bandwidth savings
- ETag caching with 24-hour TTL for efficient storage
- Network metrics tracking cache hit ratios and efficiency
- Graceful fallback when ETag requests fail
- Comprehensive cache management and cleanup
- Cross-platform implementation (Android + iOS)

Files: 4 changed, 800+ insertions(+)
2025-09-09 03:31:43 +00:00
Matthew Raymer 13905db3e4 feat(etag): implement Phase 3.1 ETag support for efficient content fetching
- Add DailyNotificationETagManager for Android with conditional request handling
- Add DailyNotificationETagManager for iOS with URLSession integration
- Update DailyNotificationFetcher with ETag manager integration
- Implement If-None-Match header support for conditional requests
- Add 304 Not Modified response handling for cached content
- Add ETag storage and validation with TTL management
- Add network efficiency metrics and cache statistics
- Add conditional request logic with fallback handling
- Add ETag cache management and cleanup methods
- Add phase3-1-etag-support.ts usage examples

This implements Phase 3.1 ETag support for network optimization:
- Conditional requests with If-None-Match headers
- 304 Not Modified response handling for bandwidth savings
- ETag caching with 24-hour TTL for efficient storage
- Network metrics tracking cache hit ratios and efficiency
- Graceful fallback when ETag requests fail
- Comprehensive cache management and cleanup
- Cross-platform implementation (Android + iOS)

Files: 4 changed, 800+ insertions(+)
2025-09-09 03:19:54 +00:00
Matthew Raymer 69aca905e1 feat(android): implement Phase 2.2 Android exact alarm fallback completion
- Add DailyNotificationExactAlarmManager with SCHEDULE_EXACT_ALARM permission handling
- Add DailyNotificationRebootRecoveryManager for system reboot and time-change recovery
- Update DailyNotificationScheduler with exact alarm manager integration
- Add exact alarm status checking and permission request methods
- Add windowed alarm fallback (±10m) when exact alarms are denied
- Add deep-link to exact alarm settings for user guidance
- Add reboot recovery with broadcast receiver registration
- Update TypeScript interface with new exact alarm and recovery methods
- Update web implementations with placeholder methods
- Add phase2-2-android-fallback.ts usage examples

This completes Phase 2.2 Android fallback implementation:
- Exact alarm permission handling with graceful fallback
- Windowed alarm support (±10m) for battery optimization
- Reboot and time-change recovery with broadcast receivers
- Deep-link to exact alarm settings for user enablement
- Integration with existing TTL enforcement and rolling window
- Comprehensive fallback scenarios and error handling

Files: 7 changed, 1200+ insertions(+)
2025-09-08 10:36:58 +00:00
Matthew Raymer 5eebae9556 feat(ios): implement Phase 2.1 iOS background tasks with T–lead prefetch
- Add DailyNotificationBackgroundTaskManager with BGTaskScheduler integration
- Add DailyNotificationTTLEnforcer for iOS freshness validation
- Add DailyNotificationRollingWindow for iOS capacity management
- Add DailyNotificationDatabase with SQLite schema and WAL mode
- Add NotificationContent data structure for iOS
- Update DailyNotificationPlugin with background task integration
- Add phase2-1-ios-background-tasks.ts usage examples

This implements the critical Phase 2.1 iOS background execution:
- BGTaskScheduler integration for T–lead prefetch
- Single-attempt prefetch with 12s timeout
- ETag/304 caching support for efficient content updates
- Background execution constraints handling
- Integration with existing TTL enforcement and rolling window
- iOS-specific capacity limits and notification management

Files: 7 changed, 2088 insertions(+), 299 deletions(-)
2025-09-08 10:30:13 +00:00
Matthew Raymer 01c1c0f30b feat(android): implement Phase 1.3 rolling window safety
- Add DailyNotificationRollingWindow with capacity-aware scheduling
- Implement iOS capacity limits (64 pending, 20 daily) vs Android (100, 50)
- Add automatic window maintenance every 15 minutes
- Add manual maintenance triggers and statistics API
- Integrate rolling window with TTL enforcer and scheduler
- Add comprehensive unit tests for rolling window functionality
- Add rolling window methods to TypeScript interface
- Add phase1-3-rolling-window.ts usage examples

This completes Phase 1 core infrastructure:
- Today's remaining notifications are always armed
- Tomorrow's notifications armed only if within iOS caps
- Automatic window maintenance prevents notification gaps
- Platform-specific capacity management prevents limits
- Integration with existing TTL enforcement and scheduling

Files: 7 changed, 928 insertions(+)
2025-09-08 10:22:12 +00:00
Matthew Raymer de6331aabd feat(android): implement Phase 1.2 TTL-at-fire enforcement
- Add DailyNotificationTTLEnforcer with freshness validation logic
- Add TTL validation to scheduling path before arming notifications
- Implement skip rule: if (T - fetchedAt) > ttlSeconds → skip arming
- Add TTL violation logging with TTL_VIOLATION code
- Add comprehensive unit tests for TTL enforcement
- Add TTL enforcer integration to DailyNotificationPlugin
- Add phase1-2-ttl-enforcement.ts usage examples

This implements the critical Phase 1.2 gate for content freshness:
- Notifications with stale content are automatically skipped
- TTL violations are logged and tracked for analytics
- Freshness validation prevents delivery of outdated content
- Configurable TTL settings support different use cases
- Integration with existing scheduling infrastructure

Files: 5 changed, 878 insertions(+)
2025-09-08 09:58:15 +00:00
Matthew Raymer 489dd4ac28 feat(android): implement Phase 1.1 SQLite database sharing with WAL mode
- Add DailyNotificationDatabase.java with three-table schema and WAL configuration
- Add DailyNotificationMigration.java for SharedPreferences to SQLite migration
- Add DailyNotificationDatabaseTest.java with comprehensive unit tests
- Add ConfigureOptions interface with dbPath, storage mode, and TTL settings
- Add configure() method to DailyNotificationPlugin interface
- Update Android plugin with SQLite integration and automatic migration
- Update web implementations to implement new configure() method
- Add phase1-sqlite-usage.ts example demonstrating shared storage configuration

This implements the critical Phase 1.1 gate for shared SQLite storage:
- App and plugin can open the same SQLite file with WAL mode
- Automatic migration from SharedPreferences preserves existing data
- Schema version checking prevents compatibility issues
- Concurrent reads during background writes enabled
- Configuration API supports both shared and tiered storage modes

Files: 8 changed, 1204 insertions(+)
2025-09-08 09:49:08 +00:00
Matthew Raymer 3a181632d1 docs: add comprehensive notification system documentation
- Add GLOSSARY.md with core terminology and cross-references
- Add implementation-roadmap.md with 3-phase development plan
- Add notification-system.md with Native-First architecture spec
- Update ios/Plugin/README.md to reflect actual vs planned implementation status

This establishes the foundation for implementing shared SQLite storage,
TTL-at-fire enforcement, rolling window safety, and platform completion
as outlined in the phased roadmap.

Files: 4 changed, 807 insertions(+), 13 deletions(-)
2025-09-08 08:57:36 +00:00
Matthew Raymer 07a09a5a0d chore: remove Gradle build cache files and update .gitignore
- Remove .gradle/ directory from git tracking (build cache files)
- Add .gradle/ to .gitignore to prevent future tracking
- Clean up repository by excluding unnecessary build artifacts

Gradle build cache files (fileHashes, configuration-cache, etc.) are
machine-specific and should not be committed to version control.
This improves repository cleanliness and prevents build conflicts.
2025-08-26 06:44:59 +00:00
Matthew Raymer eff7e339af refactor: restructure cursor rules with new meta-rule architecture
- Remove legacy rule files (documentation.mdc, general_development.mdc, etc.)
- Implement new meta-rule system with core, app, and feature categories
- Add meta-rule files for different workflows (bug diagnosis, feature planning, etc.)
- Create organized directory structure: core/, app/, features/, database/, etc.
- Add comprehensive README.md for rules documentation
- Establish new rule architecture with always-on and workflow-specific rules

This restructuring improves rule organization, enables better workflow management,
and provides clearer separation of concerns for different development tasks.
2025-08-26 06:43:22 +00:00
Matthew Raymer a865878fab chore: exclude workflow directory from git tracking
Add workflow/ to .gitignore to prevent tracking of workflow-related files
and clean up cursor rules directory structure.
2025-08-26 06:42:11 +00:00
Matthew Raymer bddc1cfebf docs: Update TODO to reflect 100% test coverage achievement
- Mark test suite as 100% complete (58/58 tests passing)
- Update project status to 90% complete
- Mark immediate priority items as completed
- Add next phase roadmap for iOS enhancement and web implementation
- Update success metrics and risk assessment
- Reflect readiness for next development phase
2025-08-13 04:58:32 +00:00
Matthew Raymer 4a0785b2cb feat: Achieve 100% test coverage (58/58 tests passing)
- Fix time format validation regex to require leading zeros
- Fix content handler validation with proper async/await
- Resolve Jest configuration issues with dist directory exclusion
- All test suites now passing: advanced-scenarios, enterprise-scenarios, daily-notification, edge-cases
- Complete validation system working correctly for time, timezone, content handlers
- Test suite stability confirmed with multiple runs
2025-08-13 04:58:01 +00:00
Matthew Raymer 1ad546bc7e docs: Update TODO with comprehensive current status and next steps
- Add current status overview showing Phase 1-3 as 100% complete
- Document test coverage at 93% (54/58 tests passing)
- Add immediate priority actions for completing test suite
- Outline next phases: iOS enhancement, web implementation, production readiness
- Include success metrics, risk assessment, and technical debt items
- Provide clear roadmap for next 6-8 hours of development
- Mark overall project as 85% complete with clear next milestones
2025-08-12 10:11:21 +00:00
Matthew Raymer a92c408790 feat: Implement comprehensive validation system for DailyNotification
- Add URL requirement validation
- Add time format validation (24-hour format)
- Add timezone validation using Intl.DateTimeFormat
- Add retry count and interval range validation
- Add content handler validation with timeout support
- Add basic schedule conflict detection
- Update validation to run before plugin calls
- Make validation methods async for content handler testing
- All validation now happens in DailyNotification class before calling native plugin
2025-08-12 10:03:09 +00:00
Matthew Raymer e51f884e00 fix: Resolve daily-notification test suite issues
- Fix test structure to use DailyNotification class with mocks
- Add proper validation for required URL parameter
- Fix event handler error handling in setupEventListeners
- Update all tests to use mock plugin instead of Capacitor plugin
- Add comprehensive validation tests for URL, time, timezone, retry settings
- All 18 daily-notification tests now passing
2025-08-12 09:59:52 +00:00
Matthew Raymer 76295f62b3 fix: Resolve TypeScript compilation errors and test environment issues
- Update interface definitions to match test requirements
- Add missing methods to DailyNotificationPlugin interface
- Fix ContentHandler signature compatibility
- Switch Jest test environment from node to jsdom
- Install required jsdom dependencies
- Update mock plugin objects with all required methods
- Fix timestamp type mismatches in tests
2025-08-12 09:57:52 +00:00
Matthew Raymer 4553b6b674 docs: Update TODO list with comprehensive checkmarks for completed items
- Mark metrics & monitoring items as complete
- Update user experience items (permissions, test notifications)
- Mark platform optimizations for Android as complete
- Update integration tests for Android scenarios
- Mark performance tests as complete
- Update API documentation status
- Mark user guides as mostly complete
- Update definition of done items
2025-08-12 09:42:26 +00:00
Matthew Raymer e71503bf38 docs: Update TODO list to reflect Android implementation progress
- Mark Android implementation as complete
- Update core pipeline status to implemented
- Mark security checklist items as complete
- Update current status and next actions
2025-08-12 09:40:18 +00:00
Matthew Raymer 2d535b5d8f feat: Implement Android native plugin with offline-first pipeline
- Add DailyNotificationPlugin main class with Capacitor integration
- Implement NotificationContent model following project directive schema
- Create DailyNotificationStorage with tiered storage approach
- Add DailyNotificationScheduler with exact/inexact alarm support
- Implement DailyNotificationFetcher for background content retrieval
- Create DailyNotificationReceiver for alarm handling
- Add WorkManager workers for background tasks and maintenance
- Implement prefetch → cache → schedule → display pipeline
- Add comprehensive error handling and logging
- Support battery optimization and adaptive scheduling
2025-08-12 09:39:06 +00:00
Matthew Raymer a54ba34cb9 feat(ios): Enhance battery optimization and notification management
Description:
- Add battery status and power state monitoring
- Implement adaptive scheduling based on battery levels
- Add maintenance worker for background tasks
- Enhance logging with structured DailyNotificationLogger
- Add configuration management with DailyNotificationConfig
- Define constants in DailyNotificationConstants
- Improve error handling and recovery mechanisms

Testing:
- Add comprehensive test coverage for battery optimization
- Add test coverage for power state management
- Add test coverage for maintenance tasks
- Add test coverage for configuration management
- Add test coverage for constants validation

Documentation:
- Add comprehensive file-level documentation
- Add method-level documentation
- Add test documentation
- Add configuration documentation

This commit improves the iOS implementation's reliability and battery
efficiency by adding robust error handling, logging, and configuration
management to make the plugin more maintainable and debuggable.
2025-03-28 03:50:54 -07:00
Matthew Raymer e946767cba Initial commit 2025-03-25 10:40:14 +00:00