@omega.js/desktop 0.52.0 → 0.53.0

package/dist/commands/runner.js

@@ -24,7 +24,7 @@
 //   stop                 Kill every Runner.Listener.exe under RUNNER_HOME.
 //   status               Registered orgs, Startup shortcuts, live listeners.
 //   uninstall            Remove everything — legacy services and tasks, and the
-//                        electron-manager era's em-runner install, included.
+//                        legacy em-runner install, included.
 //   monitor              Tail the JSONL signing event log, pretty-printed.
 //
 // Every subcommand except `monitor` refuses on non-Windows
@@ -35,8 +35,8 @@ const fs       = require('fs');
 const os       = require('os');
 const jetpack  = require('fs-jetpack');
 
-const Manager  = new (require('../build.js'));
-const logger   = Manager.logger('runner');
+const build  = require('../build.js');
+const logger   = build.logger('runner');
 
 const RUNNER_LABELS = ['self-hosted', 'windows', 'ev-token'];
 
@@ -63,7 +63,7 @@ const attachLogFile = require('../utils/attach-log-file.js');
 const RUNNER_HOME = process.env.OMEGA_RUNNER_HOME || defaultRunnerHome();
 loadRunnerEnv({ home: RUNNER_HOME });
 
-// The electron-manager era of this command (`em runner`) laid the same design
+// The legacy generation of this command (`em runner`) laid the same design
 // down under other names: the home was %LOCALAPPDATA%\em-runner (C:\actions-runners
 // before that), and the Startup shortcuts and the GitHub-side runners were
 // `em-runner-<host>-<org>`. An upgraded box still has all of it — live, and
