feat(debug): add Debug Overrides dialog under Diagnostic Tools

Dev-only command (debug.debugOverrides) that surfaces local-service
override toggles without rebuilding. Values are persisted as a single
JSON blob in localStorage under LOCAL_OVERIDES_FOR_PHOIENXI_DEBUG so
any consumer can read flags with one getItem.

First flag: AI_PANEL_LOCAL_OVERRIDE — when set, AIChatPanel switches
the onboarding iframe from production to localhost:5555.

Dialog shows one row per toggle with a checkbox, label, and a small
fa-circle-info icon whose `title` carries the full explanation, so
extra overrides can be added later without growing the dialog body.

Author: abose

src/brackets.js

@@ -143,6 +143,7 @@ define(function (require, exports, module) {
     require("thirdparty/tinycolor");
     require("utils/LocalizationUtils");
     require("phoenix-builder/main");
+    require("phoenix-builder/debug-overrides");
 
     // DEPRECATED: In future we want to remove the global CodeMirror, but for now we
     // expose our required CodeMirror globally so as to avoid breaking extensions in the

src/extensions/default/DebugCommands/main.js

@@ -830,6 +830,7 @@ define(function (require, exports, module) {
     diagnosticsSubmenu.addMenuItem(DEBUG_BUILD_TESTS);
     if (AppConfig.config.environment === "dev") {
         diagnosticsSubmenu.addMenuItem("debug.phoenixBuilderConnect");
+        diagnosticsSubmenu.addMenuItem("debug.debugOverrides");
     }
     diagnosticsSubmenu.addMenuDivider();
     diagnosticsSubmenu.addMenuItem(DEBUG_ENABLE_LOGGING);

src/phoenix-builder/debug-overrides-dialog.html

@@ -0,0 +1,20 @@
+<div class="phoenix-debug-overrides modal">
+    <div class="modal-header">
+        <h1 class="dialog-title">Debug Overrides</h1>
+    </div>
+    <div class="modal-body">
+        <div style="margin-bottom: 6px;">
+            <label style="display: flex; align-items: center; gap: 8px;">
+                <input type="checkbox" class="ai-panel-local-override" {{#aiPanelLocalOverride}}checked{{/aiPanelLocalOverride}}>
+                <span>AI panel onboarding — local server</span>
+                <i class="fa-solid fa-circle-info"
+                   style="opacity: 0.5; cursor: help; font-size: 12px;"
+                   title="Load http://localhost:5555/onbaording_v5/ instead of the production https://ai-panel-onboarding.phcode.dev/onbaording_v5/. Reload Phoenix after toggling."></i>
+            </label>
+        </div>
+    </div>
+    <div class="modal-footer">
+        <button class="dialog-button btn" data-button-id="cancel">Cancel</button>
+        <button class="dialog-button btn primary" data-button-id="ok">Save</button>
+    </div>
+</div>

src/phoenix-builder/debug-overrides.js

@@ -0,0 +1,97 @@
+/*
+ * GNU AGPL-3.0 License
+ *
+ * Copyright (c) 2021 - present core.ai . All rights reserved.
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see https://opensource.org/licenses/AGPL-3.0.
+ *
+ */
+
+/*globals AppConfig*/
+
+/**
+ * Debug → Diagnostic Tools → Debug Overrides
+ *
+ * A small dev-only dialog for toggling local-service overrides
+ * without rebuilding. Values are persisted as a single JSON blob in
+ * localStorage under LOCAL_OVERIDES_FOR_PHOIENXI_DEBUG so consumers
+ * can read overrides at startup with a single getItem.
+ *
+ * Read flags from anywhere via:
+ *   const overrides = (function () {
+ *       try { return JSON.parse(localStorage.getItem(
+ *           "LOCAL_OVERIDES_FOR_PHOIENXI_DEBUG")) || {}; }
+ *       catch (e) { return {}; }
+ *   })();
+ *   if (overrides.AI_PANEL_LOCAL_OVERRIDE) { ... }
+ */
+define(function (require, exports, module) {
+
+    if (!window.AppConfig || AppConfig.config.environment !== "dev") {
+        return;
+    }
+
+    const CommandManager = require("command/CommandManager"),
+        Dialogs        = require("widgets/Dialogs"),
+        Mustache       = require("thirdparty/mustache/mustache"),
+        OverridesTpl   = require("text!./debug-overrides-dialog.html");
+
+    const COMMAND_ID = "debug.debugOverrides";
+    const STORAGE_KEY = "LOCAL_OVERIDES_FOR_PHOIENXI_DEBUG";
+
+    function _readOverrides() {
+        try {
+            const raw = localStorage.getItem(STORAGE_KEY);
+            if (!raw) { return {}; }
+            const parsed = JSON.parse(raw);
+            return (parsed && typeof parsed === "object") ? parsed : {};
+        } catch (e) {
+            return {};
+        }
+    }
+
+    function _writeOverrides(obj) {
+        try {
+            localStorage.setItem(STORAGE_KEY, JSON.stringify(obj || {}));
+        } catch (e) {
+            console.warn("[Debug Overrides] Failed to persist:", e);
+        }
+    }
+
+    function _handleDebugOverrides() {
+        const overrides = _readOverrides();
+        let aiPanelLocalOverride = !!overrides.AI_PANEL_LOCAL_OVERRIDE;
+
+        const html = Mustache.render(OverridesTpl, {
+            aiPanelLocalOverride: aiPanelLocalOverride
+        });
+
+        Dialogs.showModalDialogUsingTemplate(html).done(function (id) {
+            if (id !== Dialogs.DIALOG_BTN_OK) { return; }
+            const next = _readOverrides();
+            next.AI_PANEL_LOCAL_OVERRIDE = aiPanelLocalOverride;
+            _writeOverrides(next);
+        });
+
+        const $dialog = $(".phoenix-debug-overrides.instance");
+        $dialog.find(".ai-panel-local-override").on("change", function () {
+            aiPanelLocalOverride = $(this).is(":checked");
+        });
+    }
+
+    CommandManager.register("Debug Overrides…", COMMAND_ID, _handleDebugOverrides);
+
+    exports.COMMAND_ID = COMMAND_ID;
+    exports.STORAGE_KEY = STORAGE_KEY;
+});