@jskit-ai/agent-docs 0.1.150 → 0.1.151

package/skills/jskit/references/patterns/database/mysql-application/example/package.json

@@ -8,6 +8,6 @@
     "db:migrate:status": "knex --knexfile ./knexfile.js migrate:list"
   },
   "dependencies": {
-    "@jskit-ai/database-runtime-mysql": "0.1.176"
+    "@jskit-ai/database-runtime-mysql": "0.1.177"
   }
 }

package/skills/jskit/references/patterns/database/postgres-application/example/package.json

@@ -8,6 +8,6 @@
     "db:migrate:status": "knex --knexfile ./knexfile.js migrate:list"
   },
   "dependencies": {
-    "@jskit-ai/database-runtime-postgres": "0.1.175"
+    "@jskit-ai/database-runtime-postgres": "0.1.176"
   }
 }

package/skills/jskit/references/patterns/realtime/realtime-application/example/package.json

@@ -2,7 +2,7 @@
   "private": true,
   "type": "module",
   "dependencies": {
-    "@jskit-ai/realtime": "0.1.175",
-    "@jskit-ai/shell-web": "0.1.182"
+    "@jskit-ai/realtime": "0.1.176",
+    "@jskit-ai/shell-web": "0.1.183"
   }
 }

package/skills/jskit/references/patterns/server/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/skills/jskit/references/patterns/shell/application-shell/PATTERN.md

@@ -32,6 +32,7 @@ placement registry, topology, and adaptive smoke helper exported by
 ## Invariants
 
 - `App.vue`, the shell layout, placements, topology, and route pages agree.
+- Route pages do not add a page header or standalone heading by default.
 - Navigation uses semantic placements rather than direct component injection.
 - Compact controls have accessible names and at least 48 CSS-pixel targets.
 - Cached route/resource state hydrates writable UI state synchronously or with

package/skills/jskit/references/patterns/shell/application-shell/example/expected-existing/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/skills/jskit/references/patterns/shell/application-shell/example/src/pages/home/index.vue

@@ -29,16 +29,9 @@ const health = 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">
@@ -56,23 +49,12 @@ const health = 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 {
@@ -90,15 +72,7 @@ const health = 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/skills/jskit/references/patterns/shell/application-shell/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/skills/jskit/references/patterns/shell/application-shell/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-shell-title-size: 1.85rem;
   --settings-shell-panel-padding: 1rem;
 }
 
-.settings-shell__title {
-  font-size: var(--settings-shell-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-shell-title-size: 1.35rem;
-  }
-
   .settings-shell__body {
     grid-template-columns: 1fr;
   }

package/skills/jskit/references/patterns/ui/page-and-placement/PATTERN.md

@@ -30,6 +30,7 @@ a filename alone.
 ## Invariants
 
 - File routes and placement destinations agree.
+- Route pages do not add a page header or standalone heading by default.
 - Placement ids describe product ownership, not the authoring mechanism.
 - Child links share an explicit section owner.
 - Topology maps each semantic placement to concrete responsive outlets.

package/skills/jskit/references/patterns/ui/page-and-placement/example/src/pages/home/reports/activity.vue

@@ -1,6 +1,5 @@
 <template>
-  <section aria-labelledby="reports-activity-title">
-    <h2 id="reports-activity-title" class="text-h5 mb-2">Activity</h2>
+  <section>
     <p class="text-body-1 text-medium-emphasis mb-0">
       Recent catalogue changes appear here.
     </p>

package/skills/jskit/references/patterns/ui/page-and-placement/example/src/pages/home/reports/overview.vue

@@ -1,6 +1,5 @@
 <template>
-  <section aria-labelledby="reports-overview-title">
-    <h2 id="reports-overview-title" class="text-h5 mb-2">Overview</h2>
+  <section>
     <p class="text-body-1 text-medium-emphasis mb-0">
       Your reading and catalogue summary appears here.
     </p>

package/skills/jskit/references/patterns/ui/page-and-placement/example/src/pages/home/reports.vue

@@ -5,14 +5,6 @@ import { RouterView } from "vue-router";
 
 <template>
   <section class="reports-section d-flex flex-column ga-4">
-    <header>
-      <p class="text-overline text-medium-emphasis mb-1">Insights</p>
-      <h1 class="text-h4 font-weight-medium mb-1">Reports</h1>
-      <p class="text-body-2 text-medium-emphasis mb-0">
-        Review catalogue activity and completion trends.
-      </p>
-    </header>
-
     <nav aria-label="Report sections">
       <v-tabs density="comfortable">
         <ShellOutlet target="reports:section-nav" />

package/skills/jskit/references/patterns/users/account-settings/PATTERN.md

@@ -31,6 +31,8 @@ ordinary `useCommand()` mutation behavior, and JSKIT shell placements.
 ## Invariants
 
 - Sections use JSKIT account settings APIs rather than direct HTTP helpers.
+- Settings pages and sections do not add headers or standalone headings by
+  default.
 - Cached resource data hydrates local writable fields immediately.
 - Mutation errors use the standard toast and do not push the form down.
 - Loading uses layout-stable skeletons, never an indeterminate spinner.

package/skills/jskit/references/patterns/users/account-settings/example/src/components/account/settings/AccountSettingsNotificationsSection.vue

@@ -11,9 +11,6 @@ const notifications = props.runtime.notifications;
 
 <template>
   <v-sheet rounded="lg" border class="account-settings-section">
-    <header class="account-settings-section__header">
-      <h2 class="account-settings-section__title">Notifications</h2>
-    </header>
     <div class="account-settings-section__body">
       <v-form @submit.prevent="notifications.submit" novalidate>
         <v-switch
@@ -58,17 +55,6 @@ const notifications = props.runtime.notifications;
   overflow: hidden;
 }
 
