sh3-core 0.5.2 → 0.5.5

package/dist/host.js

@@ -22,10 +22,12 @@ import { shellShard } from './shell-shard/shellShard.svelte';
 import { storeShard } from './store/storeShard.svelte';
 import { __setBackend } from './state/zones.svelte';
 import { loadInstalledPackages } from './registry/installer';
-import { initAuth, isAdmin, setLocalOwner } from './auth/index';
+import { setLocalOwner } from './auth/index';
 import { storeApp } from './store/storeApp';
 import { diagnosticShard } from './diagnostic/diagnosticShard.svelte';
 import { diagnosticApp } from './diagnostic/diagnosticApp';
+import { adminShard } from './admin/adminShard.svelte';
+import { adminApp } from './admin/adminApp';
 export { __setBackend };
 export { setLocalOwner };
 export { __setTenantId, __setDocumentBackend } from './documents/config';
@@ -35,43 +37,27 @@ export function registerShard(shard) {
 export { registerApp };
 export async function bootstrap(config) {
     const exShards = new Set(config === null || config === void 0 ? void 0 : config.excludeShards);
-    const exApps = new Set(config === null || config === void 0 ? void 0 : config.excludeApps);
-    // 1. Framework-owned shards — registered first so installed packages
-    //    cannot claim reserved IDs like __shell__ or sh3-store.
-    const frameworkShards = [shellShard, storeShard, diagnosticShard];
+    // 1. Framework-owned shards
+    const frameworkShards = [shellShard, storeShard, diagnosticShard, adminShard];
     for (const shard of frameworkShards) {
         if (!exShards.has(shard.manifest.id)) {
             registerShardInternal(shard);
         }
     }
-    // 2. Framework-shipped admin apps.
-    const frameworkApps = [storeApp, diagnosticApp];
+    // 2. Framework-shipped apps
+    const frameworkApps = [storeApp, diagnosticApp, adminApp];
     for (const app of frameworkApps) {
-        if (!exApps.has(app.manifest.id)) {
-            registerApp(app);
-        }
-    }
-    // 3. Auth — if the host already called setLocalOwner() (Tauri / dev),
-    //    skip server verification. Otherwise verify the stored admin key
-    //    against the server (3s timeout, fails open).
-    if (!isAdmin()) {
-        await initAuth();
+        registerApp(app);
     }
-    // 4. Load any packages that were hot-installed in a previous session
-    //    from IndexedDB. Runs after framework shards but before activation
-    //    so installed packages participate in the self-starting pass.
+    // 3. Load any packages installed in a previous session from IndexedDB
     await loadInstalledPackages();
-    // 5. Activate every self-starting shard (any shard whose `autostart`
-    //    field is defined). Iteration order is insertion order, which
-    //    puts __shell__ first and glob-discovered shards after — exactly
-    //    what we need.
+    // 4. Activate every self-starting shard
     for (const [id, shard] of registeredShards) {
         if (shard.autostart) {
             await activateShard(id);
         }
     }
-    // 6. Read the last-active app from the user zone. If it names a still-
-    //    registered app, launch it; otherwise leave the shell on home.
+    // 5. Read the last-active app from the user zone
     const lastId = readLastApp();
     if (lastId && registeredApps.has(lastId)) {
         await launchApp(lastId);

package/dist/layout/DragPreview.svelte

@@ -49,7 +49,7 @@
     background: var(--shell-grad-bg-elevated, var(--shell-bg-elevated));
     color: var(--shell-fg);
     border: 1px solid var(--shell-accent);
-    border-radius: 3px;
+    border-radius: var(--shell-radius-sm);
     box-shadow: 0 8px 24px rgba(0, 0, 0, 0.5);
     font-size: 12px;
     font-family: var(--shell-font-ui);

package/dist/overlays/ModalFrame.svelte

@@ -76,7 +76,7 @@
     background: var(--shell-grad-bg-elevated, var(--shell-bg-elevated));
     color: var(--shell-fg);
     border: 1px solid var(--shell-border-strong);
-    border-radius: 4px;
+    border-radius: var(--shell-radius);
     min-width: 320px;
     max-width: min(640px, 90vw);
     max-height: 90vh;

package/dist/overlays/PopupFrame.svelte

@@ -76,7 +76,7 @@
     background: var(--shell-grad-bg-elevated, var(--shell-bg-elevated));
     color: var(--shell-fg);
     border: 1px solid var(--shell-border-strong);
-    border-radius: 3px;
+    border-radius: var(--shell-radius-sm);
     box-shadow: 0 8px 24px rgba(0, 0, 0, 0.4);
     min-width: 120px;
     outline: none;

package/dist/overlays/ToastItem.svelte

@@ -48,7 +48,7 @@
     color: var(--shell-fg);
     border: 1px solid var(--shell-border-strong);
     border-left-width: 3px;
-    border-radius: 3px;
+    border-radius: var(--shell-radius-sm);
     box-shadow: 0 8px 20px rgba(0, 0, 0, 0.4);
     font-size: 12px;
     min-width: 220px;

package/dist/primitives/TabbedPanel.svelte

@@ -265,7 +265,7 @@
     font-size: 10px;
     line-height: 1;
     padding: 2px;
-    border-radius: 3px;
+    border-radius: var(--shell-radius-sm);
     color: var(--shell-fg-muted);
     cursor: pointer;
     flex-shrink: 0;

package/dist/registry/installer.js

@@ -97,8 +97,6 @@ export async function installPackage(bundle, meta) {
             registerApp(app);
     }
     catch (err) {
-        // Registration failure (e.g. duplicate id) -- the package is persisted
-        // but not usable until reload. Log and continue.
         console.warn(`[sh3] Package "${meta.id}" installed but registration failed (will retry on next boot):`, err instanceof Error ? err.message : err);
         hotLoaded = false;
     }

package/dist/shards/activate.svelte.d.ts

@@ -1,4 +1,4 @@
-import type { Shard } from './types';
+import type { Shard, ShardContext } from './types';
 /**
  * Reactive registry of every shard known to the host. Keys are shard ids.
  * Populated once at boot by the glob-discovery loop in main.ts (through
@@ -10,12 +10,14 @@ import type { Shard } from './types';
 export declare const registeredShards: Map<string, Shard>;
 export declare const activeShards: Map<string, Shard>;
 /**
- * Register a shard with the framework so it can later be activated. Records
- * the shard in `registeredShards` but does not run `activate` — that happens
- * at app launch (or immediately for self-starting shards).
+ * Register (or re-register) a shard with the framework so it can later be
+ * activated. Records the shard in `registeredShards` but does not run
+ * `activate` — that happens at app launch (or for self-starting shards).
  *
- * @param shard - The shard module to register. `shard.manifest.id` must be unique.
- * @throws If a shard with the same id is already registered.
+ * If a shard with the same id already exists it is silently replaced,
+ * which is the expected path during package updates. If the old shard was
+ * active it is deactivated first so the new version can be cleanly
+ * activated on next launch.
  */
 export declare function registerShard(shard: Shard): void;
 /**
@@ -43,3 +45,8 @@ export declare function deactivateShard(id: string): void;
  * @param id - The `ShardManifest.id` to check.
  */
 export declare function isActive(id: string): boolean;
+/**
+ * Return the ShardContext for an active shard, or undefined if not active.
+ * Used by lifecycle.ts to pass context to `shard.resume()`.
+ */
+export declare function getShardContext(id: string): ShardContext | undefined;

package/dist/shards/activate.svelte.js

@@ -39,17 +39,19 @@ export const registeredShards = $state(new Map());
 const active = new Map();
 export const activeShards = $state(new Map());
 /**
- * Register a shard with the framework so it can later be activated. Records
- * the shard in `registeredShards` but does not run `activate` — that happens
- * at app launch (or immediately for self-starting shards).
+ * Register (or re-register) a shard with the framework so it can later be
+ * activated. Records the shard in `registeredShards` but does not run
+ * `activate` — that happens at app launch (or for self-starting shards).
  *
- * @param shard - The shard module to register. `shard.manifest.id` must be unique.
- * @throws If a shard with the same id is already registered.
+ * If a shard with the same id already exists it is silently replaced,
+ * which is the expected path during package updates. If the old shard was
+ * active it is deactivated first so the new version can be cleanly
+ * activated on next launch.
  */
 export function registerShard(shard) {
     const id = shard.manifest.id;
-    if (registeredShards.has(id)) {
-        throw new Error(`Shard "${id}" is already registered`);
+    if (registeredShards.has(id) && activeShards.has(id)) {
+        deactivateShard(id);
     }
     registeredShards.set(id, shard);
 }
@@ -73,7 +75,7 @@ export async function activateShard(id) {
         // and is now being required by an app). Idempotent — no error.
         return;
     }
-    const entry = { shard, viewIds: new Set(), cleanupFns: [] };
+    const entry = { shard, ctx: undefined, viewIds: new Set(), cleanupFns: [] };
     // envState holds the reactive env data for this shard.
     // Must be declared with $state at variable declaration time (Svelte 5 rule).
     const envState = $state({
@@ -122,6 +124,7 @@ export async function activateShard(id) {
             ? createZoneManager()
             : undefined,
     };
+    entry.ctx = ctx;
     active.set(id, entry);
     activeShards.set(id, shard);
     await shard.activate(ctx);
@@ -173,3 +176,11 @@ export function deactivateShard(id) {
 export function isActive(id) {
     return active.has(id);
 }
+/**
+ * Return the ShardContext for an active shard, or undefined if not active.
+ * Used by lifecycle.ts to pass context to `shard.resume()`.
+ */
+export function getShardContext(id) {
+    var _a;
+    return (_a = active.get(id)) === null || _a === void 0 ? void 0 : _a.ctx;
+}

package/dist/shards/types.d.ts

@@ -193,4 +193,15 @@ export interface Shard {
     autostart?(ctx: ShardContext): void | Promise<void>;
     /** Optional cleanup hook called when the shard is deactivated. Release timers, subscriptions, and external resources here. */
     deactivate?(): void | Promise<void>;
+    /**
+     * Called when the owning app is suspended (Home button). The shard
+     * remains active; its views and state are preserved. Return `false`
+     * (sync or async) to cancel the navigation.
+     */
+    suspend?(): void | false | Promise<void | false>;
+    /**
+     * Called when the owning app resumes from Home. Receives the same
+     * `ShardContext` that `activate` received.
+     */
+    resume?(ctx: ShardContext): void | Promise<void>;
 }

package/dist/shell-shard/ShellHome.svelte

@@ -2,37 +2,18 @@
   /*
    * Shell home — the view shown when no app is active. Sections:
    *   1. User apps — always visible
-   *   2. Admin apps — visible when elevated (admin mode)
-   *   3. Elevate prompt — shown when not elevated
+   *   2. Admin apps — visible when user has admin role
    */
 
   import { listRegisteredApps, launchApp, isAdmin, VERSION } from '../api';
-  import { elevate, deescalate } from '../auth/index';
+  import { logout, isAuthenticated, getUser } from '../auth/index';
 
   const apps = $derived(listRegisteredApps());
   const userApps = $derived(apps.filter(m => !m.admin));
   const adminApps = $derived(apps.filter(m => m.admin));
   const elevated = $derived(isAdmin());
-
-  let keyInput = $state('');
-  let elevateError = $state<string | null>(null);
-  let elevating = $state(false);
-
-  async function handleElevate() {
-    if (!keyInput.trim() || elevating) return;
-    elevating = true;
-    elevateError = null;
-    const ok = await elevate(keyInput.trim());
-    if (!ok) {
-      elevateError = 'Invalid API key';
-    }
-    keyInput = '';
-    elevating = false;
-  }
-
-  function handleDeescalate() {
-    deescalate();
-  }
+  const authenticated = $derived(isAuthenticated());
+  const user = $derived(getUser());
 </script>
 
 <div class="shell-home">
@@ -40,9 +21,10 @@
     <h1>SH3</h1>
     <span class="shell-home-version">v{VERSION}</span>
     <span class="shell-home-alpha">alpha</span>
-    {#if elevated}
-      <button type="button" class="shell-home-deescalate" onclick={handleDeescalate}>
-        Exit admin mode
+    {#if authenticated && user}
+      <span class="shell-home-user">{user.displayName}</span>
+      <button type="button" class="shell-home-deescalate" onclick={() => logout()}>
+        Sign out
       </button>
     {/if}
   </header>
@@ -70,54 +52,26 @@
     </section>
   {/if}
 
-  {#if elevated}
-    {#if adminApps.length > 0}
-      <section class="shell-home-section">
-        <h2 class="shell-home-section-title">Admin</h2>
-        <ul class="shell-home-list">
-          {#each adminApps as manifest (manifest.id)}
-            <li class="shell-home-entry">
-              <div class="shell-home-entry-label">{manifest.label}</div>
-              <div class="shell-home-entry-meta">
-                {manifest.id} · v{manifest.version}
-              </div>
-              <button
-                type="button"
-                class="shell-home-launch"
-                onclick={() => launchApp(manifest.id)}
-              >
-                Launch
-              </button>
-            </li>
-          {/each}
-        </ul>
-      </section>
-    {/if}
-  {:else}
+  {#if elevated && adminApps.length > 0}
     <section class="shell-home-section">
-      <h2 class="shell-home-section-title">Admin Mode</h2>
-      <p class="shell-home-elevate-hint">
-        Elevate Permissions
-      </p>
-      <form class="shell-home-elevate-form" onsubmit={(e) => { e.preventDefault(); handleElevate(); }}>
-        <input
-          class="shell-home-key-input"
-          type="password"
-          placeholder="API key"
-          bind:value={keyInput}
-          disabled={elevating}
-        />
-        <button
-          type="submit"
-          class="shell-home-elevate-btn"
-          disabled={elevating || !keyInput.trim()}
-        >
-          {elevating ? 'Verifying...' : 'Elevate'}
-        </button>
-      </form>
-      {#if elevateError}
-        <div class="shell-home-elevate-error">{elevateError}</div>
-      {/if}
+      <h2 class="shell-home-section-title">Admin</h2>
+      <ul class="shell-home-list">
+        {#each adminApps as manifest (manifest.id)}
+          <li class="shell-home-entry">
+            <div class="shell-home-entry-label">{manifest.label}</div>
+            <div class="shell-home-entry-meta">
+              {manifest.id} · v{manifest.version}
+            </div>
+            <button
+              type="button"
+              class="shell-home-launch"
+              onclick={() => launchApp(manifest.id)}
+            >
+              Launch
+            </button>
+          </li>
+        {/each}
+      </ul>
     </section>
   {/if}
 
@@ -203,7 +157,7 @@
     padding: 14px 18px;
     background: var(--shell-grad-bg-elevated, var(--shell-bg-elevated));
     border: 1px solid var(--shell-border);
-    border-radius: 6px;
+    border-radius: var(--shell-radius-md);
   }
   .shell-home-entry-label {
     grid-column: 1;
@@ -223,7 +177,7 @@
     background: var(--shell-accent);
     color: var(--shell-bg);
     border: none;
-    border-radius: 4px;
+    border-radius: var(--shell-radius);
     font-weight: 600;
     cursor: pointer;
   }
@@ -235,7 +189,7 @@
     background: transparent;
     color: var(--shell-fg-subtle);
     border: 1px solid var(--shell-border);
-    border-radius: 4px;
+    border-radius: var(--shell-radius);
     cursor: pointer;
     font-size: 12px;
   }
@@ -243,48 +197,8 @@
     color: var(--shell-fg);
     border-color: var(--shell-fg-subtle);
   }
-  .shell-home-elevate-hint {
-    margin: 0 0 12px;
+  .shell-home-user {
     font-size: 13px;
-    color: var(--shell-fg-muted);
-  }
-  .shell-home-elevate-form {
-    display: flex;
-    gap: 8px;
-  }
-  .shell-home-key-input {
-    flex: 1;
-    padding: 8px 12px;
-    background: var(--shell-grad-bg-elevated, var(--shell-bg-elevated));
-    color: var(--shell-fg);
-    border: 1px solid var(--shell-border);
-    border-radius: 4px;
-    font-family: monospace;
-    font-size: 13px;
-  }
-  .shell-home-key-input::placeholder {
-    color: var(--shell-fg-muted);
-  }
-  .shell-home-elevate-btn {
-    padding: 8px 16px;
-    background: var(--shell-accent);
-    color: var(--shell-bg);
-    border: none;
-    border-radius: 4px;
-    font-weight: 600;
-    cursor: pointer;
-    white-space: nowrap;
-  }
-  .shell-home-elevate-btn:disabled {
-    opacity: 0.6;
-    cursor: not-allowed;
-  }
-  .shell-home-elevate-error {
-    margin-top: 8px;
-    padding: 6px 10px;
-    font-size: 12px;
-    color: var(--shell-error, #d32f2f);
-    background: color-mix(in srgb, var(--shell-error, #d32f2f) 10%, transparent);
-    border-radius: 4px;
+    color: var(--shell-fg-subtle);
   }
 </style>

package/dist/store/InstalledView.svelte

@@ -125,7 +125,7 @@
 
 <style>
   .installed-view {
-    font-family: var(--shell-font, system-ui, sans-serif);
+    font-family: var(--shell-font-ui);
     color: var(--shell-fg, #e0e0e0);
     background: var(--shell-bg, #1e1e1e);
     padding: 16px;
@@ -149,7 +149,7 @@
     background: var(--shell-accent, #007acc);
     color: #fff;
     border: none;
-    border-radius: 4px;
+    border-radius: var(--shell-radius);
     cursor: pointer;
     font-family: inherit;
     font-size: 0.875rem;
@@ -171,7 +171,7 @@
   .installed-item {
     background: var(--shell-input-bg, #2a2a2a);
     border: 1px solid var(--shell-border, #444);
-    border-radius: 6px;
+    border-radius: var(--shell-radius-md);
     padding: 12px 14px;
     display: flex;
     flex-direction: column;
@@ -189,7 +189,7 @@
   .installed-item-badge {
     font-size: 0.6875rem;
     padding: 1px 6px;
-    border-radius: 3px;
+    border-radius: var(--shell-radius-sm);
     text-transform: uppercase;
     font-weight: 600;
     letter-spacing: 0.04em;
@@ -223,7 +223,7 @@
     background: transparent;
     color: var(--shell-error, #d32f2f);
     border: 1px solid var(--shell-error, #d32f2f);
-    border-radius: 4px;
+    border-radius: var(--shell-radius);
     cursor: pointer;
     font-family: inherit;
     font-size: 0.8125rem;
@@ -240,7 +240,7 @@
     background: var(--shell-warning, #ff9800);
     color: #fff;
     border: none;
-    border-radius: 4px;
+    border-radius: var(--shell-radius);
     cursor: pointer;
     font-family: inherit;
     font-size: 0.8125rem;
@@ -258,7 +258,7 @@
     background: color-mix(in srgb, var(--shell-error, #d32f2f) 15%, transparent);
     color: var(--shell-error, #d32f2f);
     border: 1px solid var(--shell-error, #d32f2f);
-    border-radius: 4px;
+    border-radius: var(--shell-radius);
     font-size: 0.8125rem;
   }
 </style>

package/dist/store/StoreView.svelte

@@ -273,7 +273,7 @@
 
 <style>
   .store-view {
-    font-family: var(--shell-font, system-ui, sans-serif);
+    font-family: var(--shell-font-ui);
     color: var(--shell-fg, #e0e0e0);
     background: var(--shell-bg, #1e1e1e);
     padding: 16px;
@@ -301,7 +301,7 @@
     background: var(--shell-input-bg, #2a2a2a);
     color: var(--shell-fg, #e0e0e0);
     border: 1px solid var(--shell-border, #444);
-    border-radius: 4px;
+    border-radius: var(--shell-radius);
     font-family: inherit;
     font-size: 0.875rem;
   }
@@ -313,7 +313,7 @@
     background: var(--shell-input-bg, #2a2a2a);
     color: var(--shell-fg, #e0e0e0);
     border: 1px solid var(--shell-border, #444);
-    border-radius: 4px;
+    border-radius: var(--shell-radius);
     font-family: inherit;
     font-size: 0.875rem;
   }
@@ -322,7 +322,7 @@
     background: var(--shell-accent, #007acc);
     color: #fff;
     border: none;
-    border-radius: 4px;
+    border-radius: var(--shell-radius);
     cursor: pointer;
     font-family: inherit;
     font-size: 0.875rem;
@@ -337,7 +337,7 @@
     background: color-mix(in srgb, var(--shell-error, #d32f2f) 15%, transparent);
     color: var(--shell-error, #d32f2f);
     border: 1px solid var(--shell-error, #d32f2f);
-    border-radius: 4px;
+    border-radius: var(--shell-radius);
     font-size: 0.8125rem;
   }
   .store-grid {
@@ -348,7 +348,7 @@
   .store-card {
     background: var(--shell-input-bg, #2a2a2a);
     border: 1px solid var(--shell-border, #444);
-    border-radius: 6px;
+    border-radius: var(--shell-radius-md);
     padding: 14px;
     display: flex;
     flex-direction: column;
@@ -373,7 +373,7 @@
   .store-icon-img {
     width: 36px;
     height: 36px;
-    border-radius: 4px;
+    border-radius: var(--shell-radius);
     object-fit: cover;
   }
   .store-icon-placeholder {
@@ -384,7 +384,7 @@
     justify-content: center;
     background: var(--shell-accent, #007acc);
     color: #fff;
-    border-radius: 4px;
+    border-radius: var(--shell-radius);
     font-weight: 700;
     font-size: 1rem;
   }
@@ -401,7 +401,7 @@
   .store-card-badge {
     font-size: 0.6875rem;
     padding: 1px 6px;
-    border-radius: 3px;
+    border-radius: var(--shell-radius-sm);
     text-transform: uppercase;
     font-weight: 600;
     letter-spacing: 0.04em;
@@ -433,7 +433,7 @@
     color: var(--shell-warning, #ff9800);
     padding: 4px 8px;
     background: color-mix(in srgb, var(--shell-warning, #ff9800) 10%, transparent);
-    border-radius: 3px;
+    border-radius: var(--shell-radius-sm);
   }
   .store-card-actions {
     margin-top: auto;
@@ -445,7 +445,7 @@
     background: var(--shell-accent, #007acc);
     color: #fff;
     border: none;
-    border-radius: 4px;
+    border-radius: var(--shell-radius);
     cursor: pointer;
     font-family: inherit;
     font-size: 0.8125rem;
@@ -464,7 +464,7 @@
     background: var(--shell-warning, #ff9800);
     color: #fff;
     border: none;
-    border-radius: 4px;
+    border-radius: var(--shell-radius);
     cursor: pointer;
     font-family: inherit;
     font-size: 0.8125rem;
@@ -495,7 +495,7 @@
     padding: 4px 8px;
     background: var(--shell-input-bg, #2a2a2a);
     border: 1px solid var(--shell-border, #444);
-    border-radius: 4px;
+    border-radius: var(--shell-radius);
     font-size: 0.8125rem;
   }
   .store-registry-url {
@@ -509,7 +509,7 @@
     background: transparent;
     color: var(--shell-error, #d32f2f);
     border: 1px solid var(--shell-error, #d32f2f);
-    border-radius: 3px;
+    border-radius: var(--shell-radius-sm);
     cursor: pointer;
     font-size: 0.75rem;
     flex-shrink: 0;
@@ -526,7 +526,7 @@
     background: var(--shell-input-bg, #2a2a2a);
     color: var(--shell-fg, #e0e0e0);
     border: 1px solid var(--shell-border, #444);
-    border-radius: 4px;
+    border-radius: var(--shell-radius);
     font-family: inherit;
     font-size: 0.8125rem;
   }
@@ -538,7 +538,7 @@
     background: var(--shell-accent, #007acc);
     color: #fff;
     border: none;
-    border-radius: 4px;
+    border-radius: var(--shell-radius);
     cursor: pointer;
     font-family: inherit;
     font-size: 0.8125rem;

package/dist/store/storeApp.js

@@ -10,7 +10,7 @@ export const storeApp = {
     manifest: {
         id: 'sh3-store-app',
         label: 'Package Store',
-        version: '0.2.0',
+        version: '0.2.1',
         requiredShards: ['sh3-store'],
         layoutVersion: 1,
         admin: true,

package/dist/store/storeShard.svelte.js

@@ -48,7 +48,7 @@ export const storeShard = {
     manifest: {
         id: 'sh3-store',
         label: 'Package Store',
-        version: '0.2.0',
+        version: '0.2.1',
         views: [
             { id: 'sh3-store:browse', label: 'Store' },
             { id: 'sh3-store:installed', label: 'Installed' },
@@ -208,10 +208,11 @@ export const storeShard = {
         };
         ctx.registerView('sh3-store:browse', browseFactory);
         ctx.registerView('sh3-store:installed', installedFactory);
+        // refreshInstalled can run immediately (hits server, no env needed).
+        refreshInstalled();
     },
     autostart() {
-        // Intentionally empty. Defining autostart puts the store shard on
-        // the self-starting path at boot so its views are available from
-        // the launcher without requiring an app to declare it.
+        // Runs after env hydration, so registries are populated.
+        storeContext.refreshCatalog();
     },
 };