1.0.0 Alpha 2

- **Overview auto-scan on tool-window open** — no longer walks every module `.php`/`.tpl` when the XOOPS Support tool window is created. That path froze multi-project monorepo boot (high disk I/O / power). Default is idle until **Refresh**.
- Setting **Auto-scan project when Overview tool window opens** (off by default) for users who want the old behaviour.
- Background scan tasks are **cancellable**; the filesystem scanner calls `ProgressManager.checkCanceled()` between modules and files.

Author: mambax7

CHANGELOG.md

@@ -6,6 +6,18 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project uses [Semantic Versioning](https://semver.org/) with pre-release tags
 (`1.0.0-alpha.N`).
 
+## [1.0.0-alpha.2] — 1.0.0 Alpha 2 — 2026-08-12
+
+### Fixed
+
+- **Overview auto-scan on tool-window open** — no longer walks every module `.php`/`.tpl` when the XOOPS Support tool window is created. That path froze multi-project monorepo boot (high disk I/O / power). Default is idle until **Refresh**.
+- Setting **Auto-scan project when Overview tool window opens** (off by default) for users who want the old behaviour.
+- Background scan tasks are **cancellable**; the filesystem scanner calls `ProgressManager.checkCanceled()` between modules and files.
+
+### Changed
+
+- **Inspection tree placement** — all XOOPS inspections use top-level group **XOOPS** in Settings → Editor → Inspections (removed `groupPath="PHP"` so they are not buried under PHP → XOOPS).
+
 ## [1.0.0-alpha.1] — 1.0.0 Alpha 1 — 2026-08-11
 
 First public alpha of **XOOPS Support** — a PhpStorm / IntelliJ helper for XOOPS 2.5 / 2.7 / 4.0 module and core work.

gradle.properties

@@ -5,8 +5,8 @@
 pluginGroup=org.xoops
 pluginName=xoops-support
 pluginId=org.xoops.plugin.support
-# Technical version (ZIP / Marketplace). Display: "1.0.0 Alpha 1"
-pluginVersion=1.0.0-alpha.1
+# Technical version (ZIP / Marketplace). Display: "1.0.0 Alpha 2"
+pluginVersion=1.0.0-alpha.2
 
 # Platform / compatibility (PhpStorm build numbers)
 # 243 = 2024.3; leave until open so 2025.x / 2026.x (e.g. 2026.2.1 = 262.*) install cleanly.

src/main/java/org/xoops/support/XoopsStartupActivity.java

@@ -58,7 +58,7 @@ public void runActivity(@NotNull Project project) {
                                     .createNotification(
                                             "XOOPS Support active",
                                             "Detected XOOPS markers (" + modules + " module(s) with xoops_version.php). "
-                                                    + "See Settings → Editor → Inspections → PHP → XOOPS, "
+                                                    + "See Settings → Editor → Inspections → XOOPS, "
                                                     + "and Tools → XOOPS Support.",
                                             NotificationType.INFORMATION
                                     )

src/main/java/org/xoops/support/actions/ShowXoopsProjectInfoAction.java

@@ -25,7 +25,7 @@ public void actionPerformed(@NotNull AnActionEvent e) {
             return;
         }
         String basePath = project.getBasePath();
-        ProgressManager.getInstance().run(new Task.Backgroundable(project, "Scanning XOOPS project", false) {
+        ProgressManager.getInstance().run(new Task.Backgroundable(project, "Scanning XOOPS project", true) {
             @Override
             public void run(@NotNull ProgressIndicator indicator) {
                 XoopsProjectReport report;

src/main/java/org/xoops/support/scanner/XoopsProjectScanner.java

@@ -1,5 +1,6 @@
 package org.xoops.support.scanner;
 
+import com.intellij.openapi.progress.ProgressManager;
 import org.jetbrains.annotations.NotNull;
 
 import java.io.IOException;
@@ -68,6 +69,8 @@ public XoopsProjectReport scan(Path requestedRoot) {
 
         List<XoopsFinding> findings = new ArrayList<>();
         for (Path moduleRoot : moduleRoots) {
+            // Cooperative cancel when run under ProgressManager (Overview Refresh).
+            ProgressManager.checkCanceled();
             scanModule(moduleRoot, findings);
         }
         findings.sort(Comparator
@@ -222,7 +225,10 @@ private void scanModule(Path moduleRoot, List<XoopsFinding> findings) {
                         String n = p.getFileName().toString().toLowerCase(Locale.ROOT);
                         return n.endsWith(".php") || n.endsWith(".tpl");
                     })
-                    .forEach(path -> scanSourceFile(path, findings));
+                    .forEach(path -> {
+                        ProgressManager.checkCanceled();
+                        scanSourceFile(path, findings);
+                    });
         } catch (IOException exception) {
             findings.add(new XoopsFinding(
                     "SCAN_ERROR",

src/main/java/org/xoops/support/settings/XoopsConfigurable.java

@@ -23,6 +23,7 @@ public final class XoopsConfigurable implements Configurable {
     private final Project project;
     private JCheckBox enabledBox;
     private JCheckBox suppressNotifyBox;
+    private JCheckBox autoScanBox;
     private JComboBox<String> profileBox;
     private JTextField prefixField;
     private JPanel panel;
@@ -53,6 +54,12 @@ public XoopsConfigurable(Project project) {
         suppressNotifyBox = new JCheckBox("Suppress startup notification");
         form.add(suppressNotifyBox, c);
 
+        c.gridy++;
+        autoScanBox = new JCheckBox(
+                "Auto-scan project when Overview tool window opens (slow on large trees)"
+        );
+        form.add(autoScanBox, c);
+
         c.gridy++;
         form.add(new JLabel("Core profile:"), c);
         c.gridx = 1;
@@ -80,6 +87,7 @@ public boolean isModified() {
         String storedPrefix = s.tablePrefix == null ? "" : s.tablePrefix;
         return enabledBox.isSelected() != s.enabled
                 || suppressNotifyBox.isSelected() != s.suppressStartupNotification
+                || autoScanBox.isSelected() != s.autoScanOnToolWindowOpen
                 || !Objects.equals(selectedProfile, storedProfile)
                 || !Objects.equals(prefixField.getText().trim(), storedPrefix);
     }
@@ -89,6 +97,7 @@ public void apply() {
         XoopsSettingsState s = XoopsSettingsState.getInstance(project);
         s.enabled = enabledBox.isSelected();
         s.suppressStartupNotification = suppressNotifyBox.isSelected();
+        s.autoScanOnToolWindowOpen = autoScanBox.isSelected();
         s.coreProfile = String.valueOf(profileBox.getSelectedItem());
         s.tablePrefix = prefixField.getText().trim();
     }
@@ -98,6 +107,7 @@ public void reset() {
         XoopsSettingsState s = XoopsSettingsState.getInstance(project);
         enabledBox.setSelected(s.enabled);
         suppressNotifyBox.setSelected(s.suppressStartupNotification);
+        autoScanBox.setSelected(s.autoScanOnToolWindowOpen);
         profileBox.setSelectedItem(s.coreProfile == null ? "Auto" : s.coreProfile);
         prefixField.setText(s.tablePrefix == null ? "" : s.tablePrefix);
     }

src/main/java/org/xoops/support/settings/XoopsSettingsState.java

@@ -15,6 +15,12 @@ public final class XoopsSettingsState implements PersistentStateComponent<XoopsS
 
     public boolean enabled = true;
     public boolean suppressStartupNotification = false;
+    /**
+     * When true, the Overview tool window scans the project as soon as it opens.
+     * Default false: full module tree walks are expensive on monorepos / multi-project
+     * boot; user must click Refresh (or Tools → Refresh XOOPS Overview).
+     */
+    public boolean autoScanOnToolWindowOpen = false;
     /** Auto | 2.5 | 2.7 | 4.0 */
     public String coreProfile = "Auto";
     public String tablePrefix = "";

src/main/java/org/xoops/support/ui/XoopsToolWindowPanel.java

@@ -69,7 +69,39 @@ public XoopsToolWindowPanel(Project project) {
 
         add(toolbar, BorderLayout.NORTH);
         add(new JBScrollPane(overview), BorderLayout.CENTER);
-        refresh();
+
+        // Never walk the module tree on tool-window create by default — monorepos freeze boot.
+        XoopsSettingsState settings = XoopsSettingsState.getInstance(project);
+        if (!settings.enabled) {
+            showDisabled();
+        } else if (settings.autoScanOnToolWindowOpen) {
+            refresh();
+        } else {
+            showIdlePrompt();
+        }
+    }
+
+    private void showDisabled() {
+        overview.setText("<html><body style='font-family:sans-serif;padding:8px'>"
+                + "<p><b>XOOPS Support is disabled</b> for this project.</p>"
+                + "<p>Settings → Languages &amp; Frameworks → XOOPS Support.</p>"
+                + "</body></html>");
+        status.setText("Disabled");
+        refreshButton.setEnabled(true);
+    }
+
+    private void showIdlePrompt() {
+        overview.setText("<html><body style='font-family:sans-serif;padding:8px'>"
+                + "<p><b>Overview is idle</b> — no automatic project scan.</p>"
+                + "<p>Click <b>Refresh</b> (or <b>Tools → XOOPS Support → Refresh XOOPS Overview</b>) "
+                + "to scan modules for convention findings. "
+                + "Full-tree scans read every module <code>.php</code>/<code>.tpl</code> and are "
+                + "expensive on large monorepos.</p>"
+                + "<p>Optional: Settings → XOOPS Support → "
+                + "<i>Auto-scan project when Overview tool window opens</i> (off by default).</p>"
+                + "</body></html>");
+        status.setText("Idle — click Refresh to scan");
+        refreshButton.setEnabled(true);
     }
 
     public void refresh() {
@@ -84,30 +116,35 @@ public void refresh() {
             return;
         }
         if (!XoopsSettingsState.getInstance(project).enabled) {
-            overview.setText("<html><body><p>XOOPS Support is disabled for this project "
-                    + "(Settings → XOOPS Support).</p></body></html>");
-            status.setText("Disabled");
-            refreshButton.setEnabled(true);
+            showDisabled();
             return;
         }
 
         final long requestId = scanGeneration.incrementAndGet();
         refreshButton.setEnabled(false);
         status.setText("Scanning…");
 
-        ProgressManager.getInstance().run(new Task.Backgroundable(project, "Scanning XOOPS project", false) {
+        // canBeCancelled = true so the user can stop a runaway monorepo walk.
+        ProgressManager.getInstance().run(new Task.Backgroundable(project, "Scanning XOOPS project", true) {
             @Override
             public void run(@NotNull ProgressIndicator indicator) {
                 try {
+                    indicator.setText("Scanning XOOPS modules (cancellable)…");
+                    indicator.checkCanceled();
                     XoopsProjectReport report = new XoopsProjectScanner().scan(Path.of(basePath));
+                    indicator.checkCanceled();
                     String html = new XoopsReportHtmlRenderer().render(report);
                     ApplicationManager.getApplication().invokeLater(
                             () -> applyReport(report, html, requestId),
                             ModalityState.any(),
                             __ -> disposed.get() || project.isDisposed() || requestId != scanGeneration.get()
                     );
                 } catch (ProcessCanceledException e) {
-                    throw e;
+                    ApplicationManager.getApplication().invokeLater(
+                            () -> applyCancelled(requestId),
+                            ModalityState.any(),
+                            __ -> disposed.get() || project.isDisposed() || requestId != scanGeneration.get()
+                    );
                 } catch (Exception e) {
                     String msg = e.getMessage() == null ? e.getClass().getSimpleName() : e.getMessage();
                     String html = "<html><body style='font-family:sans-serif;padding:8px'>"
@@ -124,6 +161,17 @@ public void run(@NotNull ProgressIndicator indicator) {
         });
     }
 
+    private void applyCancelled(long requestId) {
+        if (disposed.get() || project.isDisposed() || requestId != scanGeneration.get()) {
+            return;
+        }
+        overview.setText("<html><body style='font-family:sans-serif;padding:8px'>"
+                + "<p><b>Scan cancelled.</b></p>"
+                + "<p>Click <b>Refresh</b> to try again.</p></body></html>");
+        status.setText("Cancelled");
+        refreshButton.setEnabled(true);
+    }
+
     private void applyReport(XoopsProjectReport report, String html, long requestId) {
         if (disposed.get() || project.isDisposed() || requestId != scanGeneration.get()) {
             return;

src/main/resources/META-INF/plugin.xml

@@ -3,14 +3,14 @@
 <idea-plugin>
     <id>org.xoops.plugin.support</id>
     <name>XOOPS Support</name>
-    <version>1.0.0-alpha.1</version>
+    <version>1.0.0-alpha.2</version>
     <vendor url="https://github.com/XOOPS/phpstorm-plugin" email="dev@xoops.org">XOOPS Project</vendor>
 
     <!-- since-build/until-build are patched from gradle.properties (until open-ended for 2026.2+). -->
 
     <description><![CDATA[
         <p><b>XOOPS Support</b> — PhpStorm / IntelliJ helper for XOOPS 2.5 / 2.7 / 4.0 module and core work.</p>
-        <p><i>1.0.0 Alpha 1</i> — first public preview; APIs and inspections may change.</p>
+        <p><i>1.0.0 Alpha 2</i> — on-demand overview scan; inspections under top-level XOOPS group.</p>
         <ul>
           <li>Project detection, scanner, and HTML overview tool window</li>
           <li>Inspections with Alt+Enter quick fixes (guards, query/exec, Request, Smarty, templates)</li>
@@ -20,6 +20,12 @@
     ]]></description>
 
     <change-notes><![CDATA[
+        <h3>1.0.0 Alpha 2 (1.0.0-alpha.2)</h3>
+        <ul>
+          <li><b>Performance:</b> Overview no longer auto-scans the whole module tree when the tool window opens (monorepo boot freeze). Click <b>Refresh</b> to scan. Optional setting re-enables auto-scan.</li>
+          <li>Scan tasks are cancellable; scanner cooperates with ProgressManager between modules/files.</li>
+          <li>Inspections appear under top-level <b>XOOPS</b> in Settings → Editor → Inspections (no longer nested under PHP).</li>
+        </ul>
         <h3>1.0.0 Alpha 1 (1.0.0-alpha.1)</h3>
         <p>First public alpha of <b>XOOPS Support</b>.</p>
         <ul>
@@ -55,7 +61,6 @@
 
         <localInspection
                 language="PHP"
-                groupPath="PHP"
                 groupName="XOOPS"
                 enabledByDefault="true"
                 level="WARNING"
@@ -65,7 +70,6 @@
 
         <localInspection
                 language="PHP"
-                groupPath="PHP"
                 groupName="XOOPS"
                 enabledByDefault="true"
                 level="WARNING"
@@ -75,7 +79,6 @@
 
         <localInspection
                 language="PHP"
-                groupPath="PHP"
                 groupName="XOOPS"
                 enabledByDefault="true"
                 level="ERROR"
@@ -85,7 +88,6 @@
 
         <localInspection
                 language="PHP"
-                groupPath="PHP"
                 groupName="XOOPS"
                 enabledByDefault="true"
                 level="ERROR"
@@ -95,7 +97,6 @@
 
         <localInspection
                 language="PHP"
-                groupPath="PHP"
                 groupName="XOOPS"
                 enabledByDefault="true"
                 level="WARNING"
@@ -105,7 +106,6 @@
 
         <localInspection
                 language="PHP"
-                groupPath="PHP"
                 groupName="XOOPS"
                 enabledByDefault="true"
                 level="WARNING"
@@ -115,7 +115,6 @@
 
         <localInspection
                 language="PHP"
-                groupPath="PHP"
                 groupName="XOOPS"
                 enabledByDefault="true"
                 level="WEAK WARNING"
@@ -125,7 +124,6 @@
 
         <localInspection
                 language="Smarty"
-                groupPath="PHP"
                 groupName="XOOPS"
                 enabledByDefault="true"
                 level="WARNING"