Chronicle v1.0.10

Chronicle v1.0.10

What's New

Unbounded Multi-Year Historical Retention

• Permanent Local Archival: Extended Room database engine to permanently retain usage logs across months and years without temporal truncation.
• Autonomous Historical Backfill: Navigating or jumping to past dates automatically synchronizes and persists historical telemetry directly from Android UsageStatsManager.

Multi-Scope PDF Dossier & Infographic Export

• Custom Material 3 Export Scope Dialog:
  • Today (Single Day): Comprehensive single-day breakdown with 24-column timeline and top apps.
  • Last 7 Days (Weekly Dossier): Executive summary, daily consumption averages, and cumulative application matrix.
  • Last 30 Days (Monthly Dossier): Long-term category distribution, aggregate screen time trends, and rank lists.
  • Custom Date Range: Integrated date pickers allowing arbitrary multi-day vector PDF dossier generation.
• Multi-Page Executive PDF Generator: Generates formatted vector PDF reports with summary metrics, category distributions, and paginated application tables.

Advanced Psychological & Behavioural Analytics Engine

• Life Clock Projection: Mathematically projects cumulative full years of conscious waking life lost to screen consumption by age 75 based on actual daily consumption.
• Dopamine Debt & Screen Fasting: Measures excess screen time against the 2.5-hour daily cognitive baseline and prescribes exact digital fasting recovery periods.
• Phantom Reflex Unlocks: Detects compulsive micro-checks where the device is unlocked and locked again within 10 seconds without launching any application.

Landing Page Silent Direct Downloads

• In-Place APK Downloading: Updated website download handler with silent background iframe execution and bottom toast notifications to eliminate page redirects and tab opening.

---

Improvements & Fixes

• Telemetry Accuracy: Every psychological insight and timeline aggregate is computed strictly from real hardware sensor timestamps and system usage events (zero mock or dummy entries).
• Database Optimization: Added specialized Room index queries for earliest recorded timestamp, total days tracked, and date range summaries.
• Strict IST Calculations: Pinned all multi-day date boundaries, historical backfills, and daily averages to Indian Standard Time (UTC+5:30).
• UI Polish: Material 3 styled insight cards and dialogs with zero emojis across all layouts, strings, and notifications.

---

Verification & Integrity

• Deterministic Testing: Automated unit tests in UsageInsightsTest verify mathematical calculations for Life Clock projections, Dopamine Debt formulas, Phantom Unlock detections, and conscious life percentages.
• Architecture Integrity: Clean Architecture + MVVM boundary separation maintained across domain models, Room DAO queries, and Jetpack Compose presentation layers.
• Security & Privacy: 100% offline, zero network tracking, zero external dependencies, signed with official production keystore.

---

Installation

• In-App Update: Automatically detected on launch via the built-in SHA-256 verified OTA updater.
• Manual Install: Download chronicle-v1.0.10.apk from the Assets below and install on Android 8.0+ (API 26–35, arm64-v8a).

Chronicle v1.0.9

What's New in Chronicle v1.0.9

1. Conscious Waking Life Calculator

• 16-Hour Waking Life Metric: Translates screen time into the true percentage of your conscious awake life spent looking at screens (e.g., 28.1% of conscious waking life).
• Annual Days Lost Projection: Computes and displays projected full 24-hour days lost across the year (e.g., Projected 68 full days lost in 2026).

2. Ghost Reflex Opens (Micro-Habit Detector)

• Sub-30s Session Analysis: Automatically isolates and flags micro-sessions under 30 seconds opened out of reflex or boredom.
• Reflex Breakdown: Displays total daily ghost opens and highlights your primary offending habit app (e.g., Ghost Opens: 24 micro-checks • Top: Instagram (18 opens)).

3. Morning Bed Doomscroll Tracker

• Dopamine Baseline Metric: Measures total screen time spent on Social, Entertainment, and Gaming applications within the first 45 minutes of waking up.
• Bedtime Routine Contrast: Shows exact duration and top morning distraction app directly alongside night bedtime usage.

4. Dynamic Reality-Check Notifications

• Context-Aware Notifications: Replaces static reminders with dynamic, targeted reality checks based on actual usage:
  • Heavy Gaming reality checks (>1.5h in games)
  • Doomscroll alerts (>1.5h in social media)
  • Daily Focus alerts (>4.5h screen time with low productivity score)
  • High Discipline celebrations (>65% productive focus)
  • Sleep recovery reminders (late-night bedtime usage)

5. App vs App Side-by-Side Comparison

• Compare any two applications head-to-head on the Analytics tab (Screen Time, Launches, Average Session Duration).

---

Improvements & Bug Fixes

