@jskit-ai/agent-docs 0.1.150 → 0.1.151

package/guide/agent/framework/material-3.md

@@ -49,8 +49,9 @@ Do not replace a shared screen to restyle it. Use its public seams.
 - Use Vuetify spacing utilities and established JSKIT dimensions before raw
   values. Preserve JSKIT shell widths, target sizes, and spacing props.
 - Use elevation `0` through `5`, shape props, and component variants instead of
-  arbitrary shadows and radii. Prefer a page header and direct `v-sheet` work
-  region; add cards or dialogs only for genuinely grouped or elevated objects.
+  arbitrary shadows and radii. Never add page headers or standalone headings
+  unless explicitly requested. Use a direct `v-sheet` work region when needed;
+  reserve cards and dialogs for genuinely grouped or elevated objects.
 
 ## Components, state, and feedback
 

package/guide/agent/framework/ui-operations.md

@@ -34,7 +34,8 @@ hash, pattern receipt, or tool-owned source declaration.
 
 - Keep screens phone/task-first with drawer-independent primary actions and
   at least 48 CSS-pixel targets.
-- Use a page header and direct surfaces instead of needless nested cards.
+- Never add page headers or standalone headings unless the user explicitly asks.
+- Use direct surfaces instead of needless nested cards.
 - Render all meaningful loading, empty, error, permission, and retry states.
 - Use structure-matching Material skeletons for visible loading; never use a
   generic spinner or circular progress indicator.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/agent-docs",