-.account-settings-section__header {
-  padding: 1rem 1rem 0;
-}
-
-.account-settings-section__title {
-  font-size: 1rem;
-  font-weight: 650;
-  line-height: 1.2;
-  margin: 0;
-}
-
 .account-settings-section__body {
   padding: 1rem;
 }

package/skills/jskit/references/patterns/users/account-settings/example/src/components/account/settings/AccountSettingsPreferencesSection.vue

@@ -11,9 +11,6 @@ const preferences = props.runtime.preferences;
 
 <template>
   <v-sheet rounded="lg" border class="account-settings-section">
-    <header class="account-settings-section__header">
-      <h2 class="account-settings-section__title">Preferences</h2>
-    </header>
     <div class="account-settings-section__body">
       <v-form @submit.prevent="preferences.submit" novalidate>
         <v-row>
@@ -128,17 +125,6 @@ const preferences = props.runtime.preferences;
   overflow: hidden;
 }
 
-.account-settings-section__header {
-  padding: 1rem 1rem 0;
-}
-
-.account-settings-section__title {
-  font-size: 1rem;
-  font-weight: 650;
-  line-height: 1.2;
-  margin: 0;
-}
-
 .account-settings-section__body {
   padding: 1rem;
 }

package/skills/jskit/references/patterns/users/account-settings/example/src/components/account/settings/AccountSettingsProfileSection.vue

@@ -11,9 +11,6 @@ const profile = props.runtime.profile;
 
 <template>
   <v-sheet rounded="lg" border class="account-settings-section">
-    <header class="account-settings-section__header">
-      <h2 class="account-settings-section__title">Profile</h2>
-    </header>
     <div class="account-settings-section__body">
       <v-form @submit.prevent="profile.submit" novalidate>
         <v-row class="mb-2">
@@ -97,17 +94,6 @@ const profile = props.runtime.profile;
   overflow: hidden;
 }
 
-.account-settings-section__header {
-  padding: 1rem 1rem 0;
-}
-
-.account-settings-section__title {
-  font-size: 1rem;
-  font-weight: 650;
-  line-height: 1.2;
-  margin: 0;
-}
-
 .account-settings-section__body {
   padding: 1rem;
 }

package/skills/jskit/references/patterns/users/user-administration-server/example/packages/users/package.json