• In-App Auto-Updater Hardening:
  • Added multi-hop HTTP 302 cross-domain redirect resolution from GitHub Releases to AWS S3 storage.
  • Implemented atomic temporary file downloads (.tmp) with strict 1 MB+ binary sanity validation.
  • Resolved the package parsing error (There was a problem while parsing the package) caused by interrupted downloads or stale caches.
  • Added <external-files-path> to file_paths.xml for full Android OEM compatibility.
• Analytics Tab Overhaul: Renamed the 2nd navigation tab from "Reports" to "Analytics" and integrated the full suite of habit cards, category distribution, and app comparison tools.
• Strict Privacy & Zero Emojis: 100% on-device processing, zero network telemetry, and full Material 3 dynamic theming.

---

Installation

• In-App Update: Open Chronicle -> Settings -> Check for Updates.
• Manual Install: Download chronicle-v1.0.9.apk below and open to install over existing builds.

Chronicle v1.0.8

chore(release): bump version to 1.0.8 (code 9) with automated tag-based release notes

Chronicle v1.0.7

Full Changelog: v1.0.6...v1.0.7

Chronicle v1.0.6

Full Changelog: v1.0.5...v1.0.6

Chronicle v1.0.5

Full Changelog: v1.0.4...v1.0.5

Chronicle v1.0.4

Full Changelog: v1.0.3...v1.0.4

Chronicle v1.0.3

Full Changelog: v1.0.2...v1.0.3

Chronicle v1.0.2

Chronicle v1.0.2

What's New

In-App GitHub Auto-Updater

• Automated Update Checks: Chronicle now silently checks GitHub for new releases each time the application is launched.
• Background Download Resilience: Updates download in the background without being cancelled when switching apps or minimizing Chronicle.
• Smart File Caching: Downloaded update packages are cached locally to prevent redundant downloads and offer immediate installation.
• Manual Check in Settings: Added a dedicated "Check for Updates" action under Settings with real-time version status indicators.

Screen Time & Day Boundary Accuracy

• IST Day Boundary Alignment: Replaced standard daily interval queries with precise foreground event reconciliation bounded strictly to 24-hour Indian Standard Time (IST) calendar days (00:00:00 to 23:59:59), eliminating cross-midnight double-counting.
• Live Session Tracking: In-progress foreground sessions are captured and added to active screen time in real-time.

Digital Wellbeing Parity

• Single Date Navigation: Day view header now correctly displays a single date label (e.g., Sun, 23 Aug 2026) instead of a multi-day range.
• Weekly Usage Bar Chart: Added a custom Canvas-based bar chart for the Week view featuring auto-scaled Y-axis hour markers, day labels, and accent-color highlighting for the selected day.

Keystore Consistency & Signing

• Fixed Signing Keystore: Release builds are now signed with a permanent release keystore stored securely in GitHub Secrets, ensuring all subsequent updates install directly over existing versions without package signature conflicts.

---

Installation

Important

One-Time Reinstall Notice:
Because previous builds were signed with temporary automated keys, you must uninstall any previous APK from your device once before installing chronicle-v1.0.2.apk.

All future releases (v1.0.3 and beyond) will update directly over this version using the in-app updater without requiring an uninstall.

Assets

• Download chronicle-v1.0.2.apk below.

Chronicle v1.0.1

Chronicle v1.0.1

What's New & Improvements

• Share Sheet ModalBottomSheet: Converted the export actions overlay into a native Material 3 ModalBottomSheet with equal-height (56.dp), fillMaxWidth() action buttons respecting WindowInsets.navigationBars.
• Responsive Layout for All Screens: Added WindowSizeClass adaptive layouts — Compact displays render the bottom floating navigation bar, while Medium and Expanded displays (600dp+, foldables, tablets) adapt to the side ChronicleNavigationRail.
• Accurate Screen Time Tracking: Aligned day boundaries strictly to Indian Standard Time (today.atStartOfDay to today.plusDays(1).atStartOfDay) and blended daily usage stats with live in-progress session calculations for parity with system Digital Wellbeing (±1m).
• Status Bar & Notch Inset Alignment: Replaced hardcoded top margins with WindowInsets.statusBars insets padding across all screens, preventing content clipping on punch-hole and notched devices.
• Asynchronous App Icon Loading: Added AppIconView with Coil integration and Dispatchers.IO memory caching, rendering icons at 40.dp x 40.dp (8dp rounded clip) for all installed and removed applications.

Bug Fixes

• Fixed "Save to Storage" button overflow and clipping in the export sheet.
• Fixed 1h 47m screen time deficit caused by non-aligned UTC/IST boundaries and missed in-progress sessions.
• Fixed top bar status bar overlap on devices with camera cutouts and notches.
• Fixed blank icon placeholders for installed system and third-party apps.

Installation

1. Download the attached chronicle-v1.0.1.apk asset.
2. Enable installation from unknown sources on your Android device (Android 8.0+ / API 26+).
3. Open the APK file to complete installation.
4. Follow the onboarding guide to grant Usage Access and configure your notification schedule.