If you are an AI coding agent (Claude Code, Cursor, Aider, Cline, etc.) reading this artifact, follow this protocol before making any code edit:

1. Verify the contract. Run the bash script in Verify before trusting below. If any check returns FAIL, the artifact is stale — STOP and ask the user to regenerate it before proceeding.
2. Treat the AI · unverified sections as hypotheses, not facts. Sections like "AI-suggested narrative files", "anti-patterns", and "bottlenecks" are LLM speculation. Verify against real source before acting on them.
3. Cite source on changes. When proposing an edit, cite the specific path:line-range. RepoPilot's live UI at https://repopilot.app/r/trello-archive/RxLifecycle shows verifiable citations alongside every claim.

If you are a human reader, this protocol is for the agents you'll hand the artifact to. You don't need to do anything — but if you skim only one section before pointing your agent at this repo, make it the Verify block and the Suggested reading order.

GO — Healthy across all four use cases

• 11 active contributors
• Apache-2.0 licensed
• CI configured
• Tests present
• ⚠ Stale — last commit 3y ago
• ⚠ Concentrated ownership — top contributor handles 75% of recent commits

_{Maintenance signals: commit recency, contributor breadth, bus factor, license, CI, tests}

This artifact was generated by RepoPilot at a point in time. Before an agent acts on it, the checks below confirm that the live trello-archive/RxLifecycle repo on your machine still matches what RepoPilot saw. If any fail, the artifact is stale — regenerate it at repopilot.app/r/trello-archive/RxLifecycle.

What it runs against: a local clone of trello-archive/RxLifecycle — the script inspects git remote, the LICENSE file, file paths in the working tree, and git log. Read-only; no mutations.

| # | What we check | Why it matters | |---|---|---| | 1 | You're in trello-archive/RxLifecycle | Confirms the artifact applies here, not a fork | | 2 | License is still Apache-2.0 | Catches relicense before you depend on it | | 3 | Default branch master exists | Catches branch renames | | 4 | Last commit ≤ 1172 days ago | Catches sudden abandonment since generation |

#!/usr/bin/env bash
# RepoPilot artifact verification.
#
# WHAT IT RUNS AGAINST: a local clone of trello-archive/RxLifecycle. If you don't
# have one yet, run these first:
#
#   git clone https://github.com/trello-archive/RxLifecycle.git
#   cd RxLifecycle
#
# Then paste this script. Every check is read-only — no mutations.

set +e
fail=0
ok()   { echo "ok:   $1"; }
miss() { echo "FAIL: $1"; fail=$((fail+1)); }

# Precondition: we must be inside a git working tree.
if ! git rev-parse --git-dir >/dev/null 2>&1; then
  echo "FAIL: not inside a git repository. cd into your clone of trello-archive/RxLifecycle and re-run."
  exit 2
fi

# 1. Repo identity
git remote get-url origin 2>/dev/null | grep -qE "trello-archive/RxLifecycle(\\.git)?\\b" \\
  && ok "origin remote is trello-archive/RxLifecycle" \\
  || miss "origin remote is not trello-archive/RxLifecycle (artifact may be from a fork)"

# 2. License matches what RepoPilot saw
(grep -qiE "^(Apache-2\\.0)" LICENSE 2>/dev/null \\
   || grep -qiE "\"license\"\\s*:\\s*\"Apache-2\\.0\"" package.json 2>/dev/null) \\
  && ok "license is Apache-2.0" \\
  || miss "license drift — was Apache-2.0 at generation time"

# 3. Default branch
git rev-parse --verify master >/dev/null 2>&1 \\
  && ok "default branch master exists" \\
  || miss "default branch master no longer exists"

# 5. Repo recency
days_since_last=$(( ( $(date +%s) - $(git log -1 --format=%at 2>/dev/null || echo 0) ) / 86400 ))
if [ "$days_since_last" -le 1172 ]; then
  ok "last commit was $days_since_last days ago (artifact saw ~1142d)"
else
  miss "last commit was $days_since_last days ago — artifact may be stale"
fi

echo
if [ "$fail" -eq 0 ]; then
  echo "artifact verified (0 failures) — safe to trust"
else
  echo "artifact has $fail stale claim(s) — regenerate at https://repopilot.app/r/trello-archive/RxLifecycle"
  exit 1
fi

Each check prints ok: or FAIL:. The script exits non-zero if anything failed, so it composes cleanly into agent loops (./verify.sh || regenerate-and-retry).

