Skip to content

Fix separation of Plugin Store and Plugins Manager plugin #3572

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 46 commits into from
Jul 7, 2025

Conversation

Jack251970
Copy link
Member

@Jack251970 Jack251970 commented May 22, 2025

Add internal model for plugin management

Let us do not rely Plugin Manager plugin for plugin management in Flow Launcher. Flow Launcher will get into a very bad state if this plugin is deleted (plugin store page will lose ability to install/uninstall/update plugins).

Resolve #3555, #3236.

Flow supports to select local zip file to install in Plugin Store page.

API functions related to plugin management have return value to check if installation / uninstallation / update is successful.

Test

  • Install/Uninstall/Update plugins
  • Install plugin from local path in Plugin Store page
  • Install/Uninstall/Update the same plugin twice without restarting
image image

@Jack251970 Jack251970 linked an issue May 22, 2025 that may be closed by this pull request
2 tasks
@Jack251970 Jack251970 requested a review from Copilot May 22, 2025 09:36

This comment has been minimized.

Copy link

gitstream-cm bot commented May 22, 2025

🥷 Code experts: onesounds

onesounds has most 👩‍💻 activity in the files.
Jack251970, onesounds have most 🧠 knowledge in the files.

See details

Flow.Launcher.Infrastructure/UserSettings/Settings.cs

Activity based on git-commit:

onesounds
MAY 2 additions & 2 deletions
APR 104 additions & 38 deletions
MAR 10 additions & 0 deletions
FEB
JAN
DEC

Knowledge based on git-blame:
Jack251970: 26%
onesounds: 21%

Flow.Launcher/Languages/en.xaml

Activity based on git-commit:

onesounds
MAY 15 additions & 2 deletions
APR 45 additions & 23 deletions
MAR 8 additions & 3 deletions
FEB
JAN
DEC

Knowledge based on git-blame:
onesounds: 43%
Jack251970: 11%

Flow.Launcher/SettingPages/Views/SettingsPaneGeneral.xaml

Activity based on git-commit:

onesounds
MAY
APR 130 additions & 69 deletions
MAR 43 additions & 62 deletions
FEB
JAN
DEC

Knowledge based on git-blame:
onesounds: 62%
Jack251970: 13%

Flow.Launcher/ViewModel/PluginStoreItemViewModel.cs

Activity based on git-commit:

onesounds
MAY
APR
MAR
FEB
JAN
DEC

Knowledge based on git-blame:
onesounds: 36%

Flow.Launcher/ViewModel/PluginViewModel.cs

Activity based on git-commit:

onesounds
MAY
APR
MAR 13 additions & 1 deletions
FEB
JAN
DEC

Knowledge based on git-blame:
Jack251970: 43%

To learn more about /:\ gitStream - Visit our Docs

Copy link

gitstream-cm bot commented May 22, 2025

Be a legend 🏆 by adding a before and after screenshot of the changes you made, especially if they are around UI/UX.

Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This PR introduces an internal model for plugin management to remove the dependency on the external Plugin Manager plugin, thereby preventing Flow Launcher from entering a bad state when that plugin is deleted.

  • Refactored the deletion command in PluginViewModel to use an internal uninstall method.
  • Updated PluginStoreItemViewModel with new async methods for installing, uninstalling, and updating plugins, and refactored plugin properties.
  • Added a new user setting with corresponding UI and language translation keys for automatically restarting Flow Launcher after plugin changes.

Reviewed Changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
Flow.Launcher/ViewModel/PluginViewModel.cs Removed PluginManagerActionKeyword and updated delete plugin command to use the internal model.
Flow.Launcher/ViewModel/PluginStoreItemViewModel.cs Refactored plugin data handling and introduced async plugin management methods (install, uninstall, update).
Flow.Launcher/SettingPages/Views/SettingsPaneGeneral.xaml Added a card to toggle the new auto restart setting.
Flow.Launcher/Languages/en.xaml Added new translation keys for plugin management messages and auto restart functionality.
Flow.Launcher/Infrastructure/UserSettings/Settings.cs Introduced a new AutoRestartAfterChanging setting.
Comments suppressed due to low confidence (1)

Flow.Launcher/ViewModel/PluginStoreItemViewModel.cs:26

  • [nitpick] Consider renaming '_newPlugin' to 'currentPlugin' and '_oldPluginPair' to 'installedPluginPair' for clearer understanding.
            _newPlugin = plugin;

@Jack251970 Jack251970 added this to the Future milestone May 22, 2025
@Jack251970 Jack251970 added the bug Something isn't working label May 22, 2025
Co-authored-by: Copilot <[email protected]>
Copy link
Contributor

coderabbitai bot commented May 22, 2025