-  "version": "0.1.150",
+  "version": "0.1.151",
   "description": "Distributed JSKIT agent references, prompts, guides, and generated reference maps.",
   "type": "module",
   "files": [

package/patterns/feature-package/example/booking-engine/package.json

@@ -5,7 +5,7 @@
   "private": true,
   "type": "module",
   "dependencies": {
-    "@jskit-ai/kernel": "0.1.178",
+    "@jskit-ai/kernel": "0.1.179",
     "json-rest-schema": "^1.0.17"
   },
   "exports": {

package/patterns/minimal-foundation/PATTERN.md

@@ -38,6 +38,8 @@ questionnaire or infer tenancy, authentication, or database requirements.
 ## Invariants
 
 - Preserve `.git` and all unrelated project and agent context.
+- Pages start with useful content and actions, never a default page header or
+  standalone heading.
 - Refuse or resolve real destination-file collisions before copying.
 - Keep `packages/main` limited to app composition and lightweight glue.
 - Declare `packages/*` as an npm workspace and depend on app-local packages by

package/patterns/minimal-foundation/example/AGENTS.md

@@ -12,6 +12,10 @@ Before implementation, read the narrow relevant source pattern completely. If
 its owner package is installed, prefer that version-matched package-owned copy.
 Do not install an unrelated runtime package only to read documentation.
 
+Pages never start with a page header, title block, welcome heading, or other
+standalone heading copy. Start with the useful content and actions. If the user
+wants a heading, they will ask for or add one.
+
 Copied pattern source is ordinary application source. Do not add generator
 provenance, receipts, completion ledgers, or tooling-operation history. Keep
 changes scoped to the user request and verify runtime behavior directly.

package/patterns/minimal-foundation/example/Procfile

@@ -1,2 +1 @@
-release: npm run db:migrate
 web: npm run start

package/patterns/minimal-foundation/example/package.json

@@ -34,7 +34,7 @@
   "dependencies": {
     "@local/main": "0.1.0",
     "@fastify/static": "^10.1.3",
-    "@jskit-ai/kernel": "0.1.178",
+    "@jskit-ai/kernel": "0.1.179",
     "@tanstack/vue-query": "^5.101.0",
     "fastify": "^5.8.5",
     "json-rest-schema": "^1.0.17",
@@ -42,11 +42,11 @@
     "vue": "^3.5.38",
     "vue-router": "^5.1.0",
     "vuetify": "^4.1.2",
-    "@jskit-ai/http-runtime": "0.1.176"
+    "@jskit-ai/http-runtime": "0.1.177"
   },
   "devDependencies": {
-    "@jskit-ai/config-eslint": "0.1.175",
-    "@jskit-ai/jskit-catalog": "0.1.203",
+    "@jskit-ai/config-eslint": "0.1.176",
+    "@jskit-ai/jskit-catalog": "0.1.204",
     "@playwright/test": "1.61.1",
     "@vitejs/plugin-vue": "^6.0.7",
     "eslint": "^10.8.0",

package/patterns/minimal-foundation/example/src/pages/home/index.vue

@@ -1,15 +1,6 @@
 <template>
   <section class="home-start-screen d-flex flex-column ga-4">
-    <header>
-      <p class="text-overline text-medium-emphasis mb-1">Home</p>
-      <h1 class="home-start-screen__title">Home base</h1>
-      <p class="text-body-2 text-medium-emphasis mb-0">
-        The app runtime is online and ready for the first real workflow.
-      </p>
-    </header>
-
     <v-sheet rounded="lg" border class="home-start-screen__panel">
-      <h2 class="text-h6 mb-2">No activity yet</h2>
       <p class="text-body-2 text-medium-emphasis mb-0">
         Recent work, saved records, and next actions will appear here once this app has data.
       </p>
@@ -19,30 +10,12 @@
 
 <style scoped>
 .home-start-screen {
-  --home-start-title-size: 2rem;
   --home-start-panel-padding: 1rem;
-}
-
-.home-start-screen {
   margin-inline: auto;
   max-width: 48rem;
 }
 
-.home-start-screen__title {
-  font-size: var(--home-start-title-size);
-  font-weight: 700;
-  letter-spacing: 0;
-  line-height: 1.08;
-  margin: 0 0 0.45rem;
-}
-
 .home-start-screen__panel {
   padding: var(--home-start-panel-padding);
 }
-
-@media (max-width: 640px) {
-  .home-start-screen {
-    --home-start-title-size: 1.5rem;
-  }
-}
 </style>

package/patterns/minimal-foundation/example/tests/e2e/base-shell.spec.ts

@@ -11,7 +11,7 @@ test.describe("application responsive smoke", () => {
     test(`${viewport.name} home route renders without horizontal overflow`, async ({ page }) => {
       await page.setViewportSize(viewport);
       await page.goto("/home");
-      await expect(page.getByRole("heading", { name: "Home base" })).toBeVisible();
+      await expect(page.getByText("Recent work, saved records, and next actions will appear here once this app has data.")).toBeVisible();
 
       const dimensions = await page.evaluate(() => ({
         clientWidth: document.documentElement.clientWidth,

package/patterns/page-scaffolding.md

@@ -29,7 +29,8 @@ Rules:
   ownership rather than creating a parallel navigation structure.
 - For a small placeholder route inside an existing route family, keep the change scoped unless the durable route or surface plan in the app blueprint changed.
 - Live pages must be usable screens, not instructional scaffolds. Do not ship copy such as "replace this", "use this area", or "this page is ready".
-- Prefer a page header plus a direct `v-sheet` working region. Do not wrap every page in a generic `v-card`.
+- Never add a page header, title block, welcome heading, or standalone heading copy by default. Start with the useful content and actions; add a heading only when the user explicitly asks for one.
+- Prefer a direct `v-sheet` working region when the content needs a surface. Do not wrap every page in a generic `v-card`.
 - If the screen is not implemented yet, use a product-shaped empty state with one clear next action or status, not developer instructions.
 - Primary navigation links belong in semantic placements such as `shell.primary-nav` or `page.section-nav`; do not place every route into one drawer by default.
 - Compact layouts must be checked first: no horizontal overflow, no unreachable primary action, and tap targets should be at least 48 px.
@@ -38,7 +39,7 @@ UI contract:
 
 - App-facing screens are phone-first and task-first; admin/console screens may be denser but still need responsive controls.
 - Navigation uses semantic placements by default. Raw `host:position` outlets are advanced infrastructure.
-- Page architecture is header plus direct work region, normally `v-sheet`; do not use generic page-level `v-card` shells.
+- Page architecture starts with the direct work region and actions, normally using `v-sheet` when a surface is needed; it does not include default page-heading chrome or generic page-level `v-card` shells.
 - Empty/loading/error states are product-shaped and resource-named.
 - Detail and workflow routes are not primary navigation by default.
 - Changed UI must have compact, medium, and expanded browser checks when it changes user-facing behavior.
@@ -46,6 +47,7 @@ UI contract:
 Avoid:
 
 - inventing a page and placement shape without checking the existing pattern and neighboring routes
+- adding a route-name heading, welcome heading, or other page title the user did not request
 - treating a small page stub as permission to rewrite marketing copy, route architecture, or app blueprint scope
-- adding cards inside cards or repeating the page title inside a card title
+- adding cards inside cards
 - treating Vuetify component defaults as the product architecture

package/patterns/shell-foundation/PATTERN.md

@@ -37,6 +37,8 @@ not convert those choices into a generator questionnaire.
 
 - Materialize source inside the existing project without disturbing `.git` or
   any existing project/agent context.
+- Pages start with useful content and actions, never a default page header or
+  standalone heading.
 - Inspect and resolve file collisions; never force-overwrite product source.
 - Keep placements and topology explicit and use shell public components.
 - Keep one app-owned `npm run develop` entry that runs the API on loopback and

package/patterns/shell-foundation/example/AGENTS.md

@@ -12,6 +12,10 @@ Before implementation, read the narrow relevant source pattern completely. If
 its owner package is installed, prefer that version-matched package-owned copy.
 Do not install an unrelated runtime package only to read documentation.
 
+Pages never start with a page header, title block, welcome heading, or other
+standalone heading copy. Start with the useful content and actions. If the user
+wants a heading, they will ask for or add one.
+
 Copied pattern source is ordinary application source. Do not add generator
 provenance, receipts, completion ledgers, or tooling-operation history. Keep
 changes scoped to the user request and verify runtime behavior directly.

package/patterns/shell-foundation/example/Procfile

@@ -1,2 +1 @@
-release: npm run db:migrate
 web: npm run start

package/patterns/shell-foundation/example/package.json

@@ -34,7 +34,7 @@
   "dependencies": {
     "@local/main": "0.1.0",
     "@fastify/static": "^10.1.3",
-    "@jskit-ai/kernel": "0.1.178",
+    "@jskit-ai/kernel": "0.1.179",
     "@tanstack/vue-query": "^5.101.0",
     "fastify": "^5.8.5",
     "json-rest-schema": "^1.0.17",
@@ -42,13 +42,13 @@
     "vue": "^3.5.38",
     "vue-router": "^5.1.0",
     "vuetify": "^4.1.2",
-    "@jskit-ai/http-runtime": "0.1.176",
+    "@jskit-ai/http-runtime": "0.1.177",
     "@mdi/js": "^7.4.47",
-    "@jskit-ai/shell-web": "0.1.182"
+    "@jskit-ai/shell-web": "0.1.183"
   },
   "devDependencies": {
-    "@jskit-ai/config-eslint": "0.1.175",
-    "@jskit-ai/jskit-catalog": "0.1.203",
+    "@jskit-ai/config-eslint": "0.1.176",
+    "@jskit-ai/jskit-catalog": "0.1.204",
     "@playwright/test": "1.61.1",
     "@vitejs/plugin-vue": "^6.0.7",
     "eslint": "^10.8.0",

package/patterns/shell-foundation/example/packages/main/package.json

@@ -9,7 +9,7 @@
   },
   "description": "App-local runtime composition and lightweight glue.",
   "dependencies": {
-    "@jskit-ai/kernel": "0.1.178"
+    "@jskit-ai/kernel": "0.1.179"
   },
   "jskit": {
     "kind": "runtime",

package/patterns/shell-foundation/example/src/pages/home/index.vue

@@ -29,16 +29,9 @@ const healthPending = computed(
 
 <template>
   <section class="home-surface-screen d-flex flex-column ga-4">
-    <header class="home-surface-screen__header">
-      <div>
-        <p class="text-overline text-medium-emphasis mb-1">Home</p>
-        <h1 class="home-surface-screen__title">Ready</h1>
-        <p class="text-body-2 text-medium-emphasis mb-0">
-          Core services are available.
-        </p>
-      </div>
+    <div class="home-surface-screen__actions">
       <v-btn color="primary" variant="flat" to="/home/settings/general">Settings</v-btn>
-    </header>
+    </div>
 
     <v-sheet rounded="lg" border class="home-surface-screen__panel">
       <div class="home-surface-screen__status">
@@ -62,23 +55,12 @@ const healthPending = computed(
 
 <style scoped>
 .home-surface-screen {
-  --home-surface-title-size: 2rem;
   --home-surface-panel-padding: 1rem;
 }
 
-.home-surface-screen__header {
-  align-items: flex-start;
+.home-surface-screen__actions {
   display: flex;
-  gap: 1rem;
-  justify-content: space-between;
-}
-
-.home-surface-screen__title {
-  font-size: var(--home-surface-title-size);
-  font-weight: 700;
-  letter-spacing: 0;
-  line-height: 1.1;
-  margin: 0 0 0.4rem;
+  justify-content: flex-end;
 }
 
 .home-surface-screen__panel {
@@ -100,15 +82,7 @@ const healthPending = computed(
 }
 
 @media (max-width: 640px) {
-  .home-surface-screen {
-    --home-surface-title-size: 1.5rem;
-  }
-
-  .home-surface-screen__header {
-    flex-direction: column;
-  }
-
-  .home-surface-screen__header :deep(.v-btn) {
+  .home-surface-screen__actions :deep(.v-btn) {
     min-height: 48px;
     width: 100%;
   }

package/patterns/shell-foundation/example/src/pages/home/settings/general/index.vue

@@ -16,12 +16,9 @@ const drawerDefaultOpenModel = computed({
 
 <template>
   <section class="settings-general-screen d-flex flex-column ga-4">
-    <div>
-      <h2 class="text-h6 mb-2">Navigation</h2>
-      <p class="text-body-2 text-medium-emphasis mb-0">
-        On wider screens, collapsed navigation remains available as a rail. Phone layouts close the drawer and keep primary navigation in the bottom bar.
-      </p>
-    </div>
+    <p class="text-body-2 text-medium-emphasis mb-0">
+      On wider screens, collapsed navigation remains available as a rail. Phone layouts close the drawer and keep primary navigation in the bottom bar.
+    </p>
 
     <v-switch
       v-model="drawerDefaultOpenModel"

package/patterns/shell-foundation/example/src/pages/home/settings.vue

@@ -5,12 +5,6 @@ import { RouterView } from "vue-router";
 
 <template>
   <section class="settings-shell d-flex flex-column ga-4">
-    <header>
-      <p class="text-overline text-medium-emphasis mb-1">Settings</p>
-      <h1 class="settings-shell__title">Home settings</h1>
-      <p class="text-body-2 text-medium-emphasis mb-0">Configure shell behavior for this surface.</p>
-    </header>
-
     <v-sheet rounded="lg" border class="settings-shell__panel">
       <div class="settings-shell__body">
         <nav class="settings-shell__nav" aria-label="Home settings sections">
@@ -29,18 +23,9 @@ import { RouterView } from "vue-router";
 
 <style scoped>
 .settings-shell {
-  --settings-title-size: 1.85rem;
   --settings-panel-padding: 1rem;
 }
 
-.settings-shell__title {
-  font-size: var(--settings-title-size);
-  font-weight: 650;
-  letter-spacing: 0;
-  line-height: 1.15;
-  margin: 0 0 0.35rem;
-}
-
 .settings-shell__panel {
   overflow: hidden;
 }
@@ -81,10 +66,6 @@ import { RouterView } from "vue-router";
 }
 
 @media (max-width: 960px) {
-  .settings-shell {
-    --settings-title-size: 1.35rem;
-  }
-
   .settings-shell__body {
     grid-template-columns: 1fr;
   }

package/patterns/shell-foundation/example/tests/e2e/base-shell.spec.ts

@@ -11,7 +11,7 @@ test.describe("application responsive smoke", () => {
     test(`${viewport.name} home route renders without horizontal overflow`, async ({ page }) => {
       await page.setViewportSize(viewport);
       await page.goto("/home");
-      await expect(page.getByRole("heading", { name: "Ready" })).toBeVisible();
+      await expect(page.getByText("Service health")).toBeVisible();
 
       const dimensions = await page.evaluate(() => ({
         clientWidth: document.documentElement.clientWidth,

package/patterns/ui-contract.md

@@ -12,6 +12,8 @@ and action UI.
 - Compact interactive targets are at least 48 CSS pixels.
 - Navigation uses semantic placements and explicit navigation roles.
 - Pages do not stack decorative cards inside structural cards.
+- Pages do not include a header, title block, welcome heading, or standalone
+  heading copy unless the user explicitly requests one.
 - Shared screens own repeated chrome; app pages own product fields and domain
   sections.
 

package/patterns/ui-testing.md

@@ -53,7 +53,7 @@ import { loginAsExistingUser } from "@jskit-ai/auth-web/test/playwright";
 test("authenticated feature", async ({ page }) => {
   await loginAsExistingUser(page, { email: "ada@example.com" });
   await page.goto("/w/acme/admin/contacts");
-  await expect(page.getByRole("heading", { name: "Contacts" })).toBeVisible();
+  await expect(page.getByRole("button", { name: "Add contact" })).toBeVisible();
 });
 ```
 

package/reference/autogen/PATTERN_INDEX.md

@@ -15,7 +15,7 @@ A concrete Fastify, Vue, and JSKIT application foundation for products that do n
 
 - Id: `app/minimal-foundation`
 - Keywords: `app`, `fastify`, `foundation`, `minimal`, `server`, `vite`, `vue`
-- Owner: `@jskit-ai/agent-docs@0.1.150`
+- Owner: `@jskit-ai/agent-docs@0.1.151`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/app/minimal-foundation/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/app/minimal-foundation/example/)
 - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`
@@ -26,7 +26,7 @@ A concrete JSKIT web application foundation with responsive shell navigation, se
 
 - Id: `app/shell-foundation`
 - Keywords: `app`, `foundation`, `material`, `navigation`, `placements`, `shell`, `vite`, `vue`
-- Owner: `@jskit-ai/agent-docs@0.1.150`
+- Owner: `@jskit-ai/agent-docs@0.1.151`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/app/shell-foundation/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/app/shell-foundation/example/)
 - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -37,7 +37,7 @@ Configure an assistant runtime for one application surface and expose its chat a
 
 - Id: `assistant/assistant-surface`
 - Keywords: `ai`, `assistant`, `chat`, `config`, `environment`, `page`, `placement`, `settings`, `surface`
-- Owner: `@jskit-ai/assistant-runtime@0.1.149`
+- Owner: `@jskit-ai/assistant-runtime@0.1.150`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/assistant/assistant-surface/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/assistant/assistant-surface/example/)
 - Requires: `@jskit-ai/assistant-runtime`, `@jskit-ai/shell-web`
@@ -48,7 +48,7 @@ Compose JSKIT authentication routes, views, profile controls, and public surface
 
 - Id: `auth/auth-surface`
 - Keywords: `account`, `auth`, `login`, `logout`, `password`, `placement`, `profile`, `reset`, `surface`
-- Owner: `@jskit-ai/auth-web@0.1.178`
+- Owner: `@jskit-ai/auth-web@0.1.179`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/auth/auth-surface/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/auth/auth-surface/example/)
 - Requires: `@jskit-ai/auth-core`, `@jskit-ai/auth-web`, `@jskit-ai/shell-web`
@@ -59,7 +59,7 @@ Add Supabase authentication through normal npm composition, explicit environment
 
 - Id: `auth/supabase-auth`
 - Keywords: `auth`, `authentication`, `oauth`, `sessions`, `supabase`
-- Owner: `@jskit-ai/auth-provider-supabase-core@0.1.175`
+- Owner: `@jskit-ai/auth-provider-supabase-core@0.1.176`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/auth/supabase-auth/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/auth/supabase-auth/example/)
 - Requires: `@jskit-ai/auth-provider-supabase-core`
@@ -70,7 +70,7 @@ Add a protected administration surface, settings shell, and semantic navigation
 
 - Id: `console/console-surface`
 - Keywords: `admin`, `console`, `navigation`, `owner`, `placement`, `settings`, `surface`
-- Owner: `@jskit-ai/console-web@0.1.146`
+- Owner: `@jskit-ai/console-web@0.1.147`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/console/console-surface/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/console/console-surface/example/)
 - Requires: `@jskit-ai/console-core`, `@jskit-ai/console-web`, `@jskit-ai/shell-web`
@@ -81,7 +81,7 @@ Build a routed CRUD user interface as thin application pages over JSKIT's shared
 
 - Id: `crud/crud-screen-set`
 - Keywords: `actions`, `add`, `crud`, `delete`, `edit`, `filters`, `list`, `material`, `routes`, `view`, `vue`
-- Owner: `@jskit-ai/http-web@0.1.23`
+- Owner: `@jskit-ai/http-web@0.1.24`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/crud/crud-screen-set/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/crud/crud-screen-set/example/)
 - Requires: `@jskit-ai/http-web`, `@jskit-ai/resource-crud-core`
@@ -92,7 +92,7 @@ Build a complete application-owned CRUD server package from a migration, resourc
 
 - Id: `crud/json-api-resource-package`
 - Keywords: `actions`, `crud`, `database`, `json-api`, `migration`, `permissions`, `provider`, `repository`, `routes`, `service`
-- Owner: `@jskit-ai/crud-core@0.1.189`
+- Owner: `@jskit-ai/crud-core@0.1.190`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/crud/json-api-resource-package/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/crud/json-api-resource-package/example/)
 - Requires: `@jskit-ai/crud-core`, `@jskit-ai/resource-crud-core`
@@ -103,7 +103,7 @@ Define an authenticated application resource whose records belong to the current
 
 - Id: `crud/resource-contract`
 - Keywords: `authenticated`, `crud`, `database`, `owner-scoped`, `resource`, `user`
-- Owner: `@jskit-ai/resource-crud-core@0.1.120`
+- Owner: `@jskit-ai/resource-crud-core@0.1.121`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/crud/resource-contract/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/crud/resource-contract/example/)
 - Requires: `@jskit-ai/resource-crud-core`
@@ -114,7 +114,7 @@ Configure a JSKIT application for MySQL with a fixed driver, ordinary environmen
 
 - Id: `database/mysql-application`
 - Keywords: `database`, `knex`, `mariadb`, `migrations`, `mysql`, `mysql2`
-- Owner: `@jskit-ai/database-runtime-mysql@0.1.176`
+- Owner: `@jskit-ai/database-runtime-mysql@0.1.177`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/database/mysql-application/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/database/mysql-application/example/)
 - Requires: `@jskit-ai/database-runtime-mysql`
@@ -125,7 +125,7 @@ Configure a JSKIT application for PostgreSQL with a fixed driver, ordinary envir
 
 - Id: `database/postgres-application`
 - Keywords: `database`, `knex`, `migrations`, `pg`, `postgres`, `postgresql`
-- Owner: `@jskit-ai/database-runtime-postgres@0.1.175`
+- Owner: `@jskit-ai/database-runtime-postgres@0.1.176`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/database/postgres-application/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/database/postgres-application/example/)
 - Requires: `@jskit-ai/database-runtime-postgres`
@@ -136,7 +136,7 @@ Wrap a JSKIT web application in a Capacitor Android shell using native Capacitor
 
 - Id: `mobile/android-application`
 - Keywords: `android`, `capacitor`, `device`, `mobile`, `native`, `shell`, `webview`
-- Owner: `@jskit-ai/mobile-capacitor@0.1.113`
+- Owner: `@jskit-ai/mobile-capacitor@0.1.114`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/mobile/android-application/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/mobile/android-application/example/)
 - Requires: `@capacitor/android`, `@capacitor/app`, `@capacitor/cli`, `@jskit-ai/mobile-capacitor`
@@ -147,7 +147,7 @@ Add JSKIT realtime events with an optional Redis backplane and an explicit shell
 
 - Id: `realtime/realtime-application`
 - Keywords: `realtime`, `redis`, `socket.io`, `sockets`, `status`, `websocket`
-- Owner: `@jskit-ai/realtime@0.1.175`
+- Owner: `@jskit-ai/realtime@0.1.176`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/realtime/realtime-application/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/realtime/realtime-application/example/)
 - Requires: `@jskit-ai/realtime`, `@jskit-ai/shell-web`
@@ -158,7 +158,7 @@ Define a server feature through explicit capabilities and first-class actions, a
 
 - Id: `server/feature-package`
 - Keywords: `actions`, `feature`, `json-rest`, `knex`, `orchestration`, `package`, `provider`, `repository`, `routes`, `server`
-- Owner: `@jskit-ai/agent-docs@0.1.150`
+- Owner: `@jskit-ai/agent-docs@0.1.151`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/server/feature-package/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/server/feature-package/example/)
 - Requires: `@jskit-ai/kernel`
@@ -169,7 +169,7 @@ Compose the JSKIT responsive shell, semantic placements, settings navigation, an
 
 - Id: `shell/application-shell`
 - Keywords: `adaptive`, `app`, `layout`, `navigation`, `placement`, `responsive`, `settings`, `shell`
-- Owner: `@jskit-ai/shell-web@0.1.182`
+- Owner: `@jskit-ai/shell-web@0.1.183`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/shell/application-shell/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/shell/application-shell/example/)
 - Requires: `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -180,7 +180,7 @@ Add product routes and shell extensions through file routing, semantic placement
 
 - Id: `ui/page-and-placement`
 - Keywords: `component`, `navigation`, `outlet`, `page`, `placement`, `routes`, `section`, `shell`, `subpages`, `vue`
-- Owner: `@jskit-ai/shell-web@0.1.182`
+- Owner: `@jskit-ai/shell-web@0.1.183`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/ui/page-and-placement/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/ui/page-and-placement/example/)
 - Requires: `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -191,7 +191,7 @@ Compose an account settings route and profile, preference, and notification sect
 
 - Id: `users/account-settings`
 - Keywords: `account`, `notifications`, `preferences`, `profile`, `settings`, `user`, `vue`
-- Owner: `@jskit-ai/users-web@0.1.196`
+- Owner: `@jskit-ai/users-web@0.1.197`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/users/account-settings/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/users/account-settings/example/)
 - Requires: `@jskit-ai/shell-web`, `@jskit-ai/users-core`, `@jskit-ai/users-web`
@@ -202,7 +202,7 @@ Expose user administration and workspace-scoped member operations through app-ow
 
 - Id: `users/user-administration-server`
 - Keywords: `account`, `admin`, `member`, `repository`, `resource`, `routes`, `service`, `user`, `workspace`
-- Owner: `@jskit-ai/users-core@0.1.191`
+- Owner: `@jskit-ai/users-core@0.1.192`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/users/user-administration-server/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/users/user-administration-server/example/)
 - Requires: `@jskit-ai/crud-core`, `@jskit-ai/users-core`
@@ -213,7 +213,7 @@ Configure roles, workspace access policy, invitations, and app-owned invitation
 
 - Id: `workspaces/workspace-server`
 - Keywords: `access`, `invite`, `membership`, `multitenancy`, `policy`, `role`, `tenancy`, `workspace`
-- Owner: `@jskit-ai/workspaces-core@0.1.156`
+- Owner: `@jskit-ai/workspaces-core@0.1.157`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/workspaces/workspace-server/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/workspaces/workspace-server/example/)
 - Requires: `@jskit-ai/users-core`, `@jskit-ai/workspaces-core`
@@ -224,7 +224,7 @@ Compose workspace selection, invitation, member administration, settings, and re
 
 - Id: `workspaces/workspace-surfaces`
 - Keywords: `admin`, `invite`, `member`, `navigation`, `settings`, `surface`, `switcher`, `workspace`
-- Owner: `@jskit-ai/workspaces-web@0.1.157`
+- Owner: `@jskit-ai/workspaces-web@0.1.158`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/workspaces/workspace-surfaces/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/workspaces/workspace-surfaces/example/)
 - Requires: `@jskit-ai/shell-web`, `@jskit-ai/workspaces-core`, `@jskit-ai/workspaces-web`

package/skills/jskit/references/material-3.md

@@ -44,8 +44,9 @@ Do not replace a shared screen to restyle it. Use its public seams.
 - Use Vuetify spacing utilities and established JSKIT dimensions before raw
   values. Preserve JSKIT shell widths, target sizes, and spacing props.
 - Use elevation `0` through `5`, shape props, and component variants instead of
-  arbitrary shadows and radii. Prefer a page header and direct `v-sheet` work
-  region; add cards or dialogs only for genuinely grouped or elevated objects.
+  arbitrary shadows and radii. Never add page headers or standalone headings
+  unless explicitly requested. Use a direct `v-sheet` work region when needed;
+  reserve cards and dialogs for genuinely grouped or elevated objects.
 
 ## Components, state, and feedback