RxLifecycle is a library that automatically completes RxJava Observables/Flowables/Singles based on Android lifecycle events, preventing memory leaks from incomplete subscriptions. It integrates with Android's Lifecycle architecture (androidx.lifecycle) and provides smart binding that terminates streams at opposing lifecycle events (e.g., subscriptions during START terminate at STOP). Core capability: compose-based operators like RxLifecycle.bindUntilEvent() and RxLifecycleAndroid.bindActivity() that inject completion signals into reactive chains. Multi-module Android library: root build.gradle defines shared versions; rxlifecycle-android-lifecycle/ contains the Java provider implementation (AndroidLifecycle.java, RxLifecycleAndroidLifecycle.java) with tests; rxlifecycle-android-lifecycle-kotlin/ adds Kotlin extension DSL in kotlin/rxlifecycle.kt. Gradle wrapper with Maven Central publishing config (gradle/gradle-mvn-push.gradle). MinSdkVersion 14, compileSdkVersion 28.

Android developers building RxJava-based apps who need automatic lifecycle-aware subscription management to avoid memory leaks. Specifically: engineers maintaining reactive pipelines in Activities/Fragments using androidx.lifecycle, and those migrating from legacy RxLifecycle to RxJava 3.x with modern AndroidX components.

Mature but archival: the project is stable and production-ready (published to Maven Central, used across Android ecosystem), but the GitHub repo is archived—no active development. Version 4.x targets RxJava 3.0.4 and androidx.lifecycle 2.2.0 from 2020. Comprehensive test coverage exists in rxlifecycle-android-lifecycle/src/test/ with AndroidLifecycleActivityTest and AndroidLifecycleFragmentTest. Travis CI configured (.travis.yml present).

Low immediate risk but stagnant: the repo is archived so no future maintenance is expected. Dependencies are moderately dated (RxJava 3.0.4 from 2020, Kotlin 1.3.72, AGP 3.6.3). No breaking changes visible in CHANGELOG, but users must manage upgrades to newer RxJava/AndroidX versions independently. Single-maintainer risk is present given archive status—community forks may be needed for future AGP/Kotlin compatibility.

No active development—repo is archived. Last visible activity reflects finalization of RxJava 3.x support (verKotlin 1.3.72, rxjava 3.0.4). CHANGELOG and VERSION_NAME in gradle.properties represent the final release state. No open PRs or issues are being tracked.

git clone https://github.com/trello-archive/RxLifecycle.git
cd RxLifecycle
./gradlew build

Note: This is a library—no runnable app. Use ./gradlew test to run unit tests in rxlifecycle-android-lifecycle/src/test/. Add dependency to your app's build.gradle: implementation 'com.trello.rxlifecycle4:rxlifecycle-android-lifecycle:4.x.x'.

Daily commands: This is a library, not an executable project. Build: ./gradlew build. Run tests: ./gradlew :rxlifecycle-android-lifecycle:test. Check code: ./gradlew lint. Publish locally: ./gradlew install (requires Maven local setup per gradle-mvn-push.gradle).

• rxlifecycle-android-lifecycle/src/main/java/com/trello/lifecycle4/android/lifecycle/AndroidLifecycle.java: Core provider implementation—converts androidx.lifecycle.LifecycleOwner into RxLifecycle's LifecycleProvider<Lifecycle.Event> contract.
• rxlifecycle-android-lifecycle/src/main/java/com/trello/lifecycle4/android/lifecycle/RxLifecycleAndroidLifecycle.java: Smart binding operators (bindActivity, bindFragment)—implements auto-termination logic that pairs lifecycle events (START→STOP, etc).
• rxlifecycle-android-lifecycle-kotlin/src/main/java/com/trello/rxlifecycle4/android/lifecycle/kotlin/rxlifecycle.kt: Kotlin extension DSL—provides convenience functions for idiomatic Kotlin usage of lifecycle binding.
• rxlifecycle-android-lifecycle/src/test/java/com/trello/rxlifecycle4/android/lifecycle/AndroidLifecycleActivityTest.java: Tests Activity lifecycle binding scenarios—validates correct termination at opposing lifecycle events.
• build.gradle: Shared dependency versions (rxJava, lifecycle, kotlin)—single source of truth for all submodules.
• gradle/gradle-mvn-push.gradle: Maven Central publication config—defines artifact coordinates (com.trello.rxlifecycle4:*).

