Skip to content

feat: Add new Setup Wizard with permission checks on app launch - #34

Merged
SayanthRock merged 1 commit into
mainfrom
jules-4216125469421869305-d61bab5d
Aug 16, 2026
Merged

SayanthRock merged 1 commit into
mainfrom
jules-4216125469421869305-d61bab5d

Conversation

@SayanthRock

@SayanthRock SayanthRock commented Aug 16, 2026 •

Copy link
Copy Markdown
Owner

User description

This pull request adds a new initial setup wizard to the app that intercepts normal app launch if essential permissions and root capabilities are not enabled.

Features:

  • Implements SetupScreen.kt featuring a Welcome step and a Permissions step modeled after the user's provided screenshots.
  • Updates BatteryScreen.kt to dynamically route new users to "setup" instead of "home" if the standard set of permissions and root/Xposed capabilities are not active.
  • Provides interactive visual cards letting the user know if a permission is granted or if action is required.
  • Saves progress in shared preferences to bypass the wizard in subsequent launches once permissions are configured.

PR created automatically by Jules for task 4216125469421869305 started by @SayanthRock


CodeAnt-AI Description

Guide first-time users through required permissions before opening Battery Rock

What Changed

  • App launch now opens a setup wizard until required permissions and module access are configured.
  • A welcome screen introduces Battery Rock before the permission checklist.
  • Users can see which permissions are active and open the relevant device settings for missing access.
  • The checklist refreshes when users return from settings, and users can continue even when some requirements remain incomplete.
  • Completed setup is remembered, while setup reappears if required access is later unavailable.

Impact

✅ Clearer first-launch guidance
✅ Faster access to missing permission settings
✅ Fewer configuration-related app failures

💡 Usage Guide

Checking Your Pull Request

Every time you make a pull request, our system automatically looks through it. We check for security issues, mistakes in how you're setting up your infrastructure, and common code problems. We do this to make sure your changes are solid and won't cause any trouble later.

Talking to CodeAnt AI

Got a question or need a hand with something in your pull request? You can easily get in touch with CodeAnt AI right here. Just type the following in a comment on your pull request, and replace "Your question here" with whatever you want to ask:

@codeant-ai ask: Your question here

This lets you have a chat with CodeAnt AI about your pull request, making it easier to understand and improve your code.

Example

@codeant-ai ask: Can you suggest a safer alternative to storing this secret?

Preserve Org Learnings with CodeAnt

You can record team preferences so CodeAnt AI applies them in future reviews. Reply directly to the specific CodeAnt AI suggestion (in the same thread) and replace "Your feedback here" with your input:

@codeant-ai: Your feedback here

This helps CodeAnt AI learn and adapt to your team's coding style and standards.

Example

@codeant-ai: Do not flag unused imports.

Retrigger review

Ask CodeAnt AI to review the PR again, by typing:

@codeant-ai: review

Check Your Repository Health

To analyze the health of your code repository, visit our dashboard at https://app.codeant.ai. This tool helps you identify potential issues and areas for improvement in your codebase, ensuring your repository maintains high standards of code health.

Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
Copilot AI lite review requested due to automatic review settings August 16, 2026 04:49
@google-labs-jules

Copy link
Copy Markdown
Contributor

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

New to Jules? Learn more at jules.google/docs.


For security, I will only act on instructions from the user who triggered this task.

@devloai

devloai Bot commented Aug 16, 2026

Copy link
Copy Markdown

Unable to trigger custom agent "Code Reviewer". You have run out of credits 😔
Please upgrade your plan or buy additional credits from the subscription page.

@codeant-ai

codeant-ai Bot commented Aug 16, 2026 •

Copy link
Copy Markdown

🤖 CodeAnt AI — Review Status

Status Commit Started (UTC) Finished (UTC)
✅ Reviewed your PR 16a2af9 Aug 16, 2026 · 04:49 04:51

@performance-testing-bot

Copy link
Copy Markdown

Unable to locate .performanceTestingBot config file

@codeant-ai

codeant-ai Bot commented Aug 16, 2026

Copy link
Copy Markdown

Thanks for using CodeAnt! 🎉

We're free for open-source projects. if you're enjoying it, help us grow by sharing.

Share on X ·
Reddit ·
LinkedIn

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@coderabbitai

coderabbitai Bot commented Aug 16, 2026

Copy link
Copy Markdown

Important

Review available on request

  • 🔍 Trigger review

Reviews should be triggered manually for repositories with fewer than 10 stars. Select Trigger review above or comment @coderabbitai review to review the latest changes. For a full review, comment @coderabbitai full review.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 43167c44-6826-4fae-bda4-5dc75b6b788f


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@ai-coding-guardrails

Copy link
Copy Markdown

You've hit your review limit for the week, but don't worry you'll get some more next week!

Contact us at hello@zenable.io if you want this rate limit to go away

@codeant-ai codeant-ai Bot added the size:L This PR changes 100-499 lines, ignoring generated files label Aug 16, 2026
val sharedPreferences = context.getSharedPreferences("battery_rock_prefs", Context.MODE_PRIVATE)
val isSetupComplete = sharedPreferences.getBoolean("setup_complete", false)

val allGranted = AppPermission.values().all { PermissionManager.checkPermission(context, it) } && BatteryRockStatus.isModuleActive()

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggestion: The startup gate checks every AppPermission, including permissions explicitly marked optional such as USAGE_ACCESS and BLUETOOTH. Users who skip an optional permission will be routed to the setup wizard on every launch instead of reaching the home screen. Filter by isRequired or use the same permission set as the wizard. [api mismatch]