📝 Walkthrough
## Walkthrough

This update introduces a new static `PluginInstaller` class to handle plugin installation, updating, and uninstallation with user prompts, error handling, and restart logic. It adds related UI toggles and localization strings, refactors plugin store and view models for improved async handling and null safety, and enhances plugin ZIP validation and source checking.

## Changes

| File(s)                                                                 | Change Summary                                                                                                                      |
|-------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------|
| Flow.Launcher.Core/Plugin/PluginInstaller.cs                            | Introduced `PluginInstaller` static class for unified, async plugin lifecycle management with user prompts and error handling.       |
| Flow.Launcher.Infrastructure/UserSettings/Settings.cs                   | Added `AutoRestartAfterChanging` and `ShowUnknownSourceWarning` boolean settings with defaults.                                     |
| Flow.Launcher/Languages/en.xaml                                         | Added localization strings for plugin management actions, warnings, confirmations, and tooltips.                                    |
| Flow.Launcher/SettingPages/Views/SettingsPaneGeneral.xaml               | Added UI toggle switches for new plugin management settings.                                                                        |
| Flow.Launcher/SettingPages/Views/SettingsPanePluginStore.xaml           | Added button for local plugin installation with tooltip.                                                                            |
| Flow.Launcher/SettingPages/ViewModels/SettingsPanePluginStoreViewModel.cs| Added `InstallPluginAsync` command for local plugin installation via file dialog.                                                   |
| Flow.Launcher/ViewModel/PluginStoreItemViewModel.cs                     | Refactored for null safety, async command handling, and use of `PluginInstaller`.                                                   |
| Flow.Launcher/ViewModel/PluginViewModel.cs                              | Refactored delete plugin method to async, removed unused property/imports, now uses `PluginInstaller`.                              |
| Plugins/Flow.Launcher.Plugin.PluginsManager/PluginsManager.cs           | Improved plugin ZIP validation, added error result for invalid ZIPs, enhanced source URL checking.                                  |
| Plugins/Flow.Launcher.Plugin.PluginsManager/Utilities.cs                | Simplified plugin.json extraction from ZIP archives.                                                                                |
| Plugins/Flow.Launcher.Plugin.PluginsManager/Languages/en.xaml           | Added localized error messages for invalid ZIP installer files.                                                                     |
| Flow.Launcher/ViewModel/SelectBrowserViewModel.cs                       | Removed unused using directive.                                                                                                     |
| Flow.Launcher.Core/Plugin/PluginManager.cs                              | Changed plugin install/uninstall methods to return success flags and show error messages instead of throwing exceptions.            |
| Flow.Launcher/App.xaml.cs                                               | Added async call to update plugin manifest before plugin initialization on app startup.                                              |

## Sequence Diagram(s)

