@omega.js/desktop 0.53.0 → 0.54.1

package/dist/defaults/config/omega.json5

@@ -1,13 +1,13 @@
-// config/omega.json5 — the single OMEGA config file (JSON5: comments + trailing commas OK).
+// config/omega.json5: the single OMEGA config file (JSON5: comments + trailing commas OK).
 //
 // Shape: SHARED sections at the top level (identical spelling in every OMEGA project
-// type — website, backend, extension, desktop), then a `targets` object whose KEY
+// type: website, backend, extension, desktop), then a `targets` object whose KEY
 // PRESENCE says which targets this brand enables and whose values hold target-scoped
 // settings. Any shared key may also appear inside a target entry to override it for
 // that surface only (e.g. a desktop-specific monitoring.providers.sentry.dsn
 // under targets.desktop).
 //
-// Secrets NEVER live here — they live in .env. The validator hard-fails on
+// Secrets NEVER live here: they live in .env. The validator hard-fails on
 // secret-shaped keys (…Secret, …privateKey).
 {
   brand: {
@@ -48,7 +48,7 @@
   // so the same human gets unified events across desktop + web + backend.
   analytics: {
     // Presence-driven: set `providers.google.id` to `G-XXXXXXXXXX` to enable analytics.
-    // Empty string = analytics disabled (matches @omega.js/backend convention — no redundant enabled flag).
+    // Empty string = analytics disabled (matches @omega.js/backend convention, no redundant enabled flag).
     providers: {
       google: {
         id: '',                               // 'G-XXXXXXXXXX' Measurement ID
@@ -56,7 +56,7 @@
     },
   },
 
-  // Payment — @omega.js/backend-shaped so the same product catalog can be referenced from backend
+  // Payment: @omega.js/backend-shaped so the same product catalog can be referenced from backend
   // + desktop. The schema enforces publishableKey shape when set; everything else is
   // freeform so apps can extend per their needs without @omega.js/desktop caring. Leave empty until
   // you're ready to wire payments.
@@ -69,7 +69,7 @@
   },
 
   // App/cloud platform role (provider-discriminated). `config` is the Firebase web
-  // SDK config — copy directly from Firebase Console → Project Settings → SDK setup
+  // 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 (the auth lib logs a warn).
   cloud: {
@@ -86,10 +86,10 @@
     },
   },
 
-  // Appearance — the app's DEFAULT theme. 'system' follows the OS preference live;
+  // Appearance: the app's DEFAULT theme. 'system' follows the OS preference live;
   // '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.
+  // every boot. See @omega.js/manager/docs/desktop/themes.md.
   theme: {
     appearance: 'system',
   },
@@ -102,7 +102,7 @@
     desktop: {
       type: 'desktop',
 
-      // App-level metadata — universal cross-platform fields. @omega.js/desktop auto-derives sensible
+      // App-level metadata: universal cross-platform fields. @omega.js/desktop auto-derives sensible
       // defaults from the BRAND: `appId` ← `certificates.providers.apple.bundleIdPrefix`
       // plus `brand.id` with its dashes as dots (`com.example` + `my-app` →
       // `com.example.my.app`), the same id the certificates service registers.
@@ -111,11 +111,11 @@
       // `productName` ← `brand.name`, `copyright` ← `© <year>, <brand.name>`.
       // Override any of these explicitly only if you must.
       //
-      // `category` is a generic high-level category — @omega.js/desktop maps it to per-platform values
+      // `category` is a generic high-level category. @omega.js/desktop maps it to per-platform values
       // (mac uses Apple's UTI strings, linux uses freedesktop categories). Allowed values:
       //   productivity (default) | developer-tools | utilities | media | social | network
       // Override the per-platform mapping in `platforms.<plat>.category` if you need
-      // something specific. See docs/installer-options.md for the full table.
+      // something specific. See @omega.js/manager/docs/desktop/installer-options.md for the full table.
       //
       // `copyright` accepts a `{YEAR}` token expanded at build time to the current year.
       // Default is `© {YEAR}, <brand.name>`. Set explicitly only to change the holder.
@@ -127,12 +127,12 @@
         languages:       ['en'],              // applied as mac.electronLanguages
         darkModeSupport: true,                // mac honors via NSRequiresAquaSystemAppearance; win/linux ignore
         // Icons are convention-only. Drop PNGs at:
-        //   config/icons/global/<slot>.png       — universal default for all platforms
+        //   config/icons/global/<slot>.png       : universal default for all platforms
         //   config/icons/mac/<slot>.png          : macOS override (beats global)
-        //   config/icons/windows/<slot>.png      — Windows override
-        //   config/icons/linux/<slot>.png        — Linux override (otherwise falls back to global → windows)
+        //   config/icons/windows/<slot>.png      : Windows override
+        //   config/icons/linux/<slot>.png        : Linux override (otherwise falls back to global → windows)
         // Slots: icon, tray (mac+win+linux); dmg (mac-only).
-        // Native size only — @omega.js/desktop downscales @1x variants from your @2x source automatically.
+        // Native size only: @omega.js/desktop downscales @1x variants from your @2x source automatically.
         // macOS tray must be 32×32; @omega.js/desktop renames the dist output to trayTemplate.png for the
         // OS dark-mode auto-inversion magic.
       },
@@ -145,7 +145,7 @@
       // beside `formats` are install knobs that map onto the same
       // electron-builder concepts (`mac.target`, `win.target`, `linux.target`),
       // but @omega.js/desktop owns the actual target list so auto-update keeps
-      // working (see docs/installer-options.md for why). Each block exposes only
+      // working (see @omega.js/manager/docs/desktop/installer-options.md for why). Each block exposes only
       // the knobs that exist for that platform: there is no cross-platform
       // analog for any of these.
       platforms: {
@@ -156,7 +156,7 @@
           formats: {
             dmg: {},
           },
-          arch: ['universal'],   // universal binary (x64 + arm64 lipo'd) — one .dmg/.zip for both
+          arch: ['universal'],   // universal binary (x64 + arm64 lipo'd), one .dmg/.zip for both
           // Entitlements override map. @omega.js/desktop ships sensible defaults (allow-jit,
           // allow-unsigned-executable-memory, disable-library-validation, network.client/server,
           // files.user-selected.read-write, allow-dyld-environment-variables). To override:
@@ -165,7 +165,7 @@
           // Output: dist/config/entitlements.mac.plist (auto-wired into electron-builder.yml).
           // Example: { 'com.apple.security.network.server': false, 'com.apple.security.device.audio-input': true }
           entitlements: {},
-          // MAS (Mac App Store) — STUBBED. Config is parsed but not yet implemented;
+          // MAS (Mac App Store): STUBBED. Config is parsed but not yet implemented;
           // setting `enabled: true` triggers an audit warning. Real implementation lands
           // in a future release. Reference plists from a working MAS-published Electron app
           // are archived at <em>/src/defaults/_mas/ for the eventual implementation.
@@ -189,12 +189,12 @@
           runAfterFinish:     true,
           perMachine:         false,       // per-user install (required for oneClick:true)
           // Code-signing strategy. Picked at workflow time to drive runner selection +
-          // job gating. See docs/signing.md.
-          //   self-hosted (default) — sign with signtool against an EV USB token (typically
+          // job gating. See @omega.js/manager/docs/desktop/signing.md.
+          //   self-hosted (default):  sign with signtool against an EV USB token (typically
           //                           on an framework-managed self-hosted GH Actions runner)
-          //   cloud                 — shell to a cloud signing provider's CLI (Azure /
-          //                           SSL.com / DigiCert) — provider configured in cloud.provider
-          //   local                 — skip CI signing; developer signs manually on their box
+          //   cloud:                  shell to a cloud signing provider's CLI (Azure /
+          //                           SSL.com / DigiCert), provider configured in cloud.provider
+          //   local:                  skip CI signing; developer signs manually on their box
           signing: {
             strategy: 'self-hosted',
             cloud:    { provider: null, options: {} },
@@ -225,9 +225,9 @@
         enabled:        true,
         autoDownload:   true,
         startupDelayMs:      10000,      // 10s after whenReady → first check
-        feedCheckIntervalMs: 3600000,    // 1h between feed polls (HTTP — keep slow)
+        feedCheckIntervalMs: 3600000,    // 1h between feed polls (HTTP, keep slow)
         idleEvalIntervalMs:  60000,      // 1m idle-install evaluator (cheap, in-process)
-        maxAgeMs:            2592000000, // 30d — once an update has been pending this long, force install
+        maxAgeMs:            2592000000, // 30d: once an update has been pending this long, force install
       },
       // Tray, menu, and context-menu are defined in JS files (full power, no DSL).
       // @omega.js/desktop looks for them at the conventional paths:
@@ -237,11 +237,11 @@
       // To disable at runtime: call `omega.tray.disable()` / `omega.menu.disable()` /
       // `omega.contextMenu.disable()` from your main entry. Idempotent.
 
-      // Startup behavior — two independent knobs.
+      // Startup behavior: two independent knobs.
       //
       // `mode` controls how the app launches when THE USER opens it directly:
-      //   normal — main window appears, dock icon visible (typical app).
-      //   hidden — packaged builds bake LSUIElement=true into Info.plist on macOS:
+      //   normal:  main window appears, dock icon visible (typical app).
+      //   hidden:  packaged builds bake LSUIElement=true into Info.plist on macOS:
       //            zero dock bounce, no dock icon, not in Cmd+Tab. Tray + notifications
       //            + networking still work. Your main.js skips windows.create() at boot
       //            and surfaces UI later (typically from a tray click). When you do call
@@ -249,8 +249,8 @@
       //            appears alongside the window.
       //
       // `openAtLogin` controls auto-launch on OS login:
-      //   enabled — register the app with the OS to auto-launch (default true).
-      //   mode    — `hidden` (default) means at-login launches behave like `mode: 'hidden'`;
+      //   enabled:  register the app with the OS to auto-launch (default true).
+      //   mode:     `hidden` (default) means at-login launches behave like `mode: 'hidden'`;
       //             `normal` means the at-login launch shows UI like a normal launch.
       //   The login-launch mode applies ONLY when the OS launches the app. User-direct
       //   launches always use `startup.mode` above. So a "normal" app can still start
@@ -262,7 +262,7 @@
           mode:    'hidden',
         },
       },
-      // No `windows` block needed — @omega.js/desktop no longer auto-creates windows. Your main.js
+      // No `windows` block needed: @omega.js/desktop no longer auto-creates windows. Your main.js
       // 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' }
@@ -276,7 +276,7 @@
       // `npx omega deploy`'s precheck auto-creates it if it doesn't exist (uses GH_TOKEN).
       // Artifact names carry NO version (MyApp-mac-dmg.dmg), so this repo also serves the marketing
       // site: https://github.com/<org>/<brand.id>-releases/releases/latest/download/<asset> never changes
-      // across versions, and the website derives its download buttons from it. See docs/releasing.md.
+      // across versions, and the website derives its download buttons from it. See @omega.js/manager/docs/desktop/releasing.md.
       releases: {
         enabled: true,
       },
@@ -286,7 +286,7 @@
       //   app/quit    → app.quit()
       // 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
+      // "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
       // toggle, default user agent strings, etc.). Default URL is derived as
       // `${brand.url}/data/resources/main.json` (legacy convention). Override the
@@ -296,11 +296,11 @@
         enabled: true,
         // url: 'https://brand.example/data/resources/main.json',   // default uses brand.url
       },
-      // Restart Manager — external guardian app that relaunches this app if it
-      // crashes. @omega.js/desktop talks to it over a localhost HTTP protocol (docs/restart-manager.md):
+      // Restart Manager: external guardian app that relaunches this app if it
+      // crashes. @omega.js/desktop talks to it over a localhost HTTP protocol (@omega.js/manager/docs/desktop/restart-manager.md):
       // auto-registers ~15s after launch, heartbeats every 60s, deregisters on clean
       // quit, and silently installs RM when missing (mac zip / win silent NSIS /
-      // linux AppImage — no installer UI, no admin; RM then keeps itself updated via
+      // linux AppImage: no installer UI, no admin; RM then keeps itself updated via
       // its own standard @omega.js/desktop auto-updater). Set false to disable entirely. In dev
       // mode it's skipped unless OMEGA_RESTART_MANAGER_DEV=1.
       restartManager: {

package/dist/defaults/docs/README.md

@@ -1,10 +1,10 @@
 # Project docs
 
-Per-subsystem deep references live here. Keep `AGENTS.md` short — it should read as a **table of contents** that points at files in this directory.
+Per-subsystem deep references live here. Keep `AGENTS.md` short: it should read as a **table of contents** that points at files in this directory.
 
 ## Pattern
 
-When you find yourself adding more than a paragraph to `AGENTS.md`, create a new `docs/<topic>.md` instead and link to it from `AGENTS.md`. Goal: the project's `AGENTS.md` stays under ~250 lines (`CLAUDE.md` is only the one-line `@AGENTS.md` pointer).
+When you find yourself adding more than a paragraph to `AGENTS.md`, create a new `docs/<topic>.md` instead and link to it from `AGENTS.md`. Goal: the project's `AGENTS.md` stays under ~250 lines.
 
 Examples of good `docs/*.md` topics:
 - Subsystem deep-dives (one per area of the codebase)
@@ -14,4 +14,4 @@ Examples of good `docs/*.md` topics:
 
 ## See also
 
-The framework's own docs follow this same pattern — browse `node_modules/@omega.js/desktop/docs/` for the canonical examples.
+The framework's own docs follow this same pattern: browse `node_modules/@omega.js/manager/docs/desktop/` for the canonical examples.

package/dist/defaults/gulpfile.js

@@ -1,4 +1,4 @@
-// Consumer gulpfile — the framework's gulp pipeline, resolved through the
+// Consumer gulpfile: the framework's gulp pipeline, resolved through the
 // require climb so it works wherever npm hoists the framework (brand-root
 // node_modules in a monorepo, local node_modules standalone). The old
 // scripts hardcoded ./node_modules/@omega.js/desktop/... and broke under

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

@@ -1,4 +1,4 @@
-// Optional consumer extension hook — called AFTER the build pipeline finishes, BEFORE
+// Optional consumer extension hook, called AFTER the build pipeline finishes, BEFORE
 // electron-builder packages anything. No-op by default.
 //
 // Use this for: post-build asset processing, additional file copies into dist/, generating

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

@@ -1,4 +1,4 @@
-// Optional consumer extension hook — called BEFORE the build pipeline runs (defaults →
+// Optional consumer extension hook, called BEFORE the build pipeline runs (defaults →
 // distribute → bundle → sass → html → audit → build-config). No-op by default.
 //
 // Use this for: pre-flight checks, generating build-time artifacts, mutating config before

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

@@ -1,4 +1,4 @@
-// Optional consumer extension hook — called AFTER @omega.js/desktop's built-in macOS
+// Optional consumer extension hook, called AFTER @omega.js/desktop's built-in macOS
 // notarization has already run. No-op by default.
 //
 // Use this for: custom stapling, archiving the notarized .app, notifications, uploading the
@@ -8,7 +8,7 @@
 //
 // IMPORTANT: This file is NOT the notarization entrypoint. @omega.js/desktop's electron-builder integration
 // uses its own internal notarize hook as the afterSign entrypoint, then calls into this file
-// as a final step. You can never accidentally break notarization by editing this — at worst,
+// as a final step. You can never accidentally break notarization by editing this. At worst,
 // a thrown error here fails the build loudly.
 
 module.exports = async (context) => {

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

@@ -1,4 +1,4 @@
-// Optional consumer extension hook — called AFTER the release publishes successfully (after
+// Optional consumer extension hook, called AFTER the release publishes successfully (after
 // electron-builder finishes). No-op by default.
 //
 // Use this for: posting to Slack/Discord, kicking off downstream workflows, updating a

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

@@ -1,4 +1,4 @@
-// Optional consumer extension hook — called BEFORE electron-builder runs the sign + notarize
+// Optional consumer extension hook, called BEFORE electron-builder runs the sign + notarize
 // + publish flow. No-op by default.
 //
 // Use this for: bumping version files in extra places, last-mile validations, archiving the

package/dist/defaults/src/assets/scss/pages/about.scss

@@ -1,3 +1,3 @@
-// About window — page-specific styles. Compiled to dist/assets/css/components/about.bundle.css.
+// About window: page-specific styles. Compiled to dist/assets/css/components/about.bundle.css.
 
 // Add your page-only styles below.

package/dist/defaults/src/assets/scss/pages/main.scss

@@ -1,4 +1,4 @@
-// Main window — page-specific styles. Compiled to dist/assets/css/components/main.bundle.css
+// Main window: page-specific styles. Compiled to dist/assets/css/components/main.bundle.css
 // and loaded only on the main window's HTML page.
 
 // Add your page-only styles below.

package/dist/defaults/src/assets/scss/pages/settings.scss

@@ -1,3 +1,3 @@
-// Settings window — page-specific styles. Compiled to dist/assets/css/components/settings.bundle.css.
+// Settings window: page-specific styles. Compiled to dist/assets/css/components/settings.bundle.css.
 
 // Add your page-only styles below.

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

@@ -1,24 +1,24 @@
 // Context-menu definition. Called by @omega.js/desktop EVERY time the user right-clicks.
 //
 // `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,
+// `menu`:         per-event builder API + id-path API.
+// `params`:       Electron's context-menu params (selectionText, isEditable, linkURL,
 //                 srcURL, mediaType, editFlags, x, y, etc.).
-// `webContents` — the webContents that fired the event.
+// `webContents`:  the webContents that fired the event.
 //
-// This file is OPTIONAL — delete it and @omega.js/desktop still ships a working context menu.
+// This file is OPTIONAL: delete it and @omega.js/desktop still ships a working context menu.
 //
 // @omega.js/desktop ships a default template (built per-event from params) with these ids (flat):
-//   undo, redo                                   — when params.editFlags allow
+//   undo, redo:                                    when params.editFlags allow
 //   cut, copy, paste, paste-and-match-style,
-//   select-all                                   — when params.isEditable
-//   copy                                          — when params.selectionText (read-only)
-//   open-link, copy-link                          — when params.linkURL
-//   reload                                        — always
-//   inspect, toggle-devtools                      — dev mode only
+//   select-all:                                    when params.isEditable
+//   copy:                                           when params.selectionText (read-only)
+//   open-link, copy-link:                           when params.linkURL
+//   reload:                                         always
+//   inspect, toggle-devtools:                       dev mode only
 
 module.exports = ({ omega, menu, params, webContents }) => {
-  // Start from @omega.js/desktop's default template. Don't add anything by default — leave it
+  // 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,10 +1,10 @@
 // Application menu definition. Called by @omega.js/desktop during boot.
 //
 // `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).
+// `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).
 //
-// This file is OPTIONAL — delete it and @omega.js/desktop still ships a working application menu.
+// This file is OPTIONAL: delete it and @omega.js/desktop still ships a working application menu.
 //
 // @omega.js/desktop ships a default menu template with stable id paths. Highlights:
 //   main/about, main/check-for-updates, main/preferences (hidden), main/services,
@@ -20,13 +20,13 @@
 
 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
+  // by default: leave it identical to what the framework would do without
   // this file. Add your own customizations below.
   menu.useDefaults();
 
   // ───────── Examples (uncomment to use) ─────────
   //
-  // // Show the Preferences item (hidden by default — flip its visibility once you
+  // // Show the Preferences item (hidden by default, flip its visibility once you
   // // wire up your settings window):
   // menu.show(process.platform === 'darwin' ? 'main/preferences' : 'file/preferences');
   //

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

@@ -1,7 +1,7 @@
 // Tray definition. Called by @omega.js/desktop during boot.
 //
 // `omega`: the running @omega.js/desktop main-process instance.
-// `tray`    — builder API + id-path API (find/update/remove/insertAfter/etc.).
+// `tray`: builder API + id-path API (find/update/remove/insertAfter/etc.).
 //
 // @omega.js/desktop auto-resolves the tray icon by convention (most specific wins):
 //   1. config/icons/<platform>/tray.png   (platform-specific override)
@@ -10,14 +10,14 @@
 //   4. @omega.js/desktop bundled default
 // And auto-sets the tooltip to config.app.productName.
 //
-// Default items shipped by @omega.js/desktop (flat ids — no `tray/` prefix needed):
-//   title              — disabled label showing the app name
-//   open               — "Open <app>"
-//   check-for-updates  — wired to autoUpdater (label/enabled auto-updated)
-//   website            — opens brand.url in external browser (only if configured)
-//   quit               — quits the app
+// Default items shipped by @omega.js/desktop (flat ids, no `tray/` prefix needed):
+//   title:               disabled label showing the app name
+//   open:                "Open <app>"
+//   check-for-updates:   wired to autoUpdater (label/enabled auto-updated)
+//   website:             opens brand.url in external browser (only if configured)
+//   quit:                quits the app
 //
-// This file is OPTIONAL — delete it and @omega.js/desktop still ships a working tray.
+// This file is OPTIONAL: delete it and @omega.js/desktop still ships a working tray.
 
 module.exports = ({ omega, tray }) => {
   // Use @omega.js/desktop's default template + auto-resolved icon + auto-resolved tooltip.
@@ -51,7 +51,7 @@ module.exports = ({ omega, tray }) => {
   // // Disable without removing (sets enabled:false):
   // tray.enable('quit', false);
   //
-  // // Add a submenu — items inside addressable as 'account/sign-out' etc.
+  // // Add a submenu: items inside addressable as 'account/sign-out' etc.
   // tray.insertBefore('quit', {
   //   id: 'account', label: 'Account', submenu: [
   //     { id: 'sign-out', label: 'Sign out', click: () => {} },

package/dist/defaults/src/main.js

@@ -8,7 +8,7 @@ omega.initialize()
     // ─────────────────────────────────────────────────────────────────────────────
     // 1. Create the main window
     // ─────────────────────────────────────────────────────────────────────────────
-    // Always create `main` — @omega.js/desktop uses its presence in the registry to surface UI when
+    // Always create `main`: @omega.js/desktop uses its presence in the registry to surface UI when
     // the user double-clicks the dock icon (macOS) or relaunches the app (win/linux).
     // In hidden launches (agent / menubar apps with `startup.mode = 'hidden'`, or auto-
     // launch at login), pass `show: false` so the window is registered but invisible:
@@ -43,7 +43,7 @@ omega.initialize()
     //   },
     // });
 
-    // Secondary windows — built-in defaults (800x600, hideOnClose:false) are good
+    // Secondary windows: built-in defaults (800x600, hideOnClose:false) are good
     // enough for most cases. Examples:
     //
     //   windows.create('settings');                                  // baked defaults

package/dist/defaults/src/preload.js

@@ -5,7 +5,7 @@ omega.initialize()
   .then(() => {
     const { logger } = omega;
 
-    // Add any extra contextBridge-exposed APIs here. Be careful — anything you expose runs
+    // 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

@@ -4,7 +4,7 @@ Drop your project test suites here. The framework auto-runs them alongside its o
 
 ## Layers
 
-Match the framework's four layers — OMEGA Desktop's test runner discovers files by the directory they sit in:
+Match the framework's four layers. OMEGA Desktop's test runner discovers files by the directory they sit in:
 
 | Directory | Runtime | Use for |
 |---|---|---|
@@ -17,7 +17,7 @@ A renderer suite that declares `view: '<name>'` runs against that view of YOUR a
 
 ## Coverage
 
-Every feature ships with tests at every layer it has a surface in — logic (`build`/`main`), UI (`renderer`), end-to-end (`boot`). Skip a layer only when the feature genuinely has no surface there; "the logic test covers it" does not excuse the UI test.
+Every feature ships with tests at every layer it has a surface in: logic (`build`/`main`), UI (`renderer`), end-to-end (`boot`). Skip a layer only when the feature genuinely has no surface there; "the logic test covers it" does not excuse the UI test.
 
 ## Quick example
 
@@ -38,4 +38,4 @@ That is the standalone form: one test per file. Every `run` receives `ctx`, whos
 
 ## See also
 
-`node_modules/@omega.js/desktop/docs/test-framework.md` — full reference for the test framework (layers, assert API, fixtures, runner internals).
+`node_modules/@omega.js/manager/docs/desktop/test-framework.md`: full reference for the test framework (layers, assert API, fixtures, runner internals).

package/dist/defaults/test/_init.js

@@ -1,6 +1,6 @@
 /**
  * Test lifecycle hook for this project. Runs once before any suite (not a test itself).
- * See @omega.js/desktop/docs/test-framework.md → "test/_init.js".
+ * See @omega.js/manager/docs/desktop/test-framework.md → "test/_init.js".
  */
 
 module.exports = ({ projectRoot }) => ({

package/dist/gulp/tasks/audit.js

@@ -38,16 +38,13 @@ module.exports = function audit(done) {
 
   // 1. Schema-driven config validation. Single source of truth in @omega.js/config
   // (shared schema + the desktop target refinements).
-  const { errors: schemaErrors } = validateConfig(config, { target: 'desktop' });
+  // build.getConfig() attaches `environment`, a build fact: the config is decorated
+  const { errors: schemaErrors } = validateConfig(config, { target: 'desktop', decorated: true });
   errors.push(...schemaErrors);
 
-  // ...and the validator's WARNINGS, which this task used to drop on the floor
-  // 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 `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`.
+  // ...and the load's WARNINGS (an undeclared key is an ERROR, above). They
+  // come off the LOAD, the resolution `build.getConfig()` runs, which judges
+  // what the brand AUTHORED before the build attaches its own facts.
   const { warnings: configWarnings } = hasOmegaConfig(cwd)
     ? loadConfig(cwd, 'desktop', { environment: build.getEnvironment() })
     : { warnings: [] };

package/dist/lib/restart-manager/index.js

@@ -35,7 +35,7 @@
 //   - config.restartManager.enabled === false
 //   - non-production without OMEGA_RESTART_MANAGER_DEV=1 (dev noise guard)
 //
-// Full reference: docs/restart-manager.md.
+// Full reference: docs/desktop/restart-manager.md.
 
 const path       = require('path');
 const fs         = require('fs');

package/dist/lib/restart-manager/install.js

@@ -19,7 +19,7 @@
 // the same machine from running installers concurrently; RM itself ignores it.
 //
 // Pure helpers (parseFeed, pickArtifact, URL builders) are exported individually
-// for build-layer tests. See docs/restart-manager.md.
+// for build-layer tests. See docs/desktop/restart-manager.md.
 
 const path       = require('path');
 const fs         = require('fs');

package/dist/lib/restart-manager/protocol.js

@@ -29,7 +29,7 @@
 // storage-persisted, so they survive the update relaunch). @omega.js/desktop's lib only ever
 // installs RM when it's missing.
 //
-// Full reference: docs/restart-manager.md.
+// Full reference: docs/desktop/restart-manager.md.
 
 const path = require('path');
 

package/dist/main.js

@@ -113,7 +113,7 @@ class Omega {
   }
 
   /**
-   * Boot the main process in the fixed order (docs/boot-sequence.md), and
+   * Boot the main process in the fixed order (docs/desktop/boot-sequence.md), and
    * settle `ready`.
    * @param {object|string} [consumerConfig] - a RESOLVED config, a project dir to resolve one from, or nothing.
    * @param {object} [options] - boot options (the test harness passes `skipWindowCreation`).
@@ -196,7 +196,8 @@ class Omega {
     // fails loud + early instead of partway through boot with a confusing stack trace.
     {
       const { validateConfig, formatErrors } = require('./vendor/config/index.js');
-      const { errors } = validateConfig(this.config, { target: 'desktop' });
+      // A packaged app's config is baked, build facts included: validate it as decorated
+      const { errors } = validateConfig(this.config, { target: 'desktop', decorated: true });
       if (errors.length > 0) {
         throw new Error(`@omega.js/desktop: config validation failed. Fix the following in config/omega.json5:\n${formatErrors(errors)}`);
       }
@@ -412,7 +413,7 @@ class Omega {
     // when missing (mac zip / win silent NSIS / linux AppImage; RM then self-updates
     // via its own @omega.js/desktop autoUpdater). Skips itself when this app IS restart-manager, in
     // dev (unless OMEGA_RESTART_MANAGER_DEV=1), or when restartManager.enabled=false.
-    // See docs/restart-manager.md.
+    // See docs/desktop/restart-manager.md.
     this.restartManager.initialize(this);
 
     // 13. Initialize the windows lib: registers app-level handlers (window-all-closed, etc.)

package/dist/preload.js

@@ -60,7 +60,7 @@ class Omega {
       environment: process.env[ENVIRONMENT_VAR] || null,
       ipc: {
         invoke: (channel, payload) => ipcRenderer.invoke(channel, payload),
-        // Returns an unsubscribe fn (docs/ipc.md contract, same shape as the
+        // Returns an unsubscribe fn (docs/desktop/ipc.md contract, same shape as the
         // sibling onChange subscriptions below).
         on: (channel, handler) => {
           const wrapped = (_, payload) => handler(payload);

package/dist/test/suites/build/audit.test.js

@@ -103,18 +103,31 @@ module.exports = defineCases({
       },
     },
     {
-      // #911: the task took only `errors` off validateConfig, so a consumer
-      // read `audit ok (0 warnings)` while the validator's list named real
-      // findings (a key the schema does not declare, which is what a typo
-      // looks like). The report is both lists now.
-      name: 'prints the validator\'s warnings and counts them (#911)',
+      // The schema is strict: a key nothing declares is what a typo (or a
+      // legacy shape) looks like, and it fails the build naming the fix.
+      name: 'an undeclared key fails the audit, naming omega migrate',
       run: async (ctx) => {
         const tmp = stageConsumer({ brand: { id: 'testapp', name: 'TestApp' } }, { notAKey: true });
+        try {
+          const err = await runAudit(tmp);
+          ctx.expect(err).toBeDefined();
+          ctx.expect(err.message).toMatch(/config\.notAKey is not a key the schema declares/);
+          ctx.expect(err.message).toMatch(/npx omega migrate/);
+        } finally {
+          fs.rmSync(tmp, { recursive: true, force: true });
+        }
+      },
+    },
+    {
+      // The resolved config carries the company the loader fills and the
+      // environment the build attaches: neither is the brand's key.
+      name: 'a clean config passes with the loader-filled and build-attached keys on it',
+      run: async (ctx) => {
+        const tmp = stageConsumer({ brand: { id: 'testapp', name: 'TestApp' } }, { electronBuilder: { mac: { hardenedRuntime: true } } });
         try {
           const { err, output } = await runAuditCapturing(tmp);
           ctx.expect(err).toBeNull();
-          ctx.expect(output).toMatch(/notAKey/);
-          ctx.expect(output).toMatch(/audit ok \(1 warning\)/);
+          ctx.expect(output).toMatch(/audit ok \(0 warnings\)/);
         } finally {
           fs.rmSync(tmp, { recursive: true, force: true });
         }