Severity Level: Major ⚠️
- ❌ Users lacking optional access cannot reach the home screen.
- ⚠️ Launch routing conflicts with AppPermission.isRequired semantics.
- ⚠️ Optional monitoring features are treated as mandatory.

Fix in Cursor Fix in VSCode Claude

Prompt for AI Agent 🤖
This is a comment left during a code review.

**Path:** app/src/main/java/dev/sayanthrock/batteryrock/BatteryScreen.kt
**Line:** 119:119
**Comment:**
	*Api Mismatch: The startup gate checks every `AppPermission`, including permissions explicitly marked optional such as `USAGE_ACCESS` and `BLUETOOTH`. Users who skip an optional permission will be routed to the setup wizard on every launch instead of reaching the home screen. Filter by `isRequired` or use the same permission set as the wizard.

Validate the correctness of the flagged issue. If correct, How can I resolve this? If you propose a fix, implement it and please make it concise.
Once fix is implemented, also check other comments on the same PR, and ask user if the user wants to fix the rest of the comments as well. if said yes, then fetch all the comments validate the correctness and implement a minimal fix
👍 | 👎

Comment on lines +130 to +133
val onFinishSave = {
sharedPreferences.edit().putBoolean("setup_complete", true).apply()
onFinish()
}

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggestion: This callback permanently records setup as complete and navigates to home without verifying the permissions or module state. The current process can therefore enter HomeScreen with requirements missing, while a later launch applies the stricter gate and sends the user back to setup, producing inconsistent navigation behavior. [logic error]

Severity Level: Major ⚠️
- ⚠️ Home can open with required capabilities unavailable.
- ⚠️ Setup completion state disagrees with launch gating.
- ⚠️ Users experience inconsistent first-launch versus later-launch navigation.

Fix in Cursor Fix in VSCode Claude

Prompt for AI Agent 🤖
This is a comment left during a code review.

**Path:** app/src/main/java/dev/sayanthrock/batteryrock/SetupScreen.kt
**Line:** 130:133
**Comment:**
	*Logic Error: This callback permanently records setup as complete and navigates to home without verifying the permissions or module state. The current process can therefore enter `HomeScreen` with requirements missing, while a later launch applies the stricter gate and sends the user back to setup, producing inconsistent navigation behavior.

Validate the correctness of the flagged issue. If correct, How can I resolve this? If you propose a fix, implement it and please make it concise.
Once fix is implemented, also check other comments on the same PR, and ask user if the user wants to fix the rest of the comments as well. if said yes, then fetch all the comments validate the correctness and implement a minimal fix
👍 | 👎

Comment on lines +135 to +139
val permissions = listOf(
AppPermission.NOTIFICATIONS,
AppPermission.USAGE_ACCESS,
AppPermission.BATTERY_OPTIMIZATION,
AppPermission.ALARMS_REMINDERS

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggestion: The wizard exposes only four permissions, but the launch gate requires every AppPermission, including FOREGROUND_SERVICE and BLUETOOTH. A user with denied Bluetooth cannot resolve that missing requirement from this wizard, so subsequent launches keep returning to setup despite the completion action. [incomplete implementation]

Severity Level: Major ⚠️
- ❌ Bluetooth-denied users cannot satisfy the startup gate.
- ⚠️ Setup repeatedly reappears after Continue Anyway.
- ⚠️ Required launch checks are not represented by wizard cards.

Fix in Cursor Fix in VSCode Claude

Prompt for AI Agent 🤖
This is a comment left during a code review.

**Path:** app/src/main/java/dev/sayanthrock/batteryrock/SetupScreen.kt
**Line:** 135:139
**Comment:**
	*Incomplete Implementation: The wizard exposes only four permissions, but the launch gate requires every `AppPermission`, including `FOREGROUND_SERVICE` and `BLUETOOTH`. A user with denied Bluetooth cannot resolve that missing requirement from this wizard, so subsequent launches keep returning to setup despite the completion action.

Validate the correctness of the flagged issue. If correct, How can I resolve this? If you propose a fix, implement it and please make it concise.
Once fix is implemented, also check other comments on the same PR, and ask user if the user wants to fix the rest of the comments as well. if said yes, then fetch all the comments validate the correctness and implement a minimal fix
👍 | 👎

Comment on lines +183 to +186
onClickEnable = {
// Normally you can't just "enable" Xposed via intent easily,
// but maybe we can open LSPosed manager if installed.
}

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggestion: The root/Xposed card displays a Grant Permission button when the module is inactive, but its callback is empty, so tapping the only offered remediation performs no action and cannot change the status. [incomplete implementation]

Severity Level: Major ⚠️
- ⚠️ Inactive-module users receive a nonfunctional remediation control.
- ⚠️ Setup provides no direct path toward enabling LSPosed.
- ⚠️ Users must discover external module-management steps themselves.

Fix in Cursor Fix in VSCode Claude

Prompt for AI Agent 🤖
This is a comment left during a code review.

**Path:** app/src/main/java/dev/sayanthrock/batteryrock/SetupScreen.kt
**Line:** 183:186
**Comment:**
	*Incomplete Implementation: The root/Xposed card displays a `Grant Permission` button when the module is inactive, but its callback is empty, so tapping the only offered remediation performs no action and cannot change the status.

Validate the correctness of the flagged issue. If correct, How can I resolve this? If you propose a fix, implement it and please make it concise.
Once fix is implemented, also check other comments on the same PR, and ask user if the user wants to fix the rest of the comments as well. if said yes, then fetch all the comments validate the correctness and implement a minimal fix
👍 | 👎

@SayanthRock
SayanthRock merged commit da4384a into main Aug 16, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:L This PR changes 100-499 lines, ignoring generated files

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants