@happyvertical/smrt-template-sveltekit 0.53.3 → 0.53.4

package/template/package.json

@@ -9,25 +9,26 @@
     "pnpm": "11.25.0"
   },
   "scripts": {
-    "dev": "node --env-file-if-exists=.env scripts/smrt-vite.mjs dev",
-    "build": "node scripts/smrt-mcp-apps.mjs validate-if-present && node --env-file-if-exists=.env scripts/smrt-vite.mjs build",
-    "preview": "node scripts/smrt-app.mjs start",
+    "dev": "smrt app dev",
+    "build": "smrt app build",
+    "preview": "smrt app start",
     "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
     "check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
-    "db:migrate": "vite build && node scripts/smrt-prepare-migration.mjs",
-    "app:install": "node scripts/smrt-app.mjs install",
-    "app:setup": "node scripts/smrt-app.mjs setup",
-    "app:recover": "node scripts/smrt-app.mjs recover",
-    "app:start": "node scripts/smrt-app.mjs start",
-    "app:doctor": "node scripts/smrt-app.mjs doctor",
-    "app:open": "node scripts/smrt-app.mjs open",
-    "app:stop": "node scripts/smrt-app.mjs stop",
-    "app:backup": "node scripts/smrt-app.mjs backup",
-    "app:export": "node scripts/smrt-app.mjs export",
-    "app:import": "node scripts/smrt-app.mjs import",
+    "typecheck": "svelte-kit sync && tsc --noEmit -p tsconfig.json && svelte-check --tsconfig ./tsconfig.json",
+    "db:migrate": "vite build && smrt app migrate",
+    "app:install": "smrt app install",
+    "app:setup": "smrt app setup",
+    "app:recover": "smrt app recover",
+    "app:start": "smrt app start",
+    "app:doctor": "smrt app doctor",
+    "app:open": "smrt app open",
+    "app:stop": "smrt app stop",
+    "app:backup": "smrt app backup",
+    "app:export": "smrt app export",
+    "app:import": "smrt app import",
     "mcp-apps:validate": "pnpm exec smrt mcp-apps validate --output-dir ./mcp-apps",
-    "worker": "node scripts/smrt-worker.mjs task",
-    "worker:schedule": "node scripts/smrt-worker.mjs schedule"
+    "worker": "smrt app worker task",
+    "worker:schedule": "smrt app worker schedule"
   },
   "devDependencies": {
     "@sveltejs/adapter-node": "^5.5.7",
@@ -38,19 +39,19 @@
     "svelte-check": "^4.7.6",
     "typescript": "6.0.3",
     "vite": "8.3.0",
-    "@happyvertical/smrt-cli": "^0.53.3"
+    "@happyvertical/smrt-cli": "^0.53.4"
   },
   "dependencies": {
-    "@happyvertical/smrt-app-runtime": "^0.53.3",
-    "@happyvertical/smrt-config": "^0.53.3",
-    "@happyvertical/smrt-core": "^0.53.3",
-    "@happyvertical/smrt-jobs": "^0.53.3",
-    "@happyvertical/smrt-profiles": "^0.53.3",
-    "@happyvertical/smrt-svelte": "^0.53.3",
-    "@happyvertical/smrt-tenancy": "^0.53.3",
-    "@happyvertical/smrt-ui": "^0.53.3",
-    "@happyvertical/smrt-users": "^0.53.3",
-    "@happyvertical/smrt-web": "^0.53.3",
+    "@happyvertical/smrt-app-runtime": "^0.53.4",
+    "@happyvertical/smrt-config": "^0.53.4",
+    "@happyvertical/smrt-core": "^0.53.4",
+    "@happyvertical/smrt-jobs": "^0.53.4",
+    "@happyvertical/smrt-profiles": "^0.53.4",
+    "@happyvertical/smrt-svelte": "^0.53.4",
+    "@happyvertical/smrt-tenancy": "^0.53.4",
+    "@happyvertical/smrt-ui": "^0.53.4",
+    "@happyvertical/smrt-users": "^0.53.4",
+    "@happyvertical/smrt-web": "^0.53.4",
     "@happyvertical/sql": "^0.89.12",
     "@modelcontextprotocol/server": "^2.0.0"
   }

