docs(implementation): redesign starred projects polling with generic interface

Browse Source

- Update STARRED_PROJECTS_POLLING_IMPLEMENTATION.md to version 2.0.0
- Introduce structured request/response polling system architecture
- Add GenericPollingRequest interface for host app-defined schemas
- Implement PollingScheduleConfig with cron-based scheduling
- Add comprehensive idempotency enforcement with X-Idempotency-Key
- Include unified backoff policy with Retry-After + jittered exponential caps
- Document watermark CAS (Compare-and-Swap) for race condition prevention
- Add outbox pressure controls with back-pressure and eviction strategies
- Include telemetry budgets with low-cardinality metrics and PII redaction
- Document clock synchronization with skew tolerance and JWT validation
- Add platform-specific implementations (Android WorkManager, iOS BGTaskScheduler, Web Service Workers)
- Include host app usage examples and integration patterns
- Add ready-to-merge checklist and acceptance criteria for MVP

This redesign provides maximum flexibility while maintaining cross-platform consistency.

...

This commit is contained in:

Matthew Raymer

2025-10-07 04:44:11 +00:00

parent a5831b3c9f

commit 1828bbf91c

1 changed files with 1627 additions and 484 deletions

Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL

Download Patch File Download Diff File Expand all files Collapse all files

2111

doc/STARRED_PROJECTS_POLLING_IMPLEMENTATION.md

File diff suppressed because it is too large Load Diff