@omega.js/desktop 0.52.0 → 0.54.0

package/dist/defaults/AGENTS.md

@@ -1,110 +0,0 @@
-# ========== Default Values ==========
-# OMEGA Desktop (@omega.js/desktop) consumer project
-
-<!-- MAINTAINERS (framework repo): this consumer template is MIRRORED across all OMEGA framework consumer templates (src/defaults/AGENTS.md ×N; web's lives at scaffold/AGENTS.md).
-  Same sections in the same order: framework-specific extras may be inserted; canonical sections are never reordered/renamed. Edit every framework consumer template together.
-  The mirroring rule lives in each framework guide's Doc-update parity section (docs/<framework>/index.md) -->
-
-## Framework
-
-This project consumes **OMEGA Desktop** (@omega.js/desktop), a comprehensive framework for building modern Electron desktop apps. @omega.js/desktop provides one-line-import bootstrap per Electron process, a modular feature library with file-based extensibility, a multi-platform build/release pipeline (DMG / NSIS / deb / AppImage), and a built-in four-layer test framework.
-
-## 🚨 READ THE FRAMEWORK DOCS FIRST
-
-**Before doing ANY work on this codebase, the agent MUST read the framework documentation: that is where the architecture, conventions, APIs, and gotchas live. Skipping these will result in solutions that conflict with framework patterns.**
-
-**Required reading:**
-- **`node_modules/@omega.js/AGENTS.md`**: the OMEGA map, the one agent entry into the framework docs; follow it to `docs/desktop/index.md` (the @omega.js/desktop guide: identity, architecture, conventions)
-- **`node_modules/@omega.js/desktop/docs/`**: subsystem deep references (read the relevant ones for the task at hand)
-
-## 🚨 READ @omega.js/client TOO
-
-**@omega.js/desktop ships `@omega.js/client` as a runtime singleton inside the renderer process.**
-- It powers auth, Firebase, reactive `data-omega-bind` directives, analytics, error tracking, and utilities (`escapeHTML`, etc.).
-- 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:**
-- **`node_modules/@omega.js/AGENTS.md`** → `docs/client/index.md`, the @omega.js/client guide: identity, module list, conventions
-- **`node_modules/@omega.js/client/docs/`**: module deep references (Auth, Bindings, Firestore, Notifications, etc.)
-
-## Quick start
-
-```bash
-npm start           # dev with auto-reload (gulp → esbuild → electron .)
-npm run build       # local production build (compiles bundles only, no installer)
-npm run package     # full local production package (DMG/zip/universal-mac, NSIS-win, deb+AppImage-linux)
-npm run package:quick   # fast packaged build for the host platform/arch only (~20-30s)
-npm run release     # signed + published release (requires certs)
-npx omega test        # run YOUR project's test suites (bare runs never include the framework corpus)
-npx omega test build/config         # run project tests by path (relative to test/; full:<path> for both sources)
-npx omega test project:             # run ONLY your project tests (all of them)
-npx omega test project:custom-test  # run only consumer project tests matching a path
-npx omega test mgr:                 # run ONLY framework tests (universal alias; desktop:/framework: are equivalent)
-npx omega test desktop:build/config      # run only framework tests matching a path
-npx omega test --extended           # also run tests that hit REAL external services (off by default; TEST_EXTENDED_MODE=true is the env equivalent, a shared name across @omega.js/backend, @omega.js/extension, UJM, and @omega.js/desktop)
-# (output is teed to logs/: dev.log on `npm start`, build.log on `npm run build`, test.log on `npx omega test`; cat instead of scrolling scrollback)
-npx omega install dev  # use LOCAL @omega.js/desktop source (to test framework edits)
-npx omega install live # restore the published @omega.js/desktop from npm
-```
-
-> Editing the @omega.js/desktop framework source while working here? Run `npx omega install dev` so this project picks up your uncommitted framework changes (it otherwise uses its installed `node_modules/@omega.js/desktop`). Run `npx omega install live` to switch back.
-
-## Where things live
-
-- `config/omega.json5`: the single OMEGA config (JSON5), with shared sections (brand, analytics, payment, cloud, monitoring, theme) at the top level; desktop settings (app, platforms, autoUpdate, startup, releases, remoteConfig, restartManager) under `targets.desktop`.
-  - What the app SHIPS is one declaration: `platforms.<mac|windows|linux>.formats.<dmg|nsis|deb|appimage|snap>`. Presence = enabled, every platform and format is on by default, and `false` drops one (`snap: false`). Per-format settings live inside the format.
-- Packaging config: fully generated. @omega.js/desktop produces `dist/electron-builder.yml` from `config/omega.json5` (brand/app/signing) + @omega.js/desktop's opinionated defaults. Consumers never ship an `electron-builder.yml`. Override defaults via the `electronBuilder:` block in `omega.json5` if you genuinely need to.
-- `hooks/notarize/post.js`: optional post-notarize extension hook (@omega.js/desktop owns the actual `afterSign` notarize step).
-- `src/main.js`: main-process entry. One-line bootstrap of `@omega.js/desktop/main`.
-- `src/preload.js`: preload entry. Exposes `window.desktop` via contextBridge.
-- `src/integrations/tray/index.js`: tray definition. Edit this; it's yours.
-- `src/integrations/menu/index.js`: application menu definition.
-- `src/integrations/context-menu/index.js`: right-click menu definition (called per-event with `params`).
-- `src/views/<window>/index.html`: per-window HTML.
-- `src/assets/js/components/<window>/index.js`: renderer entry per window.
-- `src/assets/scss/main.scss`: shared SCSS.
-- `config/icons/<platform>/<slot>.png`: optional icon overrides (`mac/icon.png`, `mac/tray.png`, `mac/dmg.png`, `windows/icon.png`, etc.; the platform words are `mac`, `windows`, `linux`).
-  - Ship ONE file per slot at the native (retina) size; @omega.js/desktop auto-downscales @1x variants.
-  - macOS tray must be 32×32 (@omega.js/desktop renames to `trayTemplate.png` in dist for the OS dark-mode magic).
-  - Missing slots fall back to @omega.js/desktop bundled defaults; Linux falls back to Windows resolution.
-- `test/**/*.js`: your project test suites (framework auto-runs them alongside its own).
-
-## Per-context imports
-
-```js
-// src/main.js
-new (require('@omega.js/desktop/main'))().initialize();   // auto-loads JSON5 config
-
-// src/preload.js
-new (require('@omega.js/desktop/preload'))().initialize();
-
-// src/assets/js/components/main/index.js
-new (require('@omega.js/desktop/renderer'))().initialize();
-```
-
-## 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 renderer: `window.desktop.storage`, `window.desktop.ipc`, `window.desktop.logger`, `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).
-
-## Testing
-
-Every feature ships with tests at every layer it has a surface in: **logic** (`test/build/`, `test/main/`), **UI** (`test/renderer/`: real events on the real DOM), and **end-to-end** (`test/boot/`).
-- Skip a layer only when the feature genuinely has no surface there; "the logic test covers it" does not excuse the UI test.
-- Test runs are invisible and never steal keyboard focus (@omega.js/desktop test stealth; set `OMEGA_TEST_SHOW=1` to watch a run live).
-- See `test/README.md` and `node_modules/@omega.js/desktop/docs/test-framework.md`.
-
-<!-- Everything above this marker is owned by the framework and rewritten by every omega verb. Add your project-specific notes below — they are preserved. -->
-
-# ========== Custom Values ==========
-
-## Project-specific notes
-
-Add anything specific to THIS project here. Edits below this line are preserved across framework re-syncs.

package/dist/defaults/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/dist/lib/client-bridge.js

@@ -1,374 +0,0 @@
-// Client bridge — main-process Firebase Auth, source of truth for renderers.
-//
-// This is @omega.js/desktop's analogue of BXM's background-service-worker auth role. The pattern:
-//
-//   1. Main runs its own Firebase Auth instance and is the source of truth.
-//   2. When a deep-link auth/token arrives, main calls signInWithCustomToken with that token,
-//      then BROADCASTS the token to all renderer windows so their @omega.js/client Firebase
-//      instances can sign in with the SAME token.
-//   3. On every renderer load, the renderer asks main "I'm at UID X (or null)" via the
-//      desktop:auth:sync-request IPC. Main compares with its own UID and either does nothing,
-//      tells the renderer to sign out, or fetches a fresh custom token from /omega
-//      and sends it to the renderer.
-//   4. Sign-out: any renderer can request sign-out via desktop:auth:sign-out. Main signs out
-//      its own Firebase + broadcasts desktop:auth:sign-out to all renderers.
-//
-// Firebase is BUNDLED by esbuild from @omega.js/desktop's module context (@omega.js/client owns it in @omega.js/desktop's
-// tree). If loading fails, the bridge stays in no-op mode and logs the reason.
-
-const LoggerLite = require('./logger-lite.js');
-const authPersistence = require('./auth-persistence.js');
-const { requiredPort } = require('../utils/url-helpers.js');
-
-const logger = new LoggerLite('client-bridge');
-
-const FIREBASE_APP_NAME = 'omega-auth';
-
-const bridge = {
-  _initialized:    false,
-  _manager:        null,
-  _firebase:       null,    // firebase/app
-  _firebaseAuth:   null,    // auth instance
-  _firebaseModule: null,    // firebase/auth namespace (signInWithCustomToken, signOut, ...)
-  _stateSubs:      new Set(), // main-side subscribers fn(user)
-  _ipcRegistered:  false,
-  _resolvedPlan:   null,    // renderer-resolved subscription { plan, active, trialing, cancelling }
-  _resolvedRoles:  null,    // renderer-resolved account roles { admin, betaTester, ... }
-
-  async initialize(manager) {
-    if (bridge._initialized) {
-      return;
-    }
-
-    bridge._manager = manager;
-
-    // Try to load firebase. If it's not installed, run in no-op mode.
-    const ok = await bridge._tryLoadFirebase();
-    if (!ok) {
-      logger.warn('firebase not installed — client-bridge running in no-op mode. `npm i firebase` to enable auth.');
-    }
-
-    bridge._registerIpc();
-
-    if (ok) {
-      // Boot Firebase Auth. With a persistence strategy active (lib/auth-persistence.js,
-      // default safeStorage), the session survives restarts — the restore lands async
-      // via onAuthStateChanged shortly after boot.
-      try {
-        const strategy = await authPersistence.resolve(manager);
-        bridge._firebaseAuth = bridge._getFirebaseAuth(strategy);
-        // onAuthStateChanged is the source of truth listener.
-        bridge._firebaseModule.onAuthStateChanged(bridge._firebaseAuth, (user) => {
-          bridge._handleAuthStateChange(user);
-        });
-        logger.log(`initialize — firebase loaded (persistence: ${strategy ? strategy.name : 'in-memory'})`);
-      } catch (e) {
-        logger.error('firebase init failed:', e.message);
-      }
-    }
-
-    bridge._initialized = true;
-  },
-
-  // Load firebase. Returns true on success. BUNDLED by esbuild from @omega.js/desktop's module context
-  // (@omega.js/client owns firebase in @omega.js/desktop's tree) — same treatment as json5 in main.js. In the
-  // webpack era it was a webpackIgnore'd runtime import(), which resolves relative to the CONSUMER's
-  // main.bundle.js: that walk never reaches @omega.js/desktop's node_modules when @omega.js/desktop is symlinked
-  // (`mgr install dev`) and depends on npm hoisting when installed — every dev app silently
-  // ran the bridge in no-op mode. Interop guards handle both namespace shapes (json5 precedent).
-  async _tryLoadFirebase() {
-    try {
-      const appMod  = require('firebase/app');
-      const authMod = require('firebase/auth');
-
-      bridge._firebase       = appMod.initializeApp ? appMod : (appMod.default || appMod);
-      bridge._firebaseModule = authMod.getAuth      ? authMod : (authMod.default || authMod);
-      return true;
-    } catch (e) {
-      logger.warn('firebase load failed:', e.message);
-      return false;
-    }
-  },
-
-  _getFirebaseAuth(strategy) {
-    if (bridge._firebaseAuth) return bridge._firebaseAuth;
-
-    const firebaseConfig = bridge._manager.config.cloud?.config;
-    if (!firebaseConfig || !Object.keys(firebaseConfig).length) {
-      throw new Error('cloud.config is empty — cannot initialize auth.');
-    }
-
-    const { initializeApp, getApp } = bridge._firebase;
-    const { getAuth, initializeAuth } = bridge._firebaseModule;
-
-    let app;
-    try { app = getApp(FIREBASE_APP_NAME); }
-    catch (e) { app = initializeApp(firebaseConfig, FIREBASE_APP_NAME); }
-
-    // With a storage strategy, boot auth on OUR persistence (session survives
-    // restarts); without one, firebase's Node default (in-memory) applies.
-    if (strategy && initializeAuth) {
-      bridge._firebaseAuth = initializeAuth(app, {
-        persistence: [authPersistence.buildFirebasePersistence(strategy)],
-      });
-    } else {
-      bridge._firebaseAuth = getAuth(app);
-    }
-
-    // A TESTING run talks to the LOCAL stack, never real auth — the same move
-    // getApiUrl() makes when it maps testing to localhost, and the same one
-    // @omega.js/extension's background SW makes for its emulator runs. Only an
-    // OMEGA_ENVIRONMENT=testing run reaches here; dev and production are untouched.
-    if (bridge._manager.isTesting()) {
-      const { connectAuthEmulator } = bridge._firebaseModule;
-      const port = bridge._authEmulatorPort();
-      logger.log(`testing run — connecting auth to the emulator on :${port}`);
-      connectAuthEmulator(bridge._firebaseAuth, `http://localhost:${port}`, { disableWarnings: true });
-    }
-
-    return bridge._firebaseAuth;
-  },
-
-  // The auth emulator's port, on the same chain getApiUrl() walks: the
-  // resolved-port env channel (N7), then the `dev.ports` map the bundle baked
-  // into OMEGA_BUILD_JSON
-  // ([#745](https://github.com/Omega-JS-Stack/omega/issues/745)). The classic
-  // 9099 used to sit under those two as a last resort; it is gone (#834),
-  // because nothing identity-checks what answers on it and a neighbouring
-  // project's emulator reads as an auth mystery rather than a port problem.
-  _authEmulatorPort() {
-    return requiredPort(bridge._manager, 'OMEGA_AUTH_PORT', 'auth');
-  },
-
-  _registerIpc() {
-    if (bridge._ipcRegistered) return;
-    const ipc = bridge._manager.ipc;
-
-    // Renderer asks main: "I'm at UID X (or null). Are we in sync?"
-    ipc.handle('desktop:auth:sync-request', async ({ contextUid }) => {
-      return bridge._handleSyncRequest(contextUid);
-    });
-
-    // Renderer asks main to sign out.
-    ipc.handle('desktop:auth:sign-out', async () => {
-      return bridge._handleSignOut();
-    });
-
-    // Renderer asks main for the current user (uid + email + displayName, no token).
-    ipc.handle('desktop:auth:get-user', () => {
-      const u = bridge._firebaseAuth?.currentUser;
-      return u ? bridge._snapshotUser(u) : null;
-    });
-
-    // Renderer pushes its @omega.js/client account resolution (auth().listen() settled:
-    // Firestore account fetched, subscription resolved). Main can't run Firestore,
-    // so this is how main-side plan gates learn the REAL plan — BXM's "browser
-    // contexts resolve, authority caches" split. UID-guarded: a stale push from a
-    // renderer that hasn't synced yet is dropped.
-    ipc.handle('desktop:auth:account-resolved', ({ uid, resolved, roles } = {}) => {
-      const mainUid = bridge._firebaseAuth?.currentUser?.uid || null;
-      if (!uid || uid !== mainUid) {
-        return { accepted: false };
-      }
-
-      const changed = JSON.stringify(resolved) !== JSON.stringify(bridge._resolvedPlan)
-        || JSON.stringify(roles || null) !== JSON.stringify(bridge._resolvedRoles);
-      bridge._resolvedPlan  = resolved || null;
-      bridge._resolvedRoles = roles || null;
-
-      if (changed) {
-        logger.log(`account resolved — plan=${resolved?.plan || '(none)'} active=${!!resolved?.active}`);
-        bridge._manager.ipc.broadcast('desktop:auth:plan-changed', { resolved: bridge._resolvedPlan, roles: bridge._resolvedRoles });
-        // Main-side subscribers see the same user snapshot again with plan now known.
-        const u = bridge._firebaseAuth?.currentUser;
-        bridge._stateSubs.forEach((fn) => {
-          try { fn(u ? bridge._snapshotUser(u) : null); } catch (e) { logger.error('onAuthChange subscriber threw:', e); }
-        });
-      }
-      return { accepted: true };
-    });
-
-    bridge._ipcRegistered = true;
-  },
-
-  _handleAuthStateChange(user) {
-    logger.log(`auth state → ${user ? user.email : 'signed out'}`);
-
-    // Sign-out (or a different user signing in) invalidates the cached resolution —
-    // renderers re-resolve and push fresh via desktop:auth:account-resolved.
-    if (!user) {
-      bridge._resolvedPlan = null;
-      bridge._resolvedRoles = null;
-    }
-
-    // Notify any main-side subscribers (consumer code that called manager.omega.onAuthChange).
-    const snap = user ? bridge._snapshotUser(user) : null;
-    bridge._stateSubs.forEach((fn) => {
-      try { fn(snap); } catch (e) { logger.error('onAuthChange subscriber threw:', e); }
-    });
-
-    // Tell renderers about the change so they can update UI / refresh menu items.
-    bridge._manager.ipc.broadcast('desktop:auth:state-changed', snap);
-
-    // Attribute Sentry events to the signed-in user (or clear on sign-out). When
-    // sentry is disabled (no DSN, dev mode, etc.) setUser is a documented no-op.
-    bridge._manager.sentry.setUser(snap);
-  },
-
-  // BXM's syncAuth pattern, ported to Electron.
-  async _handleSyncRequest(contextUid) {
-    if (!bridge._firebaseAuth) {
-      return { needsSync: false, reason: 'firebase-not-loaded' };
-    }
-
-    const bgUser = bridge._firebaseAuth.currentUser;
-    const bgUid = bgUser?.uid || null;
-
-    // Already in sync.
-    if (contextUid === bgUid) {
-      return { needsSync: false };
-    }
-
-    // Renderer signed in but main signed out → tell renderer to sign out.
-    if (!bgUser && contextUid) {
-      return { needsSync: true, signOut: true };
-    }
-
-    // Main signed in, renderer not (or different user) → fetch a fresh custom token + send.
-    try {
-      const token = await bridge._fetchCustomToken(bgUser);
-      return {
-        needsSync: true,
-        customToken: token,
-        user: bridge._snapshotUser(bgUser),
-      };
-    } catch (e) {
-      logger.error('sync-request: failed to fetch custom token:', e.message);
-      return { needsSync: false, error: e.message };
-    }
-  },
-
-  async _handleSignOut() {
-    try {
-      if (bridge._firebaseAuth?.currentUser) {
-        await bridge._firebaseModule.signOut(bridge._firebaseAuth);
-      }
-      bridge._manager.ipc.broadcast('desktop:auth:sign-out', {});
-      return { success: true };
-    } catch (e) {
-      logger.error('sign-out failed:', e.message);
-      return { success: false, error: e.message };
-    }
-  },
-
-  // Public API ──────────────────────────────────────────────────────────────────
-
-  // Called by lib/deep-link's auth/token built-in.
-  async handleAuthToken(token) {
-    if (!bridge._firebaseAuth) {
-      logger.warn('handleAuthToken called but firebase not loaded — ignoring.');
-      return { success: false, reason: 'firebase-not-loaded' };
-    }
-    if (!token) {
-      logger.warn('handleAuthToken called with no token — ignoring.');
-      return { success: false, reason: 'no-token' };
-    }
-
-    try {
-      const cred = await bridge._firebaseModule.signInWithCustomToken(bridge._firebaseAuth, token);
-      logger.log(`signed in: ${cred.user.email || cred.user.uid}`);
-
-      // Broadcast the token to renderers so they can sign in with the SAME token.
-      // Tokens expire in 1 hour and aren't stored.
-      bridge._manager.ipc.broadcast('desktop:auth:sign-in-with-token', { token });
-
-      return { success: true, user: bridge._snapshotUser(cred.user) };
-    } catch (e) {
-      logger.error('signInWithCustomToken failed:', e.message);
-      return { success: false, error: e.message };
-    }
-  },
-
-  // Subscribe to auth state changes on the main side (e.g. for menu/tray refresh).
-  onAuthChange(fn) {
-    bridge._stateSubs.add(fn);
-    return () => bridge._stateSubs.delete(fn);
-  },
-
-  // Snapshot of the current user (sync), or null.
-  getCurrentUser() {
-    const u = bridge._firebaseAuth?.currentUser;
-    return u ? bridge._snapshotUser(u) : null;
-  },
-
-  // The renderer-resolved subscription ({ plan, active, trialing, cancelling }) or null
-  // while no renderer has resolved yet. THE main-side plan source — consumer plan gates
-  // read this (@omega.js/client's resolveSubscription output, pushed via desktop:auth:account-resolved).
-  getResolvedPlan() {
-    return bridge._resolvedPlan;
-  },
-
-  // The renderer-resolved account roles ({ admin, betaTester, ... }) or null.
-  getResolvedRoles() {
-    return bridge._resolvedRoles;
-  },
-
-  // Fresh Firebase ID token for the signed-in user (async), or null when
-  // signed out / Firebase absent. For consumer main code calling
-  // authenticated backend routes (`Authorization: Bearer <token>`).
-  async getIdToken() {
-    const u = bridge._firebaseAuth?.currentUser;
-    return u ? u.getIdToken() : null;
-  },
-
-  // Force sign-out from main code.
-  async signOut() {
-    return bridge._handleSignOut();
-  },
-
-  // ─── Internals ────────────────────────────────────────────────────────────
-
-  _snapshotUser(user) {
-    return {
-      uid:           user.uid,
-      email:         user.email,
-      displayName:   user.displayName,
-      photoURL:      user.photoURL,
-      emailVerified: user.emailVerified,
-    };
-  },
-
-  // Fetch a fresh custom token for the currently-signed-in user via the shared
-  // @omega.js/client request layer. Mirrors BXM: POST <apiUrl>/omega/user/token —
-  // the route defaults uid to the authenticated caller and responds { token }
-  // at the top level.
-  async _fetchCustomToken(user) {
-    const { createRequest } = require('@omega.js/client/modules/request.js');
-
-    const request = createRequest({
-      getApiUrl: () => bridge._manager.getApiUrl(),
-      getIdToken: (force) => user.getIdToken(force),
-    });
-
-    const data = await request('/omega/user/token', { method: 'POST', body: {} });
-
-    const token = data?.token;
-    if (!token) {
-      throw new Error('@omega.js/backend response missing token.');
-    }
-    return token;
-  },
-
-  // Tear-down used by tests — wipes state but keeps registered IPC handlers
-  // (they're idempotent via `ipc.handle` duplicate-detection).
-  async _resetForTests() {
-    try {
-      if (bridge._firebaseAuth?.currentUser && bridge._firebaseModule?.signOut) {
-        await bridge._firebaseModule.signOut(bridge._firebaseAuth);
-      }
-    } catch (e) { /* ignore */ }
-    bridge._stateSubs.clear();
-  },
-};
-
-module.exports = bridge;

package/dist/lib/logger.js

@@ -1,4 +0,0 @@
-// Shared devkit module — vendored into dist/vendor/devkit at prepare time by the
-// preparePackage `after` hook. This shim keeps the framework's internal require
-// paths stable while the implementation lives in @omega.js/devkit.
-module.exports = require('../vendor/devkit/logger.js');