```mermaid
sequenceDiagram
    participant User
    participant UI (Settings/Plugin Store)
    participant PluginInstaller
    participant API
    participant PluginManager

    User->>UI (Settings/Plugin Store): Initiates plugin install/update/uninstall
    UI (Settings/Plugin Store)->>PluginInstaller: Calls async method (Install/Update/Uninstall)
    PluginInstaller->>API: Show confirmation dialog (if needed)
    API-->>PluginInstaller: User response
    PluginInstaller->>PluginManager: Perform operation (install/update/uninstall)
    PluginManager-->>PluginInstaller: Operation result
    PluginInstaller->>API: Show result, prompt for restart (if needed)
    API-->>User: Displays message and/or triggers restart

Assessment against linked issues

Objective Addressed Explanation
Fix NullReferenceException in PluginStoreItemViewModel when executing plugin actions (#3555)

Assessment against linked issues: Out-of-scope changes

Code Change Explanation
Addition of UI toggles and settings for auto-restart and unknown source warnings (Settings.cs, SettingsPaneGeneral.xaml) These settings and related UI are not mentioned in the linked issue and are unrelated to the specific bug fix.
Addition of local plugin installation button and command (SettingsPanePluginStore.xaml, SettingsPanePluginStoreViewModel.cs) Local installation feature is not referenced in the linked issue and is outside its scope.
Addition of new localization strings for plugin management (en.xaml files) While related to plugin management, these strings are not required for the bug fix in #3555.
Enhanced plugin ZIP validation and error reporting (PluginsManager.cs, Utilities.cs, en.xaml) These changes improve robustness but are not directly related to the NullReferenceException fix.
Changes to plugin install/uninstall methods in PluginManager.cs to use success flags and user messages instead of exceptions These are broader error handling improvements not specifically required by the linked issue.

Possibly related PRs




</details>

<!-- walkthrough_end -->


---

<details>
<summary>📜 Recent review details</summary>

**Configuration used: CodeRabbit UI**
**Review profile: CHILL**
**Plan: Pro**


<details>
<summary>📥 Commits</summary>

Reviewing files that changed from the base of the PR and between a63c8b036bd4c29dd0355b39ccadeda5381f7880 and 236bff1c109c359905a1d416da04a5a00d6840df.

</details>

<details>
<summary>📒 Files selected for processing (2)</summary>

* `.github/actions/spelling/expect.txt` (1 hunks)
* `Flow.Launcher.Plugin/Interfaces/IPublicAPI.cs` (13 hunks)

</details>

<details>
<summary>✅ Files skipped from review due to trivial changes (1)</summary>

* Flow.Launcher.Plugin/Interfaces/IPublicAPI.cs

</details>

<details>
<summary>🚧 Files skipped from review as they are similar to previous changes (1)</summary>

* .github/actions/spelling/expect.txt

</details>

<details>
<summary>⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)</summary>

* GitHub Check: build

</details>

</details>
<!-- internal state start -->


<!-- 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= -->

<!-- internal state end -->
<!-- finishing_touch_checkbox_start -->

<details open="true">
<summary>✨ Finishing Touches</summary>

- [ ] <!-- {"checkboxId": "7962f53c-55bc-4827-bfbf-6a18da830691"} --> 📝 Generate Docstrings

</details>

<!-- finishing_touch_checkbox_end -->
<!-- tips_start -->

---

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.

<details>
<summary>❤️ Share</summary>

- [X](https://twitter.com/intent/tweet?text=I%20just%20used%20%40coderabbitai%20for%20my%20code%20review%2C%20and%20it%27s%20fantastic%21%20It%27s%20free%20for%20OSS%20and%20offers%20a%20free%20trial%20for%20the%20proprietary%20code.%20Check%20it%20out%3A&url=https%3A//coderabbit.ai)
- [Mastodon](https://mastodon.social/share?text=I%20just%20used%20%40coderabbitai%20for%20my%20code%20review%2C%20and%20it%27s%20fantastic%21%20It%27s%20free%20for%20OSS%20and%20offers%20a%20free%20trial%20for%20the%20proprietary%20code.%20Check%20it%20out%3A%20https%3A%2F%2Fcoderabbit.ai)
- [Reddit](https://www.reddit.com/submit?title=Great%20tool%20for%20code%20review%20-%20CodeRabbit&text=I%20just%20used%20CodeRabbit%20for%20my%20code%20review%2C%20and%20it%27s%20fantastic%21%20It%27s%20free%20for%20OSS%20and%20offers%20a%20free%20trial%20for%20proprietary%20code.%20Check%20it%20out%3A%20https%3A//coderabbit.ai)
- [LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fcoderabbit.ai&mini=true&title=Great%20tool%20for%20code%20review%20-%20CodeRabbit&summary=I%20just%20used%20CodeRabbit%20for%20my%20code%20review%2C%20and%20it%27s%20fantastic%21%20It%27s%20free%20for%20OSS%20and%20offers%20a%20free%20trial%20for%20proprietary%20code)

</details>

<details>
<summary>🪧 Tips</summary>

### Chat

There are 3 ways to chat with [CodeRabbit](https://coderabbit.ai?utm_source=oss&utm_medium=github&utm_campaign=Flow-Launcher/Flow.Launcher&utm_content=3572):

- Review comments: Directly reply to a review comment made by CodeRabbit. Example:
  - `I pushed a fix in commit <commit_id>, please review it.`
  - `Explain this complex logic.`
  - `Open a follow-up GitHub issue for this discussion.`
- Files and specific lines of code (under the "Files changed" tab): Tag `@coderabbitai` in a new review comment at the desired location with your query. Examples:
  - `@coderabbitai explain this code block.`
  -	`@coderabbitai modularize this function.`
- PR comments: Tag `@coderabbitai` in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
  - `@coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.`
  - `@coderabbitai read src/utils.ts and explain its main purpose.`
  - `@coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.`
  - `@coderabbitai help me debug CodeRabbit configuration file.`

### Support

Need help? Create a ticket on our [support page](https://www.coderabbit.ai/contact-us/support) for assistance with any issues or questions.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

### CodeRabbit Commands (Invoked using PR comments)

- `@coderabbitai pause` to pause the reviews on a PR.
- `@coderabbitai resume` to resume the paused reviews.
- `@coderabbitai review` to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
- `@coderabbitai full review` to do a full review from scratch and review all the files again.
- `@coderabbitai summary` to regenerate the summary of the PR.
- `@coderabbitai generate docstrings` to [generate docstrings](https://docs.coderabbit.ai/finishing-touches/docstrings) for this PR.
- `@coderabbitai generate sequence diagram` to generate a sequence diagram of the changes in this PR.
- `@coderabbitai resolve` resolve all the CodeRabbit review comments.
- `@coderabbitai configuration` to show the current CodeRabbit configuration for the repository.
- `@coderabbitai help` to get help.

### Other keywords and placeholders

- Add `@coderabbitai ignore` anywhere in the PR description to prevent this PR from being reviewed.
- Add `@coderabbitai summary` to generate the high-level summary at a specific location in the PR description.
- Add `@coderabbitai` anywhere in the PR title to generate the title automatically.

### CodeRabbit Configuration File (`.coderabbit.yaml`)

- You can programmatically configure CodeRabbit by adding a `.coderabbit.yaml` file to the root of your repository.
- Please see the [configuration documentation](https://docs.coderabbit.ai/guides/configure-coderabbit) for more information.
- If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: `# yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json`