@@ -207,7 +207,7 @@ async function install(options) {
   // the calling terminal at normal user privilege.
 
   // Idempotent by replacement: always tear down any prior install before starting —
-  // the omega one, or the electron-manager one an upgraded box still runs.
+  // the omega one, or the legacy em-runner one an upgraded box still runs.
   if (jetpack.exists(home) || listLegacyRunnerHomes({ home }).length > 0 || listLegacyRunnerStartupShortcuts().length > 0) {
     logger.log(`Existing runner installation detected — uninstalling first for a clean re-install...`);
     try {
@@ -369,8 +369,8 @@ async function registerOrg(options) {
   // THIS host. Without this, re-running install accumulates orphaned runners (one per
   // failed/aborted install, one per host rename, etc.) which causes actions/runner to
   // auto-suffix the new runner's name (e.g. `-2872`) and breaks our ability to predict
-  // service names. Match prefix is `omega-runner-<host>-<org>` — and the electron-manager
-  // era's `em-runner-<host>-<org>`, the same box's older registration — so we never touch
+  // service names. Match prefix is `omega-runner-<host>-<org>` — and the legacy
+  // `em-runner-<host>-<org>`, the same box's older registration — so we never touch
   // user-created runners or runners from other hosts.
   //
   // We do this BEFORE fetching the registration token because the token is one-shot
@@ -900,7 +900,7 @@ async function statusServices(options) {
     }
   }
 
-  // The electron-manager era's install (`em runner`): its home, its Startup
+  // The legacy install (`em runner`): its home, its Startup
   // shortcuts, and any listener still running out of it. None of it answers to
   // the omega names above, so it is named here and torn down by `uninstall`.
   const legacyHomes     = listLegacyRunnerHomes({ home });
@@ -989,7 +989,7 @@ async function uninstall(options) {
   // handles asynchronously after stop).
   await removeRunnerHomeWithRetry(new Set(failed.map((f) => f.dir)), home);
 
-  // The electron-manager era's install, when this box still has one: the same
+  // The legacy em-runner install, when this box still has one: the same
   // teardown, org by org, so its GitHub-side registrations come off too.
   const legacy = await uninstallLegacyRunnerInstalls(home);
   const stillRegistered = [...failed, ...legacy.failed];
@@ -1002,7 +1002,7 @@ async function uninstall(options) {
   logger.warn(`  Their directories were kept — re-run 'npx omega runner uninstall' to retry, or delete them under each org's Settings → Actions → Runners.`);
 }
 
-// Tear down the electron-manager era's runner install: its `em-runner-*`
+// Tear down the legacy runner install: its `em-runner-*`
 // Startup shortcuts, then each legacy home — deregister every org dir through
 // its own config.cmd, kill what runs out of it, remove it. A registration that
 // did not come off keeps its directory, exactly as the omega home's does.
@@ -1657,7 +1657,7 @@ function listRunnerStartupShortcuts(startupDir) {
   return listStartupShortcuts('omega-runner-', startupDir);
 }
 
-// The electron-manager era's: `em-runner-<host>-<org>`, which `status` names
+// The legacy shortcuts: `em-runner-<host>-<org>`, which `status` names
 // and `uninstall` removes — never anything `start` would launch.
 function listLegacyRunnerStartupShortcuts(startupDir) {
   return listStartupShortcuts(LEGACY_RUNNER_PREFIX, startupDir);

package/dist/commands/sign-windows.js

@@ -21,8 +21,8 @@ const os      = require('os');
 const jetpack = require('fs-jetpack');
 const { execute } = require('node-powertools');
 
-const Manager = new (require('../build.js'));
-const logger = Manager.logger('sign-windows');
+const build = require('../build.js');
+const logger = build.logger('sign-windows');
 
 // The box's own signing configuration (`<runner home>\.env`: the cert, the PIN,
 // signtool) is read before anything below looks at process.env, so a manual
@@ -90,9 +90,9 @@ async function runSignCommand(options) {
     return smokeTest();
   }
 
-  const strategy = Manager.getWindowsSignStrategy();
+  const strategy = build.getWindowsSignStrategy();
 
-  const config   = Manager.getConfig();
+  const config   = build.getConfig();
   const projectRoot = process.cwd();
 
   // Resolve --in and --out (CLI flags) → directories of unsigned / signed artifacts.
@@ -441,7 +441,7 @@ async function signWithSigntool(targets, inDir, outDir, deps) {
   // (mac/linux equivalents are produced by electron-builder during their publish step,
   // but Windows is split into a post-build sign job so we have to write the yml here).
   if (signedExes.length > 0) {
-    const pkg = Manager.getPackage('project') || {};
+    const pkg = build.getPackage('project') || {};
     const version = pkg.version;
     if (!version) {
       log.warn('Could not determine version from package.json; skipping latest.yml generation.');

package/dist/commands/test.js

@@ -1,8 +1,8 @@
 // Libraries
 const path = require('path');
 const fs = require('fs');
-const Manager = new (require('../build.js'));
-const logger = Manager.logger('test');
+const build = require('../build.js');
+const logger = build.logger('test');
 const { run } = require('../test/runner.js');
 const attachLogFile = require('../utils/attach-log-file.js');
 const { EXTENDED_MODE_WARNING } = require('../test/utils/extended-mode-warning.js');
@@ -43,7 +43,7 @@ module.exports = async function (options) {
   // Extended mode — opt into tests that hit REAL external services (Firebase, analytics,
   // update feeds) instead of skipping them. Off by default so `npx omega test` stays fast and
   // offline-safe. The canonical signal is the unprefixed `TEST_EXTENDED_MODE` env var — the
-  // SAME name across @omega.js/backend, @omega.js/extension, UJM, and @omega.js/desktop (cross-framework parity); `--extended` is the CLI
+  // SAME name on every framework (cross-framework parity); `--extended` is the CLI
   // shorthand. Once set on process.env it propagates to every spawned child (electron
   // main/renderer/boot, the gulp boot build) automatically via `{ ...process.env }`.
   const extended    = options.extended === true
@@ -58,7 +58,7 @@ module.exports = async function (options) {
   // When @omega.js/desktop itself runs its own boot-layer tests (the cwd's package.json is @omega.js/desktop's), there's
   // no real consumer app to boot. Point the boot runner at the fixture under
   // dist/test/fixtures/consumer-app unless the caller has already set OMEGA_TEST_BOOT_PROJECT
-  // explicitly. Mirrors BXM's OMEGA_TEST_BOOT_PROJECT / UJM's UJ_TEST_BOOT_PROJECT.
+  // explicitly.
   if (!process.env.OMEGA_TEST_BOOT_PROJECT) {
     try {
       const cwdPkg = JSON.parse(fs.readFileSync(path.join(process.cwd(), 'package.json'), 'utf8'));

package/dist/commands/update.js

@@ -5,8 +5,8 @@
  * non-quarantined, non-breaking set (`--major` opts into breaking) through
  * npu when present. The whole verb is the shared devkit implementation.
  */
-const Manager = new (require('../build.js'));
-const logger = Manager.logger('update');
+const build = require('../build.js');
+const logger = build.logger('update');
 const { runUpdate } = require('../vendor/devkit/update.js');
 
 module.exports = async function (options) {

package/dist/commands/validate-certs.js

@@ -38,8 +38,8 @@ const { certificateExpiry, EXPIRY_WARN_DAYS } = require('../vendor/devkit/certs.
 const { signingPathCandidates } = require('../vendor/devkit/signing-env.js');
 const { requiredWhenHolds } = require('../vendor/config/env-rules.js');
 
-const Manager = new (require('../build.js'));
-const logger = Manager.logger('validate-certs');
+const build = require('../build.js');
+const logger = build.logger('validate-certs');
 
 module.exports = async function (options) {
   options = options || {};
@@ -48,8 +48,8 @@ module.exports = async function (options) {
   logger.log('Validating signing prerequisites...');
 
   const platform = process.platform;
-  const config = Manager.getConfig();
-  const winStrategy = Manager.getWindowsSignStrategy();
+  const config = build.getConfig();
+  const winStrategy = build.getWindowsSignStrategy();
 
   const issues = [];
 

package/dist/commands/version.js

@@ -1,8 +1,8 @@
 // Libraries
-const Manager = new (require('../build.js'));
-const logger = Manager.logger('version');
+const build = require('../build.js');
+const logger = build.logger('version');
 
-const package = Manager.getPackage('main');
+const package = build.getPackage('main');
 
 module.exports = async function (options) {
   logger.log(package.version);

package/dist/defaults/AGENTS.md

@@ -19,8 +19,9 @@ This project consumes **OMEGA Desktop** (@omega.js/desktop), a comprehensive fra
 
 ## 🚨 READ @omega.js/client TOO
 
-**@omega.js/desktop ships `@omega.js/client` as a runtime singleton inside the renderer process.**
+**@omega.js/desktop's renderer instance extends `@omega.js/client`'s base class.**
 - It powers auth, Firebase, reactive `data-omega-bind` directives, analytics, error tracking, and utilities (`escapeHTML`, etc.).
+- `omega.auth.user` is always a `User`: `authenticated`, `plan`, `active`, `profile.displayName`; `omega.auth.listen()` delivers `{ user, denied }`.
 - Any task that touches auth flows, Firestore reads/writes, subscription resolution, push notifications, or DOM bindings means you are working with @omega.js/client as much as with @omega.js/desktop.
 
 **Required reading:**
@@ -71,28 +72,36 @@ npx omega install live # restore the published @omega.js/desktop from npm
 
 ## Per-context imports
 
+Each entry exports ONE ready-made instance, `omega`; a consumer never writes `new`.
+
 ```js
 // src/main.js
-new (require('@omega.js/desktop/main'))().initialize();   // auto-loads JSON5 config
+const omega = require('@omega.js/desktop/main');
+omega.initialize().then(() => { const { logger, windows } = omega; });   // auto-loads JSON5 config
 
 // src/preload.js
-new (require('@omega.js/desktop/preload'))().initialize();
+const omega = require('@omega.js/desktop/preload');
+omega.initialize();
 
 // src/assets/js/components/main/index.js
-new (require('@omega.js/desktop/renderer'))().initialize();
+import omega from '@omega.js/desktop/renderer';
+omega.initialize().then(() => { const { logger, desktop } = omega; });
 ```
 
 ## Available APIs at runtime
 
-In main: `manager.storage`, `manager.ipc`, `manager.windows`, `manager.tray`, `manager.menu`, `manager.contextMenu`, `manager.startup`, `manager.appState`, `manager.deepLink`, `manager.autoUpdater`, `manager.sentry`, `manager.omega`, `manager.context`, `manager.usage`, `manager.remoteConfig`, `manager.analytics`, `manager.restartManager`.
+In main, each a property of `omega`: `windows`, `tray`, `menu`, `contextMenu`, `ipc`, `storage`, `deepLink`, `autoUpdater`, `appState`, `startup`, `protocol`, `authFlow`, `theme`, `fontawesome`, `context`, `usage`, `remoteConfig`, `remoteScripts`, `restartManager`, `analytics`, `sentry`, `logger`.
+- `omega.auth` is the signed-in account in main: `.user` (a `User`), `.listen()`, `.signOut()`, `.getIdToken()`, `.handleToken()`.
 
-In renderer: `window.desktop.storage`, `window.desktop.ipc`, `window.desktop.logger`, `window.OMEGA_BUILD_JSON.config` (the one `build.js` the view's shell loads).
+In renderer: the @omega.js/client base (`omega.auth`, `omega.firestore`, `omega.bindings`, and `omega.storage`, the page store) plus `omega.desktop`, the preload's bridge to main.
+- `omega.desktop.{ipc,storage,theme,fontawesome,autoUpdater,analytics,context,usage,remoteConfig}`; `omega.desktop.storage` is the app store, async over IPC.
+- Config: `window.OMEGA_BUILD_JSON.config` (the one `build.js` the view's shell loads).
 
 ## Dependency resolution
 
 - **Do NOT install framework dependencies directly** (`firebase`, `fs-jetpack`, `@omega.js/client`, etc.). @omega.js/desktop's bundler resolves them through the framework's own `node_modules/`. If something doesn't resolve, the issue is in @omega.js/desktop's bundle task, not your `package.json`.
-- **@omega.js/client owns Firebase.** Never `require('firebase')` or `import('firebase/app')`. Use `require('@omega.js/client')` → `omega.auth()`, `omega.firestore()` in renderers. In main process, use `manager.omega` (the @omega.js/desktop bridge).
-- **`Manager.require(name)`** resolves from @omega.js/desktop's module context at runtime for unbundled code (gulp tasks, test fixtures).
+- **@omega.js/client owns Firebase.** Never `require('firebase')` or `import('firebase/app')`. In renderers use `omega.auth` and `omega.firestore` on the renderer instance. In the main process, use `omega.auth` (the @omega.js/desktop bridge).
+- **`omega.require(name)`** resolves from @omega.js/desktop's module context at runtime for unbundled code (gulp tasks, test fixtures).
 
 ## Testing
 

package/dist/defaults/config/omega.json5

@@ -71,7 +71,7 @@
   // App/cloud platform role (provider-discriminated). `config` is the Firebase web
   // SDK config — copy directly from Firebase Console → Project Settings → SDK setup
   // (Config option). Same shape every OMEGA target reads.
-  // Empty config {} disables Firebase Auth in the renderer (client-bridge logs a warn).
+  // Empty config {} disables Firebase Auth in the renderer (the auth lib logs a warn).
   cloud: {
     provider: 'firebase',
     config: {
@@ -87,7 +87,7 @@
   },
 
   // Appearance — the app's DEFAULT theme. 'system' follows the OS preference live;
-  // 'light'/'dark' are explicit overrides. A user's runtime choice (manager.theme.set
+  // 'light'/'dark' are explicit overrides. A user's runtime choice (omega.theme.set
   // or the [data-omega-theme-set] controls) persists in storage and wins over this on
   // every boot. See docs/themes.md.
   theme: {
@@ -234,8 +234,8 @@
       //   src/integrations/tray/index.js
       //   src/integrations/menu/index.js
       //   src/integrations/context-menu/index.js
-      // To disable at runtime: call `manager.tray.disable()` / `manager.menu.disable()` /
-      // `manager.contextMenu.disable()` from your main entry. Idempotent.
+      // To disable at runtime: call `omega.tray.disable()` / `omega.menu.disable()` /
+      // `omega.contextMenu.disable()` from your main entry. Idempotent.
 
       // Startup behavior — two independent knobs.
       //
@@ -263,7 +263,7 @@
         },
       },
       // No `windows` block needed — @omega.js/desktop no longer auto-creates windows. Your main.js
-      // calls `manager.windows.create('main', { width: 1280, height: 800, ... })` when
+      // calls `omega.windows.create('main', { width: 1280, height: 800, ... })` when
       // you want UI to surface. Defaults baked in:
       //   main      → { width: 1024, height: 720, hideOnClose: true,  view: 'main' }
       //   any other → { width: 800,  height: 600, hideOnClose: false, view: name   }
@@ -282,9 +282,9 @@
       },
       // Deep links: scheme is automatically `<brand.id>://...`. Built-in routes:
       //   auth/token  → @omega.js/client auth token handoff
-      //   app/show    → manager.windows.show(query.window || 'main')
+      //   app/show    → omega.windows.show(query.window || 'main')
       //   app/quit    → app.quit()
-      // Add custom routes at runtime: manager.deepLink.on('my-route', (ctx) => {...}) in main.
+      // Add custom routes at runtime: omega.deepLink.on('my-route', (ctx) => {...}) in main.
 
       // "Hot config" — JSON document fetched from the brand site so app behavior
       // can be flipped without shipping a new build (e.g. force-update gate, ads

package/dist/defaults/hooks/build/post.js

@@ -5,5 +5,5 @@
 // auxiliary files (changelog, license bundling, etc.).
 
 module.exports = async (ctx) => {
-  // ctx = { manager, mode, projectRoot, distDir }
+  // ctx = { build, mode, projectRoot, distDir }
 };

package/dist/defaults/hooks/build/pre.js

@@ -5,5 +5,5 @@
 // the bundle / build-config tasks see it.
 
 module.exports = async (ctx) => {
-  // ctx = { manager, mode, projectRoot }
+  // ctx = { build, mode, projectRoot }
 };

package/dist/defaults/hooks/deploy/pre.js

@@ -6,5 +6,5 @@
 // that must happen before the publish reaches the release repo.
 
 module.exports = async (ctx) => {
-  // ctx = { manager, projectRoot, mode }
+  // ctx = { build, projectRoot, mode }
 };

package/dist/defaults/hooks/release/post.js

@@ -5,5 +5,5 @@
 // changelog page on your marketing site, sending notification emails.
 
 module.exports = async (ctx) => {
-  // ctx = { manager, projectRoot, artifacts }   // artifacts: array of release/ paths
+  // ctx = { build, projectRoot, artifacts }   // artifacts: array of release/ paths
 };

package/dist/defaults/hooks/release/pre.js

@@ -5,5 +5,5 @@
 // previous release before overwriting.
 
 module.exports = async (ctx) => {
-  // ctx = { manager, projectRoot }
+  // ctx = { build, projectRoot }
 };

package/dist/defaults/src/assets/js/components/about/index.js

@@ -1,10 +1,8 @@
 // About window renderer entry.
-const Manager = require('@omega.js/desktop/renderer');
+import omega from '@omega.js/desktop/renderer';
 
-const manager = new Manager();
-
-manager.initialize()
+omega.initialize()
   .then(() => {
-    const { logger } = manager;
+    const { logger } = omega;
     logger.log('About window initialized!');
   });

package/dist/defaults/src/assets/js/components/main/index.js

@@ -1,11 +1,9 @@
 // Main window renderer entry.
-const Manager = require('@omega.js/desktop/renderer');
+import omega from '@omega.js/desktop/renderer';
 
-const manager = new Manager();
-
-manager.initialize()
+omega.initialize()
   .then(() => {
-    const { logger, ipc, storage, omega } = manager;
+    const { logger, desktop } = omega;
 
     // Add your main-window UI logic here.
     // ...

package/dist/defaults/src/assets/js/components/settings/index.js

@@ -1,10 +1,8 @@
 // Settings window renderer entry.
-const Manager = require('@omega.js/desktop/renderer');
+import omega from '@omega.js/desktop/renderer';
 
-const manager = new Manager();
-
-manager.initialize()
+omega.initialize()
   .then(() => {
-    const { logger } = manager;
+    const { logger } = omega;
     logger.log('Settings window initialized!');
   });

package/dist/defaults/src/integrations/context-menu/index.js

@@ -1,6 +1,6 @@
 // Context-menu definition. Called by @omega.js/desktop EVERY time the user right-clicks.
 //
-// `manager`     — the running @omega.js/desktop Manager.
+// `omega`: the running @omega.js/desktop main-process instance.
 // `menu`        — per-event builder API + id-path API.
 // `params`      — Electron's context-menu params (selectionText, isEditable, linkURL,
 //                 srcURL, mediaType, editFlags, x, y, etc.).
@@ -17,7 +17,7 @@
 //   reload                                        — always
 //   inspect, toggle-devtools                      — dev mode only
 
-module.exports = ({ manager, menu, params, webContents }) => {
+module.exports = ({ omega, menu, params, webContents }) => {
   // Start from @omega.js/desktop's default template. Don't add anything by default — leave it
   // identical to what the framework would do without this file.
   menu.useDefaults();

package/dist/defaults/src/integrations/menu/index.js

@@ -1,6 +1,6 @@
 // Application menu definition. Called by @omega.js/desktop during boot.
 //
-// `manager`  — the running @omega.js/desktop Manager.
+// `omega`: the running @omega.js/desktop main-process instance.
 // `menu`     — builder API + id-path API (find/update/remove/insertAfter/etc.).
 // `defaults` — the platform-aware default template (an array you can mutate manually if needed).
 //
@@ -18,7 +18,7 @@
 //   development/{open-exe-folder, open-user-data, open-logs, open-app-config,
 //                test-error}                                                       (dev only)
 
-module.exports = ({ manager, menu, defaults }) => {
+module.exports = ({ omega, menu, defaults }) => {
   // Start from the platform-appropriate default template. Don't add anything
   // by default — leave it identical to what the framework would do without
   // this file. Add your own customizations below.
@@ -34,7 +34,7 @@ module.exports = ({ manager, menu, defaults }) => {
   // menu.insertAfter('main/check-for-updates', {
   //   id: 'main/account',
   //   label: 'Account...',
-  //   click: () => manager.windows.show('account'),
+  //   click: () => omega.windows.show('account'),
   // });
   //
   // // Rename an existing item:

package/dist/defaults/src/integrations/tray/index.js

@@ -1,6 +1,6 @@
 // Tray definition. Called by @omega.js/desktop during boot.
 //
-// `manager` — the running @omega.js/desktop Manager.
+// `omega`: the running @omega.js/desktop main-process instance.
 // `tray`    — builder API + id-path API (find/update/remove/insertAfter/etc.).
 //
 // @omega.js/desktop auto-resolves the tray icon by convention (most specific wins):
@@ -19,7 +19,7 @@
 //
 // This file is OPTIONAL — delete it and @omega.js/desktop still ships a working tray.
 
-module.exports = ({ manager, tray }) => {
+module.exports = ({ omega, tray }) => {
   // Use @omega.js/desktop's default template + auto-resolved icon + auto-resolved tooltip.
   tray.useDefaults();
 
@@ -36,7 +36,7 @@ module.exports = ({ manager, tray }) => {
   // tray.insertAfter('open', {
   //   id: 'dashboard',
   //   label: 'Open Dashboard',
-  //   click: () => manager.windows.show('dashboard'),
+  //   click: () => omega.windows.show('dashboard'),
   // });
   //
   // // Rename an existing item:

package/dist/defaults/src/main.js

@@ -1,11 +1,9 @@
 // Main-process entry. Config is auto-loaded from config/omega.json5 (resolved for the desktop target).
-const Manager = require('@omega.js/desktop/main');
+const omega = require('@omega.js/desktop/main');
 
-const manager = new Manager();
-
-manager.initialize()
+omega.initialize()
   .then(() => {
-    const { logger, ipc, storage, windows, tray, menu, contextMenu, deepLink, autoUpdater, omega, appState, sentry, startup } = manager;
+    const { logger, ipc, storage, windows, tray, menu, contextMenu, deepLink, autoUpdater, auth, appState, sentry, startup } = omega;
 
     // ─────────────────────────────────────────────────────────────────────────────
     // 1. Create the main window

package/dist/defaults/src/preload.js

@@ -1,11 +1,9 @@
 // Preload entry. Exposes window.desktop to the renderer via contextBridge.
-const Manager = require('@omega.js/desktop/preload');
+const omega = require('@omega.js/desktop/preload');
 
-const manager = new Manager();
-
-manager.initialize()
+omega.initialize()
   .then(() => {
-    const { logger } = manager;
+    const { logger } = omega;
 
     // Add any extra contextBridge-exposed APIs here. Be careful — anything you expose runs
     // in the renderer's context, so don't pass through privileged Node APIs without care.

package/dist/defaults/test/README.md

@@ -23,13 +23,13 @@ Every feature ships with tests at every layer it has a surface in — logic (`bu
 
 ```js
 // test/build/my-feature.test.js
-const Manager = require('@omega.js/desktop/build');
+const build = require('@omega.js/desktop/build');
 
 module.exports = {
   layer: 'build',
   description: 'the project config carries a brand id',
   run: (ctx) => {
-    ctx.expect(Manager.getConfig().brand.id).toBeTruthy();
+    ctx.expect(build.getConfig().brand.id).toBeTruthy();
   },
 };
 ```

package/dist/gulp/main.js

@@ -3,17 +3,17 @@
 delete process.env.ELECTRON_RUN_AS_NODE;
 
 // Libraries
-const Manager = new (require('../build.js'));
-const logger = Manager.logger('main');
-const argv = Manager.getArguments();
+const build = require('../build.js');
+const logger = build.logger('main');
+const argv = build.getArguments();
 const { series, parallel } = require('gulp');
 const path = require('path');
 const glob = require('glob').globSync;
 
 // Load packages
-const package = Manager.getPackage('main');
-const project = Manager.getPackage('project');
-const projectRoot = Manager.getRootPath('project');
+const package = build.getPackage('main');
+const project = build.getPackage('project');
+const projectRoot = build.getRootPath('project');
 
 // Resolve the .env cascade from the project root (shell > app > brand > company)
 // and derive the signing paths the brand's signing tree implies. gulp is its own
@@ -40,7 +40,7 @@ if (sanitizedSigningKeys.length) {
 const attachLogFile = require('../utils/attach-log-file.js');
 const logFileEnv = process.env.OMEGA_LOG_FILE;
 if (logFileEnv !== 'false' && logFileEnv !== '0') {
-  const defaultName = Manager.isBuildMode() ? 'build.log' : 'dev.log';
+  const defaultName = build.isBuildMode() ? 'build.log' : 'dev.log';
   const logPath = (logFileEnv && logFileEnv !== 'true') ? logFileEnv : path.join(projectRoot, 'logs', defaultName);
   attachLogFile(logPath);
   logger.log(`Logs tee'd to ${logPath}`);
@@ -54,7 +54,7 @@ logger.log('Starting...', argv);
 // Auto-load tasks from src/gulp/tasks/*.js
 const tasks = glob('*.js', { cwd: `${__dirname}/tasks` });
 
-// Globals (parity with BXM)
+// Globals (the same pair @omega.js/extension's gulp sets)
 global.tasks = {};
 global.websocket = null;
 
@@ -72,8 +72,7 @@ global.tasks = exports;
 const runConsumerHook = require('../utils/run-consumer-hook.js');
 function makeHookTask(name) {
   const fn = async () => {
-    const Manager = new (require('../build.js'));
-    await runConsumerHook(name, { manager: Manager, projectRoot: process.cwd(), mode: process.env.OMEGA_BUILD_MODE === 'true' ? 'production' : 'development' });
+    await runConsumerHook(name, { build, projectRoot: process.cwd(), mode: process.env.OMEGA_BUILD_MODE === 'true' ? 'production' : 'development' });
   };
   // Set displayName for nicer gulp logs.
   Object.defineProperty(fn, 'name', { value: `hook:${name.replace('/', ':')}` });

package/dist/gulp/tasks/audit.js

@@ -19,14 +19,14 @@
 
 const path    = require('path');
 const jetpack = require('fs-jetpack');
-const Manager = new (require('../../build.js'));
+const build = require('../../build.js');
 const { validateConfig, releasesRepo, hasOmegaConfig, loadConfig } = require('../../vendor/config/index.js');
 
-const logger = Manager.logger('audit');
+const logger = build.logger('audit');
 
 module.exports = function audit(done) {
   const cwd      = process.cwd();
-  const config   = Manager.getConfig();
+  const config   = build.getConfig();
   const errors   = [];
   const warnings = [];
 
@@ -45,11 +45,11 @@ module.exports = function audit(done) {
   // while reporting `0 warnings` ([#911](https://github.com/Omega-JS-Stack/omega/issues/911)).
   // A key the schema does not declare is what a typo looks like, and the
   // consumer has to see it at build time. They come off the LOAD, the same
-  // resolution `Manager.getConfig()` runs: loadConfig judges what the brand
+  // resolution `build.getConfig()` runs: loadConfig judges what the brand
   // AUTHORED, before the loader fills its own resolved facts (`company.name`
   // and friends) and before the build attaches `environment`.
   const { warnings: configWarnings } = hasOmegaConfig(cwd)
-    ? loadConfig(cwd, 'desktop', { environment: Manager.getEnvironment() })
+    ? loadConfig(cwd, 'desktop', { environment: build.getEnvironment() })
     : { warnings: [] };
   warnings.push(...configWarnings);
 
@@ -57,14 +57,14 @@ module.exports = function audit(done) {
   // tied to the build pipeline, not the config shape).
   fileMustExist('src/main.js',    'src/main.js');
   fileMustExist('src/preload.js', 'src/preload.js');
-  if (Manager.isPublishMode() || Manager.isBuildMode()) {
+  if (build.isPublishMode() || build.isBuildMode()) {
     // Icon must exist when packaging — dev runs fine with the default Electron icon.
     fileMustExist(config.brand.images?.icon, 'config.brand.images.icon');
   }
   // Publishing needs an ADDRESS for the releases repo, and no repo name is ever
   // typed: @omega.js/config's releasesRepo derives `<brand.id>-releases` under
   // the brand's org, so only a missing org (or brand.id) leaves it unaddressable.
-  if (Manager.isPublishMode() && config.releases?.enabled !== false && !releasesRepo(config)) {
+  if (build.isPublishMode() && config.releases?.enabled !== false && !releasesRepo(config)) {
     errors.push('the releases repo is unaddressable: set repo.org and brand.id. The repo is always "<brand.id>-releases" under that org');
   }