@@ -9,8 +9,8 @@
     "./shared": "./src/shared/index.js"
   },
   "dependencies": {
-    "@jskit-ai/crud-core": "0.1.189",
-    "@jskit-ai/resource-crud-core": "0.1.120"
+    "@jskit-ai/crud-core": "0.1.190",
+    "@jskit-ai/resource-crud-core": "0.1.121"
   },
   "jskit": {
     "kind": "runtime",

package/skills/jskit/references/patterns/users/user-administration-server/example/packages/users-workspace/package.json

@@ -9,9 +9,9 @@
     "./shared": "./src/shared/index.js"
   },
   "dependencies": {
-    "@jskit-ai/crud-core": "0.1.189",
-    "@jskit-ai/resource-crud-core": "0.1.120",
-    "@jskit-ai/workspaces-core": "0.1.156"
+    "@jskit-ai/crud-core": "0.1.190",
+    "@jskit-ai/resource-crud-core": "0.1.121",
+    "@jskit-ai/workspaces-core": "0.1.157"
   },
   "jskit": {
     "kind": "runtime",

package/skills/jskit/references/patterns/workspaces/workspace-surfaces/PATTERN.md

@@ -32,6 +32,8 @@ Use the workspace client provider, components, and composables exported by
 ## Invariants
 
 - Route workspace slug, selected workspace, and server scope stay synchronized.
+- Route and surface pages do not add a page header or standalone heading by
+  default.
 - Invitation acceptance is public only where the server contract permits it.
 - Administrative UI visibility never substitutes for server authorization.
 - Query and route state hydrate immediately on warm-cache navigation.

package/skills/jskit/references/patterns/workspaces/workspace-surfaces/example/src/components/WorkspaceNotFoundCard.vue

@@ -19,12 +19,9 @@ const normalizedMessage = computed(() => String(props.message || "").trim() || "
 
 <template>
   <v-sheet rounded="lg" border class="workspace-unavailable-panel">
-    <div class="workspace-unavailable-panel__header">
+    <div class="workspace-unavailable-panel__status">
       <v-icon :icon="mdiAlertCircleOutline" color="error" />
-      <div>
-        <h1 class="workspace-unavailable-panel__title">Unavailable</h1>
-        <p class="text-body-2 text-medium-emphasis mb-0">{{ normalizedSurfaceLabel }} surface.</p>
-      </div>
+      <p class="text-body-2 text-medium-emphasis mb-0">{{ normalizedSurfaceLabel }} surface unavailable.</p>
     </div>
     <p class="text-body-2 text-medium-emphasis mb-0">{{ normalizedMessage }}</p>
   </v-sheet>
@@ -37,17 +34,9 @@ const normalizedMessage = computed(() => String(props.message || "").trim() || "
   padding: 1rem;
 }
 
-.workspace-unavailable-panel__header {
+.workspace-unavailable-panel__status {
   align-items: flex-start;
   display: flex;
   gap: 0.75rem;
 }
-
-.workspace-unavailable-panel__title {
-  font-size: clamp(1.35rem, 2vw, 1.85rem);
-  font-weight: 650;
-  letter-spacing: -0.02em;
-  line-height: 1.15;
-  margin: 0 0 0.25rem;
-}
 </style>

package/skills/jskit/references/patterns/workspaces/workspace-surfaces/example/src/pages/admin/workspace/settings/index.vue

@@ -1,7 +1,6 @@
 <template>
   <section class="workspace-settings-landing">
     <v-sheet rounded="lg" border class="workspace-settings-landing__panel">
-      <h2 class="workspace-settings-landing__title">No settings sections yet</h2>
       <p class="text-body-2 text-medium-emphasis mb-0">
         This app has no workspace-level settings configured.
       </p>
@@ -13,11 +12,4 @@
 .workspace-settings-landing__panel {
   padding: 1rem;
 }
-
-.workspace-settings-landing__title {
-  font-size: 1rem;
-  font-weight: 650;
-  line-height: 1.2;
-  margin: 0 0 0.25rem;
-}
 </style>

package/skills/jskit/references/patterns/workspaces/workspace-surfaces/example/src/pages/admin/workspace/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">Workspace settings</h1>
-      <p class="text-body-2 text-medium-emphasis mb-0">Configure the current workspace and its members.</p>
-    </header>
-
     <v-sheet rounded="lg" border class="settings-shell__panel">
       <nav class="settings-shell__nav" aria-label="Workspace settings sections">
         <v-list nav density="compact" class="settings-shell__nav-list">
@@ -25,14 +19,6 @@ import { RouterView } from "vue-router";
 </template>
 
 <style scoped>
-.settings-shell__title {
-  font-size: clamp(1.35rem, 2vw, 1.85rem);
-  font-weight: 650;
-  letter-spacing: -0.02em;
-  line-height: 1.15;
-  margin: 0 0 0.35rem;
-}
-
 .settings-shell__panel {
   display: grid;
   gap: 1rem;

package/skills/jskit/references/patterns/workspaces/workspace-surfaces/example/src/surfaces/admin/index.vue

@@ -20,20 +20,12 @@ function adminChildPath(suffix = "") {
     surface-label="Admin"
   />
   <section v-else class="workspace-admin-screen d-flex flex-column ga-4">
-    <header class="workspace-admin-screen__header">
-      <div>
-        <p class="text-overline text-medium-emphasis mb-1">Admin</p>
-        <h1 class="workspace-admin-screen__title">Workspace Admin</h1>
-        <p class="text-body-2 text-medium-emphasis mb-0">Manage members and workspace settings.</p>
-      </div>
-      <div class="workspace-admin-screen__actions">
-        <v-btn color="primary" variant="flat" :to="adminChildPath('members')">Members</v-btn>
-        <v-btn color="primary" variant="tonal" :to="adminChildPath('workspace/settings')">Settings</v-btn>
-      </div>
-    </header>
+    <div class="workspace-admin-screen__actions">
+      <v-btn color="primary" variant="flat" :to="adminChildPath('members')">Members</v-btn>
+      <v-btn color="primary" variant="tonal" :to="adminChildPath('workspace/settings')">Settings</v-btn>
+    </div>
 
     <v-sheet rounded="lg" border class="workspace-admin-screen__panel">
-      <h2 class="text-h6 mb-2">Admin tasks</h2>
       <p class="text-body-2 text-medium-emphasis mb-0">
         Review workspace access, members, and operational settings from this surface.
       </p>
@@ -42,21 +34,6 @@ function adminChildPath(suffix = "") {
 </template>
 
 <style scoped>
-.workspace-admin-screen__header {
-  align-items: flex-start;
-  display: flex;
-  gap: 1rem;
-  justify-content: space-between;
-}
-
-.workspace-admin-screen__title {
-  font-size: clamp(1.5rem, 2.5vw, 2.25rem);
-  font-weight: 700;
-  letter-spacing: -0.03em;
-  line-height: 1.1;
-  margin: 0 0 0.4rem;
-}
-
 .workspace-admin-screen__actions {
   display: flex;
   flex-wrap: wrap;
@@ -69,10 +46,6 @@ function adminChildPath(suffix = "") {
 }
 
 @media (max-width: 640px) {
-  .workspace-admin-screen__header {
-    flex-direction: column;
-  }
-
   .workspace-admin-screen__actions {
     width: 100%;
   }

package/skills/jskit/references/patterns/workspaces/workspace-surfaces/example/src/surfaces/app/index.vue

@@ -12,14 +12,7 @@ const { workspaceUnavailable, workspaceUnavailableMessage } = useWorkspaceNotFou
     surface-label="App"
   />
   <section v-else class="workspace-home-screen d-flex flex-column ga-4">
-    <header>
-      <p class="text-overline text-medium-emphasis mb-1">Workspace</p>
-      <h1 class="workspace-home-screen__title">Workspace Home</h1>
-      <p class="text-body-2 text-medium-emphasis mb-0">The current workspace is active.</p>
-    </header>
-
     <v-sheet rounded="lg" border class="workspace-home-screen__panel">
-      <h2 class="text-h6 mb-2">No workspace activity yet</h2>
       <p class="text-body-2 text-medium-emphasis mb-0">
         Activity from workspace workflows will appear here.
       </p>
@@ -28,14 +21,6 @@ const { workspaceUnavailable, workspaceUnavailableMessage } = useWorkspaceNotFou
 </template>
 
 <style scoped>
-.workspace-home-screen__title {
-  font-size: clamp(1.5rem, 2.5vw, 2.25rem);
-  font-weight: 700;
-  letter-spacing: -0.03em;
-  line-height: 1.1;
-  margin: 0 0 0.4rem;
-}
-
 .workspace-home-screen__panel {
   margin-inline: auto;
   max-width: 34rem;

package/skills/jskit/references/ui-operations.md

@@ -29,7 +29,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/templates/app/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.