### Documentation and Community

- Visit our [Documentation](https://docs.coderabbit.ai) for detailed information on how to use CodeRabbit.
- Join our [Discord Community](http://discord.gg/coderabbit) to get help, request features, and share feedback.
- Follow us on [X/Twitter](https://twitter.com/coderabbitai) for updates and announcements.

</details>

<!-- tips_end -->

This comment has been minimized.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 4

♻️ Duplicate comments (1)
Flow.Launcher/ViewModel/PluginStoreItemViewModel.cs (1)

160-197: Mirror the ‘restart-on-error’ fix in Uninstall flow

Same unconditional restart occurs here. Insert an early return inside catch, or capture a success flag shared with the final block.

🧹 Nitpick comments (3)
Flow.Launcher/ViewModel/PluginStoreItemViewModel.cs (3)

119-137: Partial download artefact not cleaned when user cancels

When the user presses “Cancel” in the progress box the temp zip (possibly half-written) is left on disk, and the next install run deletes only if deleteFile is true and the filename collides. Consider explicit cleanup on cancellation:

if (cts.IsCancellationRequested)
{
-    return;
+    if (!newPlugin.IsFromLocalInstallPath && File.Exists(filePath))
+        File.Delete(filePath);
+    return;
}

199-254: Update flow: stale zip file not deleted after successful update

UpdatePluginAsync downloads to %TEMP% but never deletes the zip afterwards (unlike install). This can quickly clutter %TEMP% with large archives.

@@
                 else
                 {
                     await App.API.UpdatePluginAsync(oldPlugin, newPlugin, filePath);
+                    if (!newPlugin.IsFromLocalInstallPath && File.Exists(filePath))
+                        File.Delete(filePath);
                 }

256-289: Download helper: typo and double-download logic

  1. Comment line 269 spells “expcetion”.
  2. When the progress box fails, we silently fall back to a background download without progress or user feedback. Confirm this is desired UX; otherwise surface the error.

Consider surfacing the original exception to the caller instead of a silent retry.

🧰 Tools
🪛 GitHub Check: Check Spelling

[warning] 264-264:
prg is not a recognized word. (unrecognized-spelling)

🪛 GitHub Actions: Check Spelling

[warning] 264-264: Spell check warning: prg is not a recognized word. (unrecognized-spelling)

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between ac61469 and 949344a.

📒 Files selected for processing (5)
  • Flow.Launcher.Infrastructure/UserSettings/Settings.cs (1 hunks)
  • Flow.Launcher/Languages/en.xaml (2 hunks)
  • Flow.Launcher/SettingPages/Views/SettingsPaneGeneral.xaml (1 hunks)
  • Flow.Launcher/ViewModel/PluginStoreItemViewModel.cs (3 hunks)
  • Flow.Launcher/ViewModel/PluginViewModel.cs (2 hunks)
🧰 Additional context used
🪛 GitHub Actions: Check Spelling
Flow.Launcher/ViewModel/PluginViewModel.cs

[warning] 17-17: Spell check warning: Ioc is not a recognized word. (unrecognized-spelling)

Flow.Launcher/ViewModel/PluginStoreItemViewModel.cs

[warning] 19-19: Spell check warning: Ioc is not a recognized word. (unrecognized-spelling)


[warning] 264-264: Spell check warning: prg is not a recognized word. (unrecognized-spelling)

🪛 GitHub Check: Check Spelling
Flow.Launcher/ViewModel/PluginStoreItemViewModel.cs

[warning] 19-19:
Ioc is not a recognized word. (unrecognized-spelling)


[warning] 264-264:
prg is not a recognized word. (unrecognized-spelling)

⏰ Context from checks skipped due to timeout of 90000ms (5)
  • GitHub Check: gitStream workflow automation
  • GitHub Check: gitStream workflow automation
  • GitHub Check: gitStream.cm
  • GitHub Check: gitStream.cm
  • GitHub Check: build
🔇 Additional comments (7)
Flow.Launcher.Infrastructure/UserSettings/Settings.cs (1)

179-179: Good addition of the auto-restart setting

The new AutoRestartAfterChanging property with a default value of false is a good addition that will help control the application's restart behavior after plugin changes.

Flow.Launcher/SettingPages/Views/SettingsPaneGeneral.xaml (1)

205-214: Well-structured UI control for auto-restart setting

The toggle switch for the auto-restart setting is properly implemented with:

  • Appropriate binding to the Settings.AutoRestartAfterChanging property
  • Localized title and tooltip
  • Consistent styling with other toggle switches
  • Good positioning in the settings hierarchy

This follows the established pattern for settings controls in the application.

Flow.Launcher/ViewModel/PluginViewModel.cs (2)

1-1: Appropriate addition of Task namespace

The addition of the System.Threading.Tasks namespace is necessary for the async implementation.


173-175: Good conversion to async uninstall method

Converting the plugin uninstall operation to an asynchronous method is a good improvement that:

  1. Properly uses async/await pattern
  2. Leverages the centralized uninstall method from PluginStoreItemViewModel
  3. Supports the PR objective of creating an internal model for plugin management

This change will make the plugin uninstallation process more robust.

Flow.Launcher/Languages/en.xaml (2)

134-135: Well-defined localization strings for auto-restart setting

The localization strings for the auto-restart feature are clear and descriptive, explaining both the purpose of the setting and its effects.


189-204: Comprehensive localization for plugin management

This set of localization strings provides thorough coverage for the plugin management workflow:

  • Error messages for installation/uninstallation/updating failures
  • Success messages with restart instructions
  • Confirmation prompts with plugin details
  • Settings preservation options
  • Download progress indicators

These strings will ensure a good user experience with appropriate feedback throughout the plugin management process.

Flow.Launcher/ViewModel/PluginStoreItemViewModel.cs (1)

98-106: Generated filename may contain invalid path characters

newPlugin.Name can legally contain : or other characters invalid on Windows, making Path.Combine throw.
Sanitise the name (use Path.GetInvalidFileNameChars()) before composing the filename.

This comment has been minimized.

@Jack251970 Jack251970 requested a review from Copilot May 22, 2025 09:41

This comment has been minimized.

Copilot

This comment was marked as outdated.

This comment has been minimized.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 0

♻️ Duplicate comments (1)
Flow.Launcher/ViewModel/PluginStoreItemViewModel.cs (1)

32-33: Version parsing remains a potential exception source.

This addresses a previous review concern about new Version(string) throwing exceptions on malformed version strings. The issue persists in the current implementation.

Consider using safe version parsing to prevent UI crashes:

-        public bool LabelUpdate => LabelInstalled && new Version(_newPlugin.Version) > new Version(_oldPluginPair.Metadata.Version);
+        public bool LabelUpdate => LabelInstalled && TryParseVersionComparison(_newPlugin.Version, _oldPluginPair.Metadata.Version);
+        
+        private static bool TryParseVersionComparison(string newVersion, string oldVersion)
+        {
+            return Version.TryParse(newVersion, out var newVer) && 
+                   Version.TryParse(oldVersion, out var oldVer) && 
+                   newVer > oldVer;
+        }
🧹 Nitpick comments (1)
Flow.Launcher.Core/Plugin/PluginManager.cs (1)

871-904: Fix spelling issues in parameter name and comment.

The download helper method is well-designed with progress reporting and retry logic, but has spelling issues flagged by static analysis.

Apply this diff to fix the spelling issues:

-        internal static async Task DownloadFileAsync(string prgBoxTitle, string downloadUrl, string filePath, CancellationTokenSource cts, bool deleteFile = true, bool showProgress = true)
+        internal static async Task DownloadFileAsync(string progressBoxTitle, string downloadUrl, string filePath, CancellationTokenSource cts, bool deleteFile = true, bool showProgress = true)
         {
             if (deleteFile && File.Exists(filePath))
                 File.Delete(filePath);
 
             if (showProgress)
             {
                 var exceptionHappened = false;
-                await API.ShowProgressBoxAsync(prgBoxTitle,
+                await API.ShowProgressBoxAsync(progressBoxTitle,
                     async (reportProgress) =>
                     {
                         if (reportProgress == null)
                         {
-                            // when reportProgress is null, it means there is expcetion with the progress box
+                            // when reportProgress is null, it means there is exception with the progress box
                             // so we record it with exceptionHappened and return so that progress box will close instantly
                             exceptionHappened = true;
                             return;
🧰 Tools
🪛 GitHub Check: Check Spelling

[warning] 879-879:
prg is not a recognized word. (unrecognized-spelling)

🪛 GitHub Actions: Check Spelling

[warning] 879-883: prg is not a recognized word. (unrecognized-spelling)

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 76736b7 and 383c0ae.

📒 Files selected for processing (3)
  • Flow.Launcher.Core/Plugin/PluginManager.cs (4 hunks)
  • Flow.Launcher/ViewModel/PluginStoreItemViewModel.cs (4 hunks)
  • Flow.Launcher/ViewModel/PluginViewModel.cs (2 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
  • Flow.Launcher/ViewModel/PluginViewModel.cs
🧰 Additional context used
🧬 Code Graph Analysis (1)
Flow.Launcher.Core/Plugin/PluginManager.cs (5)
Flow.Launcher.Infrastructure/UserSettings/Settings.cs (1)
  • Settings (16-478)
Plugins/Flow.Launcher.Plugin.PluginsManager/Utilities.cs (1)
  • UserPlugin (62-80)
Flow.Launcher.Plugin/Interfaces/IPublicAPI.cs (8)
  • GetTranslation (136-136)
  • MessageBoxResult (366-366)
  • InstallPlugin (511-511)
  • LogException (276-276)
  • ShowMsgError (85-85)
  • RestartApp (34-34)
  • ShowMsg (114-114)
  • ShowMsg (123-123)
Flow.Launcher.Core/Resource/Internationalization.cs (1)
  • GetTranslation (247-259)
Flow.Launcher.Plugin/PluginMetadata.cs (1)
  • PluginMetadata (10-163)
🪛 GitHub Check: Check Spelling
Flow.Launcher.Core/Plugin/PluginManager.cs

[warning] 879-879:
prg is not a recognized word. (unrecognized-spelling)

🪛 GitHub Actions: Check Spelling
Flow.Launcher.Core/Plugin/PluginManager.cs

[warning] 39-53: Ioc is not a recognized word. (unrecognized-spelling)


[warning] 117-133: Reloadable is not a recognized word. (unrecognized-spelling)


[warning] 179-183: metadatas is not a recognized word. (unrecognized-spelling)


[warning] 181-185: metadatas is not a recognized word. (unrecognized-spelling)


[warning] 182-186: metadatas is not a recognized word. (unrecognized-spelling)


[warning] 184-188: metadatas is not a recognized word. (unrecognized-spelling)


[warning] 879-883: prg is not a recognized word. (unrecognized-spelling)

⏰ Context from checks skipped due to timeout of 90000ms (1)
  • GitHub Check: build
🔇 Additional comments (6)
Flow.Launcher.Core/Plugin/PluginManager.cs (4)

28-28: LGTM: FlowSettings integration looks good.

The static field retrieval of Settings via IoC is appropriate here since PluginManager is a static class and the settings are used for runtime behavior control.


553-624: Excellent async plugin installation with comprehensive user experience.

The method provides:

  • User confirmation before proceeding
  • Progress reporting during download with cancellation support
  • Proper error handling with early return on failure (prevents unwanted restart)
  • Conditional restart based on user settings
  • Clean file management for temporary downloads

626-664: Well-implemented uninstall flow with proper user choices.

The method correctly:

  • Confirms the uninstall action with the user
  • Provides choice for keeping/removing plugin settings
  • Handles errors gracefully without restarting on failure
  • Follows consistent UX pattern with other plugin operations

666-722: Robust update implementation following established patterns.

The update flow properly handles the two-plugin scenario (old and new) and maintains consistency with install/uninstall operations regarding user confirmation, error handling, and restart behavior.

Flow.Launcher/ViewModel/PluginStoreItemViewModel.cs (2)

12-18: Excellent refactoring improves code clarity and separation of concerns.

The split into _newPlugin and _oldPluginPair fields makes the code more readable and eliminates repeated lookups. The constructor properly initializes both fields for consistent state.


63-79: Async conversion successfully integrates with new plugin management workflow.

The method correctly dispatches to the appropriate async PluginManager methods based on the action. The developer has chosen to keep the default case minimal as noted in past reviews.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 0

🧹 Nitpick comments (2)
Flow.Launcher.Core/Plugin/PluginInstaller.cs (2)

52-54: Consider using a more descriptive filename for versionless plugins.

The Guid-based filename works but makes debugging harder. Consider using a timestamp or plugin ID instead.

var downloadFilename = string.IsNullOrEmpty(newPlugin.Version)
-   ? $"{newPlugin.Name}-{Guid.NewGuid()}.zip"
+   ? $"{newPlugin.Name}-{DateTime.Now:yyyyMMdd-HHmmss}.zip"
    : $"{newPlugin.Name}-{newPlugin.Version}.zip";

335-351: Improve URL parsing robustness.

The URL parsing logic assumes a specific GitHub URL format and may fail with variations like trailing slashes, different protocols, or query parameters.

Consider using Uri parsing for better robustness:

-var pieces = url.Split('/');
-
-if (pieces.Length < 4)
-    return false;
-
-var author = pieces[3];
-var acceptedHost = "github.com";
-var acceptedSource = "https://github.com";
-var constructedUrlPart = string.Format("{0}/{1}/", acceptedSource, author);
-
-if (!Uri.TryCreate(url, UriKind.Absolute, out var uri) || uri.Host != acceptedHost)
+if (!Uri.TryCreate(url, UriKind.Absolute, out var uri) || uri.Host != "github.com")
     return false;

+var pathSegments = uri.AbsolutePath.Trim('/').Split('/');
+if (pathSegments.Length < 2)
+    return false;
+
+var author = pathSegments[0];
+var constructedUrlPart = $"https://github.com/{author}/";
📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between edb1450 and a63c8b0.

📒 Files selected for processing (6)
  • .github/actions/spelling/expect.txt (1 hunks)
  • .github/actions/spelling/patterns.txt (1 hunks)
  • Flow.Launcher.Core/Plugin/PluginInstaller.cs (1 hunks)
  • Flow.Launcher.Core/Plugin/PluginManager.cs (5 hunks)
  • Flow.Launcher/ProgressBoxEx.xaml.cs (2 hunks)
  • Plugins/Flow.Launcher.Plugin.PluginsManager/PluginsManager.cs (18 hunks)
✅ Files skipped from review due to trivial changes (3)
  • .github/actions/spelling/expect.txt
  • .github/actions/spelling/patterns.txt
  • Flow.Launcher/ProgressBoxEx.xaml.cs
🚧 Files skipped from review as they are similar to previous changes (2)
  • Plugins/Flow.Launcher.Plugin.PluginsManager/PluginsManager.cs
  • Flow.Launcher.Core/Plugin/PluginManager.cs
🧰 Additional context used
🧠 Learnings (2)
📓 Common learnings
Learnt from: Jack251970
PR: Flow-Launcher/Flow.Launcher#3572
File: Flow.Launcher/App.xaml.cs:214-216
Timestamp: 2025-07-06T12:21:37.927Z
Learning: In Flow Launcher, the UpdatePluginManifestAsync method in PluginsManifest.cs already has comprehensive internal try-catch handling that logs exceptions and returns false on failure rather than throwing, making external try-catch wrappers unnecessary.
Flow.Launcher.Core/Plugin/PluginInstaller.cs (7)
Learnt from: Jack251970
PR: Flow-Launcher/Flow.Launcher#3572
File: Flow.Launcher/App.xaml.cs:214-216
Timestamp: 2025-07-06T12:21:37.927Z
Learning: In Flow Launcher, the UpdatePluginManifestAsync method in PluginsManifest.cs already has comprehensive internal try-catch handling that logs exceptions and returns false on failure rather than throwing, making external try-catch wrappers unnecessary.
Learnt from: Jack251970
PR: Flow-Launcher/Flow.Launcher#3791
File: Flow.Launcher.Core/Plugin/PluginManager.cs:293-295
Timestamp: 2025-07-01T05:46:13.251Z
Learning: In Flow.Launcher.Core/Plugin/PluginManager.cs, when checking if a plugin is modified within the PluginManager class itself, prefer using the internal static PluginModified(string id) method directly rather than going through API.PluginModified() for better performance and architectural design.
Learnt from: Jack251970
PR: Flow-Launcher/Flow.Launcher#3572
File: Flow.Launcher/Helper/PluginInstallationHelper.cs:251-252
Timestamp: 2025-06-29T08:31:07.816Z
Learning: In Flow Launcher's PluginInstallationHelper, when the progress box encounters an exception during download (indicated by reportProgress becoming null), the retry logic intentionally downloads without a progress handler to avoid repeating the same progress reporting failure. This prevents cascading exceptions in the progress reporting mechanism.
Learnt from: Yusyuriv
PR: Flow-Launcher/Flow.Launcher#3057
File: Flow.Launcher.Core/Plugin/JsonRPCPluginSettings.cs:0-0
Timestamp: 2024-11-03T07:40:11.014Z
Learning: In Flow Launcher, when using Windows Forms dialogs (e.g., in `JsonRPCPluginSettings.cs`), path validation is enabled by default in `OpenFileDialog` and `FolderBrowserDialog`, preventing users from selecting invalid paths, but it's possible to opt out of this validation on individual dialogs.
Learnt from: taooceros
PR: Flow-Launcher/Flow.Launcher#2616
File: Flow.Launcher/Flow.Launcher.csproj:7-7
Timestamp: 2024-10-08T15:52:58.573Z
Learning: In the Flow Launcher project, the version number in the `Flow.Launcher.csproj` file is dynamically updated during the CI/CD process.
Learnt from: jjw24
PR: Flow-Launcher/Flow.Launcher#2448
File: Plugins/Flow.Launcher.Plugin.Sys/ThemeSelector.cs:16-20
Timestamp: 2025-01-18T10:10:18.414Z
Learning: In Flow Launcher's plugin system, the PluginInitContext parameter passed to plugin constructors is guaranteed to be non-null by the plugin initialization system, making null checks unnecessary.
Learnt from: jjw24
PR: Flow-Launcher/Flow.Launcher#3081
File: Flow.Launcher.Core/Plugin/JsonRPCPluginV2.cs:136-145
Timestamp: 2025-02-22T23:51:54.010Z
Learning: In Flow.Launcher JsonRPCV2 plugins, the `reload_data` method is optional for plugins to implement. When the method is not found (RemoteMethodNotFoundException), it should be silently caught without logging as this is an expected scenario.
🧬 Code Graph Analysis (1)
Flow.Launcher.Core/Plugin/PluginInstaller.cs (3)
Plugins/Flow.Launcher.Plugin.PluginsManager/PluginsManager.cs (3)
  • Task (90-206)
  • Task (208-241)
  • Task (825-842)
Flow.Launcher.Plugin/Interfaces/IPublicAPI.cs (11)
  • Task (73-73)
  • Task (237-237)
  • PluginModified (539-539)
  • ShowMsgError (85-85)
  • GetTranslation (171-171)
  • MessageBoxResult (416-416)
  • InstallPlugin (566-566)
  • LogException (311-311)
  • RestartApp (34-34)
  • ShowMsg (128-128)
  • ShowMsg (137-137)
Plugins/Flow.Launcher.Plugin.PluginsManager/Utilities.cs (1)
  • UserPlugin (62-78)
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)
  • GitHub Check: build
🔇 Additional comments (5)
Flow.Launcher.Core/Plugin/PluginInstaller.cs (5)

15-27: Well-structured class initialization.

The lazy initialization pattern for the API and the explanatory comment about avoiding static constructor initialization is excellent. This prevents potential circular dependency issues.


119-158: Robust zip validation and security checking.

The zip file validation, plugin.json extraction, and unknown source warning implementation are well-designed. The existing try-catch properly handles all deserialization failures.


160-213: Well-implemented uninstall workflow.

The method properly handles user confirmations, plugin settings removal choice, and restart logic. The error handling is comprehensive.


215-278: Consistent update workflow implementation.

The update method maintains the same high-quality patterns as the install method, with proper confirmation dialogs, error handling, and restart logic.


295-317: Sophisticated progress reporting with appropriate retry logic.

The progress reporting failure handling and retry mechanism is well-designed. The retry without progress handler prevents cascading exceptions when progress reporting fails, which aligns with the established pattern in the codebase.

@jjw24 jjw24 changed the title Add internal model for plugin management Fix separation of Plugin Store and Plugins Manager plugin Jul 7, 2025
@jjw24 jjw24 removed enhancement New feature or request review in progress Indicates that a review is in progress for this PR Documentation Update required to documentation 20 min review labels Jul 7, 2025
@jjw24 jjw24 enabled auto-merge July 7, 2025 11:58
@coderabbitai coderabbitai bot added the enhancement New feature or request label Jul 7, 2025
@jjw24 jjw24 removed the enhancement New feature or request label Jul 7, 2025
@jjw24 jjw24 merged commit 0f510b1 into dev Jul 7, 2025
5 of 6 checks passed
@jjw24 jjw24 deleted the plugin_store_item_vm_null branch July 7, 2025 12:17
TBM13 pushed a commit to TBM13/Flow.Launcher that referenced this pull request Jul 8, 2025
…_item_vm_null

Fix separation of Plugin Store and Plugins Manager plugin
@jjw24 jjw24 modified the milestones: 2.0.0, 1.20.2 Jul 13, 2025
jjw24 added a commit that referenced this pull request Jul 13, 2025
Fix separation of Plugin Store and Plugins Manager plugin
jjw24 added a commit that referenced this pull request Jul 13, 2025
jjw24 added a commit that referenced this pull request Jul 13, 2025
Fix separation of Plugin Store and Plugins Manager plugin
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug Something isn't working Code Refactor
Projects
None yet
2 participants