package/template/smrt.config.ts

@@ -5,8 +5,10 @@
  * See: https://github.com/happyvertical/smrt
  */
 
-import { resolveLocalRuntimePaths } from '@happyvertical/smrt-app-runtime';
-import { resolveApplicationId } from './scripts/smrt-runtime-identity.mjs';
+import {
+  resolveApplicationId,
+  resolveLocalRuntimePaths,
+} from '@happyvertical/smrt-app-runtime';
 
 const profile = (process.env.SMRT_RUNTIME_PROFILE || 'local') as
   | 'local'
@@ -32,7 +34,18 @@ export default {
     profile,
   },
 
-  // Agent/developer knowledge artifacts are generated by smrtPlugin().
+  // SMRT packages whose object manifests this app consumes. Keeping the list
+  // explicit avoids treating tooling/UI packages as domain model providers
+  // and makes generated runtime registration deterministic.
+  consumer: {
+    packages: [
+      '@happyvertical/smrt-profiles',
+      '@happyvertical/smrt-tenancy',
+      '@happyvertical/smrt-users',
+    ],
+  },
+
+  // Agent/developer knowledge artifacts are generated by the smrt() Vite plugin.
   // HTTP API routes stay off unless explicitly enabled for a dev/admin-only workflow.
   knowledge: {
     enabled: true,
@@ -52,7 +65,7 @@ export default {
       database: {
         type:
           profile === 'local' ? 'sqlite' : 'postgres',
-        // `smrt-app` sets DATABASE_URL to the profile-owned data path before
+        // `smrt app` sets DATABASE_URL to the profile-owned data path before
         // migrations. Deployed profiles require an operator-owned URL.
         url:
           profile === 'local'

package/template/src/app.d.ts

@@ -1,21 +1,14 @@
 // See https://svelte.dev/docs/kit/types#app.d.ts
 // for information about these interfaces
 
-import type { SessionLocals } from '@happyvertical/smrt-users/sveltekit';
+import type { SmrtRuntimeLocals } from '@happyvertical/smrt-app-runtime/sveltekit';
 
 declare global {
   namespace App {
     // interface Error {}
-    interface Locals extends SessionLocals {
-      /**
-       * URL-selected tenant candidate. Never use this as authorization; the
-       * session-authorized tenant remains `tenantId` from SessionLocals.
-       */
-      selectedTenantId: string | null;
-      selectedTenantSlug: string | null;
-      /** Full context for the authorized session tenant, when present. */
-      tenantContext?: import('@happyvertical/smrt-tenancy').MinimalTenantContext;
-    }
+    // Session user, permissions, the authorized `tenantId`/`tenantContext`,
+    // and the URL-selected tenant candidate (never authorization).
+    interface Locals extends SmrtRuntimeLocals {}
     // interface PageData {}
     // interface PageState {}
     // interface Platform {}

package/template/src/hooks.server.ts

@@ -1,56 +1,15 @@
 /**
- * Request foundation, in order:
+ * Request foundation from `@happyvertical/smrt-app-runtime/sveltekit`, in
+ * order: the fail-closed startup gate (`init`), URL tenant selection
+ * (`locals.selectedTenant*`, never authority; tenant headers are ignored), the
+ * signed session (the only source of tenant context and permissions), and
+ * `locals.tenantContext` published only for the verified session tenant.
  *
- * 1. Resolve a URL tenant candidate into `locals.selectedTenant*`. This is
- *    selection only and does not enter AsyncLocalStorage tenant context.
- * 2. Load the signed session. `enterTenantContext: true` establishes the
- *    authorized session tenant and its permission set for downstream code.
- * 3. Publish the authorized context on locals when it matches the session.
- *
- * This ordering prevents a spoofed header or hostname from becoming query
- * authority. Membership-gated tenant switching belongs in an explicit action
- * using `switchSessionTenant()` from `@happyvertical/smrt-users/sveltekit`.
+ * Membership-gated tenant switching belongs in an explicit action using
+ * `switchSessionTenant()` from `@happyvertical/smrt-users/sveltekit`.
+ * Configure the runtime in `$lib/server/smrt`.
  */
 
-import { getCurrentTenant, enableTenancy } from '@happyvertical/smrt-tenancy';
-import { createSessionHandler } from '@happyvertical/smrt-users/sveltekit';
-import type { Handle, ServerInit } from '@sveltejs/kit';
-import { sequence } from '@sveltejs/kit/hooks';
-
-import { getSmrtConfig } from '$lib/server/smrt';
-import { ensureApplicationRuntimeReady } from '$lib/server/application-runtime';
-import { resolveTenant } from '$lib/server/tenancy';
-
-enableTenancy();
-
-export const init: ServerInit = ensureApplicationRuntimeReady;
-
-const tenantSelectionHandle: Handle = async ({ event, resolve }) => {
-  const selection = await resolveTenant(event);
-  event.locals.selectedTenantId = selection.tenantId;
-  event.locals.selectedTenantSlug = selection.tenantSlug;
-  return resolve(event);
-};
-
-const sessionHandle = createSessionHandler({
-  ...getSmrtConfig('Session'),
-  enterTenantContext: true,
-}) as unknown as Handle;
-
-const authorizedTenantLocalsHandle: Handle = async ({ event, resolve }) => {
-  const activeContext = getCurrentTenant();
-  if (
-    event.locals.user &&
-    event.locals.tenantId &&
-    activeContext?.tenantId === event.locals.tenantId
-  ) {
-    event.locals.tenantContext = activeContext;
-  }
-  return resolve(event);
-};
+import { runtime } from '$lib/server/smrt';
 
-export const handle: Handle = sequence(
-  tenantSelectionHandle,
-  sessionHandle,
-  authorizedTenantLocalsHandle,
-);
+export const { handle, init } = runtime;

package/template/src/lib/server/smrt.ts

@@ -1,103 +1,111 @@
 /**
- * Centralized SMRT Configuration
+ * The application's SMRT runtime and collection access.
  *
- * This file provides configuration for all SMRT objects in your project.
- * Import this file in your routes to get properly configured collections.
+ * `runtime` composes the configured profile (local SQLite or deployed
+ * PostgreSQL), storage custody, the owner bootstrap, tenant selection, and the
+ * signed session; `src/hooks.server.ts` mounts its `handle` and `init`.
+ * Generated API routes import `getCollection` from this file.
  */
 
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 
+import {
+  acquireWriterLease,
+  createProviderReadinessProbe,
+  prepareApplicationStateRoot,
+} from '@happyvertical/smrt-app-runtime';
+import { createSmrtSvelteKitRuntime } from '@happyvertical/smrt-app-runtime/sveltekit';
 import {
   ObjectRegistry,
   type SmrtClassOptions,
   type SmrtObject,
 } from '@happyvertical/smrt-core';
 import { loadManifestFromPathSync } from '@happyvertical/smrt-core/manifest';
-import { getRequestScopedDatabase } from '@happyvertical/smrt-users';
-
-import { getApplicationDatabaseConfig } from './application-runtime.js';
 
 // Import all SMRT objects to register them.
 import '../objects/index.js';
 
+/**
+ * Whether `error` reports that the generated register module itself is
+ * absent. Only the missing module named by the error counts (Node's `url`,
+ * or `Cannot find module '<path>'` from Node and Vite's module runner); a
+ * package or file that an existing generated module imports is a different
+ * missing module and is never matched.
+ */
+function isMissingRegisterModule(error: unknown): boolean {
+  const { code, url, message } = (error ?? {}) as {
+    code?: unknown;
+    url?: unknown;
+    message?: unknown;
+  };
+  if (code !== 'ERR_MODULE_NOT_FOUND') return false;
+  const missing =
+    typeof url === 'string'
+      ? url
+      : typeof message === 'string'
+        ? /^Cannot find module '([^']+)'/.exec(message)?.[1]
+        : undefined;
+  if (!missing) return false;
+  const path = missing.replace(/^file:\/\//, '').replace(/[?#].*$/, '');
+  return /\/lib\/server\/smrt-register\.(?:js|ts)$/.test(path);
+}
+
 // Upgrade those registrations to package-qualified identities
 // (`<package>:<Class>`) — required to link each class to its scanned field
-// metadata below. smrtPlugin() generates this module on every dev/build run
-// (it is gitignored, like the generated API routes); guard the import so a
-// fresh checkout that has not run the plugin yet still boots.
+// metadata below. The `smrt()` Vite plugin generates this module on every
+// dev/build run (it is gitignored, like the generated API routes); guard the
+// import so a fresh checkout that has not run the plugin yet still boots.
 try {
-  // @ts-ignore generated by smrtPlugin before a consumer build starts
+  // @ts-ignore generated by the smrt() Vite plugin before a build starts
   await import('./smrt-register.js');
 } catch (error) {
-  // Not generated yet — the first `vite dev` / `vite build` creates it. Do
-  // not hide a real import/runtime error from an existing generated module.
-  const code = (error as NodeJS.ErrnoException).code;
-  const message = error instanceof Error ? error.message : '';
-  if (
-    code !== 'ERR_MODULE_NOT_FOUND' &&
-    !message.includes('smrt-register.js')
-  ) {
-    throw error;
-  }
+  // Not generated yet — the first `pnpm dev` / `pnpm build` creates it. Any
+  // other failure, including a missing dependency of an existing generated
+  // module (an uninstalled extension package), must fail startup.
+  if (!isMissingRegisterModule(error)) throw error;
 }
 
 // Hydrate field metadata for this app's own objects from the local manifest
-// written by smrtPlugin() (`.smrt/manifest.json`). The decorator import above
-// registers the classes, but their scanned field metadata (plain properties
-// like `title: string = ''`) lives in the manifest — without seeding it, the
-// runtime only knows the framework base fields and server-side writes would
-// silently drop your domain columns.
+// (`.smrt/manifest.json`). Without it the runtime only knows the framework
+// base fields and server-side writes would silently drop your domain columns.
 const localManifestPath = join(process.cwd(), '.smrt', 'manifest.json');
 if (existsSync(localManifestPath)) {
   loadManifestFromPathSync(localManifestPath);
 }
 
-/**
- * Per-object configuration overrides
- *
- * Use this to configure specific objects differently from defaults.
- * Example:
- *   AuditLog: { db: { url: process.env.AUDIT_DB_URL!, type: 'postgres' } }
- */
-const objectOverrides: Record<string, Partial<SmrtClassOptions>> = {
-  // Add object-specific overrides here
-};
-
-/**
- * Get default configuration for SMRT objects
- */
-function getDefaultConfig(): SmrtClassOptions {
-  return {
-    db: getApplicationDatabaseConfig(),
-  };
-}
+export const runtime = createSmrtSvelteKitRuntime({
+  // Every local web writer (`pnpm dev`, `pnpm app:start`) holds the same
+  // single-writer lease as `smrt app` operations, so imports and backups
+  // fail closed while the app is running.
+  acquireWriterLease: (context) =>
+    acquireWriterLease(prepareApplicationStateRoot(context), {
+      operationInstance: process.env.SMRT_OPERATION_INSTANCE,
+    }),
+  // Deployed profiles prove authentication, asset, and secret readiness
+  // through the installed modules named by SMRT_*_READINESS_MODULE.
+  providerReadiness: createProviderReadinessProbe,
+  // Per-object overrides, for example:
+  //   AuditLog: { db: { type: 'postgres', url: process.env.AUDIT_DB_URL! } }
+  classOverrides: {},
+});
 
 /**
- * Get configuration for a specific SMRT class
+ * Collection options for a class. Call per request and never keep the result:
+ * under `database-rls` isolation it carries the request's transaction.
  */
 export function getSmrtConfig(className: string): SmrtClassOptions {
-  const defaults = getDefaultConfig();
-  const override = objectOverrides[className];
-  return override ? { ...defaults, ...override } : defaults;
+  return runtime.classOptions(className);
 }
 
 /**
- * Get a collection instance for a SMRT class
+ * Get a collection for a SMRT class, scoped to the current request.
  *
- * Usage in routes:
- *   const products = await getCollection<Product>('Product');
- *   const items = await products.list();
+ *   const items = await getCollection<Item>('Item');
  */
 export async function getCollection<T extends SmrtObject>(className: string) {
-  const config = getSmrtConfig(className);
-  const objectOverride = objectOverrides[className];
-  const requestScopedDb = objectOverride?.db
-    ? undefined
-    : (getRequestScopedDatabase() as SmrtClassOptions['db'] | undefined);
-
-  return await ObjectRegistry.getCollection<T>(className, {
-    ...config,
-    db: requestScopedDb ?? config.db,
-  });
+  return await ObjectRegistry.getCollection<T>(
+    className,
+    runtime.classOptions(className),
+  );
 }

package/template/src/routes/+layout.server.ts

@@ -1,15 +1,7 @@
-import type { LayoutServerLoad } from './$types';
+import { createSessionLayoutLoad } from '@happyvertical/smrt-app-runtime/sveltekit';
 
 /**
- * Keep session and tenant state server-owned. The selected tenant is displayed
- * separately from the tenant authorized by the active session.
+ * Server-owned session summary: whether a user is signed in, the tenant the
+ * session authorizes, and (display only) the URL-selected tenant candidate.
  */
-export const load: LayoutServerLoad = async ({ locals }) => {
-  return {
-    session: {
-      authenticated: Boolean(locals.user),
-      activeTenantId: locals.tenantId,
-      selectedTenantSlug: locals.selectedTenantSlug,
-    },
-  };
-};
+export const load = createSessionLayoutLoad();

package/template/src/routes/+layout.svelte

@@ -1,113 +1,41 @@
 <script lang="ts">
   import { page } from '$app/state';
   import { webMcpToolDefinitions } from '@happyvertical/smrt-virt-web';
-  import { Provider } from '@happyvertical/smrt-svelte';
-  import {
-    AdminShell,
-    AppScopePanel,
-    type ShellNavItem,
-    TenantNav,
-  } from '@happyvertical/smrt-svelte/workspace';
-  import { ThemeProvider } from '@happyvertical/smrt-ui/themes';
-  import '@happyvertical/smrt-ui/themes/styles/fonts.css';
-  import RuntimeDiagnosticsWebMcp from '$lib/RuntimeDiagnosticsWebMcp.svelte';
+  import { AppShell } from '@happyvertical/smrt-svelte/app';
+  import type { ShellNavItem } from '@happyvertical/smrt-svelte/workspace';
   import type { LayoutProps } from './$types';
 
   let { data, children }: LayoutProps = $props();
 
-  const currentHref = $derived(page.url.pathname);
-  const activeTenantLabel = $derived(
-    data.session.activeTenantId ? 'Authorized session tenant' : 'No active tenant',
-  );
+  // Add application routes here. Generated REST routes live under /api and do
+  // not automatically imply a human-facing page.
+  const nav: ShellNavItem[] = [
+    { href: '/', label: 'Items', description: 'The example s-m-r-t object' },
+    { href: '/settings', label: 'Settings', description: 'Workspace layout and shortcuts' },
+  ];
 
-  // Keep the optional data-plane runtime out of browsers that do not expose
-  // WebMCP. SSR remains safe because the feature check is document-guarded.
+  // Generated read-only WebMCP tools, only in browsers that expose WebMCP.
   const webmcp = $derived(
     typeof document !== 'undefined' && 'modelContext' in document
-      ? {
-          definitions: webMcpToolDefinitions,
-          basePath: '/api',
-          effects: ['read'] as const,
-        }
+      ? { definitions: webMcpToolDefinitions, basePath: '/api', effects: ['read'] as const }
       : false,
   );
-
-  // Add application routes here. Generated REST routes live under /api and do
-  // not automatically imply a human-facing page.
-  const nav: ShellNavItem[] = [
-    {
-      href: '/',
-      label: 'Items',
-      description: 'The example s-m-r-t object',
-    },
-    {
-      href: '/settings',
-      label: 'Settings',
-      description: 'Workspace layout and shortcuts',
-    },
-  ];
 </script>
 
-<Provider {webmcp}>
-  <RuntimeDiagnosticsWebMcp enabled={data.session.authenticated} />
-  <ThemeProvider preset="smrt" colorScheme="system" persist={true}>
-    <AdminShell
-      title="s-m-r-t app"
-      subtitle="SvelteKit"
-      storageKey="smrt-app-shell"
-    >
-      {#snippet appPanel()}
-        <AppScopePanel
-          appName="s-m-r-t app"
-          tenantName={activeTenantLabel}
-          environment="local"
-          showSettings={false}
-        >
-          {#snippet docs()}
-            {#if data.session.selectedTenantSlug}
-              <p class="tenant-selection">
-                Selected URL tenant: <strong>{data.session.selectedTenantSlug}</strong>
-              </p>
-            {/if}
-            <a href="/settings">Shell settings</a>
-          {/snippet}
-        </AppScopePanel>
-      {/snippet}
-
-      {#snippet tenantPanel()}
-        <TenantNav items={nav} {currentHref} />
-      {/snippet}
-
-      {@render children()}
-    </AdminShell>
-  </ThemeProvider>
-</Provider>
-
-<style>
-  :global(*),
-  :global(*::before),
-  :global(*::after) {
-    box-sizing: border-box;
-  }
-
-  :global(html),
-  :global(body) {
-    min-height: 100%;
-    margin: 0;
-  }
-
-  :global(body) {
-    background: var(--smrt-color-background);
-    color: var(--smrt-color-on-background);
-    font-family: var(--smrt-typography-body-font-family, Inter, system-ui, sans-serif);
-  }
-
-  .tenant-selection {
-    margin: 0 0 var(--smrt-spacing-2);
-    color: var(--smrt-color-on-surface-variant);
-  }
-
-  a {
-    color: var(--smrt-color-primary);
-  }
-</style>
+<AppShell
+  title="s-m-r-t app"
+  subtitle="SvelteKit"
+  {webmcp}
+  {nav}
+  currentHref={page.url.pathname}
+  runtimeDiagnostics={data.session.authenticated}
+  tenantLabel={data.session.activeTenantId ? 'Authorized session tenant' : 'No active tenant'}
+  settingsHref="/settings"
+>
+  {#snippet appPanelDocs()}
+    {#if data.session.selectedTenantSlug}
+      <p>Selected URL tenant: <strong>{data.session.selectedTenantSlug}</strong></p>
+    {/if}
+  {/snippet}
+  {@render children()}
+</AppShell>

package/template/src/routes/api/_runtime/diagnostics/+server.ts

@@ -1,5 +1,19 @@
-import type { RequestHandler } from './$types';
+import { createRuntimeDiagnosticsHandler } from '@happyvertical/smrt-app-runtime/sveltekit';
+import { RUNTIME_DIAGNOSTICS_WEBMCP_TOOL_NAME } from '@happyvertical/smrt-svelte/app/runtime-diagnostics';
+import { webMcpToolDefinitions } from '@happyvertical/smrt-virt-web';
 
-import { runtimeDiagnosticsGet } from '$lib/server/runtime-diagnostics';
+import { runtime } from '$lib/server/smrt';
 
-export const GET: RequestHandler = runtimeDiagnosticsGet;
+/**
+ * Authenticated, authorized (owner role or `runtime_diagnostics.read`) and
+ * redacted runtime diagnostics. Schema/migration status and the worker
+ * heartbeat stay `unknown` until the application installs real verifiers;
+ * process liveness is never substituted for them.
+ */
+export const GET = createRuntimeDiagnosticsHandler({
+  runtime,
+  toolNames: () => [
+    ...webMcpToolDefinitions.map((definition) => definition.name),
+    RUNTIME_DIAGNOSTICS_WEBMCP_TOOL_NAME,
+  ],
+});

package/template/src/routes/api/_runtime/health/+server.ts

@@ -1,30 +1,6 @@
-import { json } from '@sveltejs/kit';
-import type { RequestHandler } from './$types';
-import { resolveApplicationId } from '../../../../../scripts/smrt-runtime-identity.mjs';
-import {
-  applicationRuntime,
-  applicationRuntimeConfiguration,
-} from '$lib/server/application-runtime';
+import { createRuntimeHealthHandler } from '@happyvertical/smrt-app-runtime/sveltekit';
 
-const applicationId = resolveApplicationId({
-  sourceRoot: process.cwd(),
-  explicitId: process.env.SMRT_APP_ID,
-});
+import { runtime } from '$lib/server/smrt';
 
-export const GET: RequestHandler = async () => {
-  const publicHealth = {
-    schemaVersion: 1,
-    status: 'ready',
-    profile: applicationRuntime.profile,
-  };
-  return json(
-    applicationRuntime.profile === 'local'
-      ? {
-          ...publicHealth,
-          application: applicationId,
-          instance: process.env.SMRT_PROCESS_INSTANCE || null,
-          configuration: applicationRuntimeConfiguration,
-        }
-      : publicHealth,
-  );
-};
+/** Liveness; local responses add the identity `smrt app start` verifies. */
+export const GET = createRuntimeHealthHandler(runtime);

package/template/src/routes/settings/+page.svelte

@@ -1,41 +1,10 @@
 <script lang="ts">
-  import { ShellSettingsPanel } from '@happyvertical/smrt-svelte/workspace';
-
-  // This page renders inside the root layout's <AdminShell>, so the shell
-  // context set by AdminShell is available to descendants — ShellSettingsPanel
-  // reads it via useAdminShell() with no extra wiring. It lets users toggle
-  // panel visibility and remap the WASD hotkeys; changes persist through the
-  // shell's `storageKey` (localStorage), applied client-side after mount.
+  import { ShellSettingsPage } from '@happyvertical/smrt-svelte/app';
 </script>
 
 <svelte:head>
   <title>Settings · s-m-r-t app</title>
 </svelte:head>
 
-<section class="settings">
-  <header>
-    <h1>Settings</h1>
-    <p>Adjust the workspace shell — panel layout and keyboard shortcuts.</p>
-  </header>
-
-  <ShellSettingsPanel />
-</section>
-
-<style>
-  .settings {
-    display: grid;
-    gap: var(--smrt-spacing-6, 1.5rem);
-    max-width: 720px;
-    padding: var(--smrt-spacing-8, 2rem);
-  }
-
-  .settings header {
-    display: grid;
-    gap: var(--smrt-spacing-2, 0.5rem);
-  }
-
-  .settings h1,
-  .settings p {
-    margin: 0;
-  }
-</style>
+<!-- Panel layout and WASD hotkeys, persisted through the shell's storageKey. -->
+<ShellSettingsPage />