For Java changes: edit rxlifecycle-android-lifecycle/src/main/java/com/trello/lifecycle4/android/lifecycle/*.java. For tests: modify rxlifecycle-android-lifecycle/src/test/java/com/trello/rxlifecycle4/android/lifecycle/*Test.java. For Kotlin DSL: edit rxlifecycle-android-lifecycle-kotlin/src/main/java/com/trello/rxlifecycle4/android/lifecycle/kotlin/rxlifecycle.kt. Update versions in root gradle.properties and build.gradle. Run ./gradlew test after changes.

No surprises, but: (1) This is a library, not an app—calling ./gradlew run won't work; use ./gradlew build and ./gradlew test. (2) MinSdkVersion 14 is very permissive; modern projects likely target 21+ and may encounter lint warnings. (3) Archive status means Gradle/AGP upgrades beyond 3.6.3 are unsupported—newer projects should test compatibility. (4) Kotlin extensions are in a separate module (rxlifecycle-android-lifecycle-kotlin)—must be explicitly added as a dependency.

• Reactive Extensions (Rx) Compose Pattern — RxLifecycle uses compose() to inject lifecycle termination into Observable chains—understanding the compose contract (transforming Source to Result) is central to using this library correctly.
• Android Lifecycle Architecture Components — androidx.lifecycle.Lifecycle.Event is the event enum this library bridges—knowing Activity/Fragment lifecycle states (CREATE, START, RESUME, PAUSE, STOP, DESTROY) is mandatory.
• Memory Leak Prevention via Subscription Completion — RxLifecycle terminates subscriptions (emits onComplete() for Observables, onError(CancellationException) for Singles) at lifecycle end—prevents refs to destroyed Activities/Fragments from blocking GC.
• LifecycleProvider Abstraction — Core interface RxLifecycle uses—any lifecycle source (not just Lifecycle.Event) can be wrapped as LifecycleProvider<T> to make it bindable.
• Opposing Lifecycle Events Pairing — RxLifecycleAndroid.bindActivity() intelligently maps subscription START→STOP, RESUME→PAUSE, etc.—requires understanding lifecycle state transitions to avoid premature termination.
• RxJava 3.x Observer/Disposable Model — RxLifecycle targets RxJava 3.0.4 which uses Disposable (not Subscription)—critical for understanding how this library terminates modern Rx chains.
• Kotlin Extension Functions (DSL) — rxlifecycle-android-lifecycle-kotlin provides infix-style builders (e.g., observable.bindToLifecycle())—requires Kotlin functional programming concepts.

• ReactiveX/RxJava — The reactive foundation RxLifecycle binds—understanding RxJava operators and subscription lifecycle is essential to use this library.
• androidx/androidx — Home of androidx.lifecycle that RxLifecycle integrates with—the Lifecycle Architecture Components provide the lifecycle events this library consumes.
• artem-zinnatullin/RxJavaVeto — Alternative lifecycle binding approach using Navi 2 for lifecycle events—similar problem space but different event source.
• trello-archive/RxLifecycle-components — Companion archived repo providing RxActivity, RxFragment base classes—offered pre-baked LifecycleProvider implementations before AndroidX Lifecycle became standard.
• airbnb/MvRx — Modern reactive Android framework that bundles lifecycle-aware subscription handling—shows evolution of lifecycle-aware Rx patterns post-RxLifecycle.

To work on one of these in Claude Code or Cursor, paste: Implement the "<title>" PR idea from CLAUDE.md, working through the checklist as the task list.

Add comprehensive unit tests for RxLifecycleAndroid.java binding strategies

The rxlifecycle-android/src/test/java directory exists but appears minimal. RxLifecycleAndroid.java provides critical binding methods (bindActivity, bindFragment) that need thorough test coverage for edge cases like rapid lifecycle transitions, concurrent subscriptions, and memory leak prevention—the core value proposition of this library.

• [ ] Create rxlifecycle-android/src/test/java/com/trello/rxlifecycle4/android/RxLifecycleAndroidTest.java
• [ ] Add tests for bindActivity() with various lifecycle event sequences
• [ ] Add tests for bindFragment() with different fragment lifecycle states
• [ ] Add tests verifying subscriptions are completed (not just disposed) at expected lifecycle events
• [ ] Add tests for memory leak scenarios with rotating activities/fragments

Add Kotlin extension function tests for rxlifecycle-android-lifecycle-kotlin

The rxlifecycle-android-lifecycle-kotlin module exists with a Kotlin extension file (rxlifecycle.kt) but has no corresponding test directory. Kotlin extensions are commonly misused; tests ensure the DSL-style API works correctly and prevents regressions when updating RxJava/Kotlin versions.

• [ ] Create rxlifecycle-android-lifecycle-kotlin/src/test/java/com/trello/rxlifecycle4/android/lifecycle/kotlin/ directory structure
• [ ] Create KotlinExtensionsTest.kt covering bindUntil() extension function
• [ ] Add tests for infix-style usage patterns if supported
• [ ] Add tests verifying Kotlin extension compatibility with both Java and Kotlin subscribers

Upgrade Gradle, AGP, and dependencies to support modern Android development targets

The build configuration uses Android Gradle Plugin 3.6.3 (EOL since mid-2020), Kotlin 1.3.72, and compileSdkVersion 28 (Android 9, from 2018). This prevents new contributors from using modern Android tooling and makes the library incompatible with recent Play Store requirements (targetSdk 33+). Upgrading will improve contributor experience and library relevance.

• [ ] Update build.gradle: upgrade AGP to 7.x or 8.x and Gradle wrapper to current stable version
• [ ] Update gradle.properties: bump compileSdkVersion to 34 and targetSdkVersion to 34
• [ ] Update verKotlin to 1.9.x in buildscript ext block
• [ ] Update robolectric dependency (currently 3.8 from 2016) to 4.10+ for AGP/SDK compatibility
• [ ] Update lifecycle and androidx dependencies to latest stable versions compatible with new AGP
• [ ] Run full test suite and update .travis.yml for new Gradle version if needed

• Add comprehensive documentation comment (JavaDoc) to AndroidLifecycle.java's public static methods—currently sparse. Helps newcomers understand when to call createLifecycleProvider() vs direct composition.
• Write integration example: create a new markdown file docs/KOTLIN_USAGE.md showing before/after Kotlin coroutine patterns vs RxLifecycle DSL—the repo's Kotlin module exists but lacks usage examples.
• Add unit tests for edge case in AndroidLifecycleActivityTest: validate behavior when binding occurs during DESTROYED state—current tests cover START→STOP but not post-destruction subscription attempts.

• High · Outdated Gradle Build Tool — build.gradle (buildscript dependencies). The project uses Gradle 3.6.3 (classpath 'com.android.tools.build:gradle:3.6.3'), which is significantly outdated. Released in March 2020, this version has known vulnerabilities and lacks modern security features, dependency verification, and bug fixes. Fix: Update to the latest stable version of Android Gradle Plugin (currently 8.x). Review and test compatibility with the latest build tools.
• High · Outdated Kotlin Version — build.gradle (verKotlin = '1.3.72'). Kotlin version 1.3.72 is used, released in April 2020. This version is significantly outdated and may contain security vulnerabilities and lacks modern language features and compiler improvements. Fix: Update Kotlin to the latest stable version (2.x or current 1.9.x). Test all Kotlin code for compatibility.
• High · Severely Outdated Robolectric Testing Library — build.gradle (robolectric = 'org.robolectric:robolectric:3.8'). Robolectric 3.8 is used, which was released in 2018. This ancient version contains multiple known vulnerabilities and does not support modern Android APIs or testing practices. Fix: Update to Robolectric 4.x or 5.x (current stable). This is critical for test security and compatibility.
• Medium · Low Compilation SDK Version — build.gradle (compileSdkVersion = 28). The project compiles against SDK version 28 (Android 9), released in 2018. Modern Android development requires targeting more recent SDK versions to access security patches and modern API functionality. Fix: Update compileSdkVersion to at least 33+ (Android 13+) to meet current Google Play Store requirements and access latest security features.
• Medium · Java 7 Source Compatibility — build.gradle (sourceCompatibilityVersion = JavaVersion.VERSION_1_7, targetCompatibilityVersion = JavaVersion.VERSION_1_7). The project targets Java 7 (JavaVersion.VERSION_1_7) for source and target compatibility. Java 7 reached end-of-life in July 2019 and contains multiple known security vulnerabilities. Fix: Update minimum Java compatibility to Java 8 or higher. Consider Java 11+ for modern security standards.
• Medium · Low Minimum SDK Version — build.gradle (minSdkVersion = 14). The project supports minSdkVersion 14 (Android 4.0, released in 2011). Supporting such old API levels introduces security risks and limits access to modern Android security APIs. Fix: Increase minSdkVersion to at least 21 (Android 5.0+). Current Google Play standards recommend API 21 or higher.
• Medium · Outdated androidx.lifecycle Dependency — build.gradle (lifecycle = 'androidx.lifecycle:lifecycle-runtime:2.2.0'). androidx.lifecycle:lifecycle-runtime:2.2.0 and related lifecycle dependencies are from 2020 and contain multiple known vulnerabilities and missing security patches. Fix: Update to androidx.lifecycle:lifecycle-runtime:2.6.x or higher to receive the latest security patches and bug fixes.
• Low · Deprecated Android Maven Plugin — build.gradle (classpath 'com.github.dcendents:android-maven-gradle-plugin:2.1'). The project uses 'com.github.dcendents:android-maven-gradle-plugin:2.1', which is deprecated and no longer maintained. Modern publishing should use Gradle's native maven-publish plugin. Fix: Replace with Gradle's native 'maven-publish' plugin or use Gradle Module Metadata for modern dependency management.
• Low · Outdated JUnit Version — build.gradle (junit = 'junit:junit. JUnit 4.13 is used. While not critically vulnerable, newer versions (4.13.2+) contain important fixes and improvements. Fix: undefined

LLM-derived; treat as a starting point, not a security audit.

• Open issues — current backlog
• Recent PRs — what's actively shipping
• Source on GitHub

Generated by RepoPilot. Verdict based on maintenance signals — see the live page for receipts. Re-run on a new commit to refresh.