npm - @jskit-ai/jskit-catalog - Versions diffs - 0.1.40 → 0.1.42 - Mend

@jskit-ai/jskit-catalog 0.1.40 → 0.1.42

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2) hide show

package/catalog/packages.json +425 -231
package/package.json +1 -1

package/catalog/packages.json CHANGED Viewed

@@ -6,11 +6,11 @@
   "packages": [
     {
       "packageId": "@jskit-ai/assistant",
-      "version": "0.1.41",
+      "version": "0.1.43",
       "descriptor": {
         "packageVersion": 1,
         "packageId": "@jskit-ai/assistant",
-        "version": "0.1.41",
+        "version": "0.1.43",
         "kind": "generator",
         "description": "Install assistant runtime/config for one surface and scaffold assistant pages at explicit target files.",
         "options": {
@@ -28,8 +28,7 @@
             "inputType": "text",
             "validationType": "enabled-surface-id",
             "defaultValue": "",
-            "promptLabel": "Settings surface",
-            "promptHint": "Enabled settings host surface id used by assistant setup.",
+            "promptLabel": "Which enabled surface should host the assistant settings UI?",
             "helpHint": "Surface that hosts the settings UI for the selected assistant runtime."
           },
           "config-scope": {
@@ -59,7 +58,7 @@
             "inputType": "text",
             "defaultValue": "",
             "promptLabel": "Link placement",
-            "promptHint": "Optional host:position target for the generated page link placement."
+            "promptHint": "Optional target for the generated page link placement (format: host:position)."
           },
           "link-component-token": {
             "required": false,
@@ -78,7 +77,7 @@
           "ai-config-prefix": {
             "required": false,
             "inputType": "text",
-            "defaultValue": "",
+            "defaultFromOptionTemplate": "${option:surface|snake|upper}_ASSISTANT",
             "promptLabel": "AI config prefix",
             "promptHint": "Optional env/config prefix override. Defaults to <SURFACE>_ASSISTANT."
           },
@@ -96,8 +95,7 @@
             "promptHint": "Leave empty to keep the assistant disabled until you add a key."
           },
           "ai-base-url": {
-            "required": true,
-            "allowEmpty": true,
+            "required": false,
             "defaultValue": "",
             "promptLabel": "AI base URL",
             "promptHint": "Optional provider-compatible base URL override."
@@ -173,6 +171,7 @@
               ]
             },
             "page": {
+              "requiresShellWeb": true,
               "entrypoint": "src/server/subcommands/page.js",
               "export": "runGeneratorSubcommand",
               "description": "Create an assistant runtime page at an explicit target file relative to src/pages/.",
@@ -215,6 +214,7 @@
               ]
             },
             "settings-page": {
+              "requiresShellWeb": true,
               "entrypoint": "src/server/subcommands/settingsPage.js",
               "export": "runGeneratorSubcommand",
               "description": "Create an assistant settings page at an explicit target file relative to src/pages/.",
@@ -315,18 +315,40 @@
               }
             },
             {
-              "op": "append-text",
               "file": ".env",
-              "position": "bottom",
-              "skipIfContains": "__ASSISTANT_AI_CONFIG_PREFIX___AI_PROVIDER=",
-              "value": "\n__ASSISTANT_AI_CONFIG_PREFIX___AI_PROVIDER=${option:ai-provider}\n__ASSISTANT_AI_CONFIG_PREFIX___AI_API_KEY=${option:ai-api-key}\n__ASSISTANT_AI_CONFIG_PREFIX___AI_BASE_URL=${option:ai-base-url}\n__ASSISTANT_AI_CONFIG_PREFIX___AI_TIMEOUT_MS=${option:ai-timeout-ms}\n",
-              "reason": "Append assistant AI env defaults for the generated surface prefix.",
+              "op": "upsert-env",
+              "key": "${option:ai-config-prefix}_AI_PROVIDER",
+              "value": "${option:ai-provider}",
+              "reason": "Configure the assistant AI provider for the selected surface.",
               "category": "runtime-config",
-              "id": "assistant-ai-prefixed-env",
-              "templateContext": {
-                "entrypoint": "src/server/buildTemplateContext.js",
-                "export": "buildTemplateContext"
-              }
+              "id": "assistant-ai-provider"
+            },
+            {
+              "file": ".env",
+              "op": "upsert-env",
+              "key": "${option:ai-config-prefix}_AI_API_KEY",
+              "value": "${option:ai-api-key}",
+              "reason": "Configure the assistant AI API key for the selected surface.",
+              "category": "runtime-config",
+              "id": "assistant-ai-api-key"
+            },
+            {
+              "file": ".env",
+              "op": "upsert-env",
+              "key": "${option:ai-config-prefix}_AI_BASE_URL",
+              "value": "${option:ai-base-url}",
+              "reason": "Configure the optional assistant AI base URL override for the selected surface.",
+              "category": "runtime-config",
+              "id": "assistant-ai-base-url"
+            },
+            {
+              "file": ".env",
+              "op": "upsert-env",
+              "key": "${option:ai-config-prefix}_AI_TIMEOUT_MS",
+              "value": "${option:ai-timeout-ms}",
+              "reason": "Configure the assistant AI timeout for the selected surface.",
+              "category": "runtime-config",
+              "id": "assistant-ai-timeout-ms"
             }
           ]
         }
@@ -334,11 +356,11 @@
     },
     {
       "packageId": "@jskit-ai/assistant-core",
-      "version": "0.1.8",
+      "version": "0.1.10",
       "descriptor": {
         "packageVersion": 1,
         "packageId": "@jskit-ai/assistant-core",
-        "version": "0.1.8",
+        "version": "0.1.10",
         "kind": "runtime",
         "description": "Reusable assistant client/server/shared primitives without surface-specific routes or settings ownership.",
         "dependsOn": [
@@ -384,9 +406,9 @@
         "mutations": {
           "dependencies": {
             "runtime": {
-              "@jskit-ai/http-runtime": "0.1.31",
-              "@jskit-ai/kernel": "0.1.32",
-              "@jskit-ai/users-core": "0.1.42",
+              "@jskit-ai/http-runtime": "0.1.33",
+              "@jskit-ai/kernel": "0.1.34",
+              "@jskit-ai/users-core": "0.1.44",
               "@tanstack/vue-query": "^5.90.5",
               "dompurify": "^3.3.3",
               "marked": "^17.0.4",
@@ -407,11 +429,11 @@
     },
     {
       "packageId": "@jskit-ai/assistant-runtime",
-      "version": "0.1.3",
+      "version": "0.1.5",
       "descriptor": {
         "packageVersion": 1,
         "packageId": "@jskit-ai/assistant-runtime",
-        "version": "0.1.3",
+        "version": "0.1.5",
         "kind": "runtime",
         "description": "Shared assistant runtime with per-surface assistant registration.",
         "dependsOn": [
@@ -486,13 +508,13 @@
         "mutations": {
           "dependencies": {
             "runtime": {
-              "@jskit-ai/assistant-core": "0.1.8",
-              "@jskit-ai/database-runtime": "0.1.32",
-              "@jskit-ai/http-runtime": "0.1.31",
-              "@jskit-ai/kernel": "0.1.32",
-              "@jskit-ai/shell-web": "0.1.31",
-              "@jskit-ai/users-core": "0.1.42",
-              "@jskit-ai/users-web": "0.1.47",
+              "@jskit-ai/assistant-core": "0.1.10",
+              "@jskit-ai/database-runtime": "0.1.34",
+              "@jskit-ai/http-runtime": "0.1.33",
+              "@jskit-ai/kernel": "0.1.34",
+              "@jskit-ai/shell-web": "0.1.33",
+              "@jskit-ai/users-core": "0.1.44",
+              "@jskit-ai/users-web": "0.1.49",
               "@tanstack/vue-query": "^5.90.5",
               "vuetify": "^4.0.0"
             },
@@ -549,11 +571,11 @@
     },
     {
       "packageId": "@jskit-ai/auth-core",
-      "version": "0.1.31",
+      "version": "0.1.33",
       "descriptor": {
         "packageVersion": 1,
         "packageId": "@jskit-ai/auth-core",
-        "version": "0.1.31",
+        "version": "0.1.33",
         "kind": "runtime",
         "dependsOn": [
           "@jskit-ai/value-app-config-shared"
@@ -621,7 +643,7 @@
         "mutations": {
           "dependencies": {
             "runtime": {
-              "@jskit-ai/kernel": "0.1.32",
+              "@jskit-ai/kernel": "0.1.34",
               "@fastify/cookie": "^11.0.2",
               "@fastify/csrf-protection": "^7.1.0",
               "@fastify/rate-limit": "^10.3.0"
@@ -639,11 +661,11 @@
     },
     {
       "packageId": "@jskit-ai/auth-provider-supabase-core",
-      "version": "0.1.31",
+      "version": "0.1.33",
       "descriptor": {
         "packageVersion": 1,
         "packageId": "@jskit-ai/auth-provider-supabase-core",
-        "version": "0.1.31",
+        "version": "0.1.33",
         "kind": "runtime",
         "options": {
           "auth-supabase-url": {
@@ -725,8 +747,8 @@
         "mutations": {
           "dependencies": {
             "runtime": {
-              "@jskit-ai/auth-core": "0.1.31",
-              "@jskit-ai/kernel": "0.1.32",
+              "@jskit-ai/auth-core": "0.1.33",
+              "@jskit-ai/kernel": "0.1.34",
               "dotenv": "^16.4.5",
               "@supabase/supabase-js": "^2.57.4",
               "jose": "^6.1.0"
@@ -791,11 +813,11 @@
     },
     {
       "packageId": "@jskit-ai/auth-web",
-      "version": "0.1.33",
+      "version": "0.1.35",
       "descriptor": {
         "packageVersion": 1,
         "packageId": "@jskit-ai/auth-web",
-        "version": "0.1.33",
+        "version": "0.1.35",
         "kind": "runtime",
         "description": "Auth web module: Fastify auth routes plus web login/sign-out scaffolds.",
         "dependsOn": [
@@ -971,8 +993,8 @@
             "placements": {
               "outlets": [
                 {
-                  "host": "auth-profile-menu",
-                  "position": "primary-menu",
+                  "target": "auth-profile-menu:primary-menu",
+                  "defaultLinkComponentToken": "auth.web.profile.menu.link-item",
                   "surfaces": [
                     "*"
                   ],
@@ -982,8 +1004,7 @@
               "contributions": [
                 {
                   "id": "auth.profile.widget",
-                  "host": "shell-layout",
-                  "position": "top-right",
+                  "target": "shell-layout:top-right",
                   "surfaces": [
                     "*"
                   ],
@@ -993,8 +1014,7 @@
                 },
                 {
                   "id": "auth.profile.menu.sign-in",
-                  "host": "auth-profile-menu",
-                  "position": "primary-menu",
+                  "target": "auth-profile-menu:primary-menu",
                   "surfaces": [
                     "*"
                   ],
@@ -1005,8 +1025,7 @@
                 },
                 {
                   "id": "auth.profile.menu.sign-out",
-                  "host": "auth-profile-menu",
-                  "position": "primary-menu",
+                  "target": "auth-profile-menu:primary-menu",
                   "surfaces": [
                     "*"
                   ],
@@ -1025,10 +1044,10 @@
               "@tanstack/vue-query": "5.92.12",
               "@mdi/js": "^7.4.47",
               "@fastify/type-provider-typebox": "^6.1.0",
-              "@jskit-ai/auth-core": "0.1.31",
-              "@jskit-ai/http-runtime": "0.1.31",
-              "@jskit-ai/kernel": "0.1.32",
-              "@jskit-ai/shell-web": "0.1.31",
+              "@jskit-ai/auth-core": "0.1.33",
+              "@jskit-ai/http-runtime": "0.1.33",
+              "@jskit-ai/kernel": "0.1.34",
+              "@jskit-ai/shell-web": "0.1.33",
               "vuetify": "^4.0.0"
             },
             "dev": {}
@@ -1087,7 +1106,7 @@
               "file": "src/placement.js",
               "position": "bottom",
               "skipIfContains": "id: \"auth.profile.widget\"",
-              "value": "\naddPlacement({\n  id: \"auth.profile.widget\",\n  host: \"shell-layout\",\n  position: \"top-right\",\n  surfaces: [\"*\"],\n  order: 1000,\n  componentToken: \"auth.web.profile.widget\"\n});\n\naddPlacement({\n  id: \"auth.profile.menu.sign-in\",\n  host: \"auth-profile-menu\",\n  position: \"primary-menu\",\n  surfaces: [\"*\"],\n  order: 200,\n  componentToken: \"auth.web.profile.menu.link-item\",\n  props: {\n    label: \"Sign in\",\n    to: \"/auth/login\"\n  },\n  when: ({ auth }) => !Boolean(auth?.authenticated)\n});\n\naddPlacement({\n  id: \"auth.profile.menu.sign-out\",\n  host: \"auth-profile-menu\",\n  position: \"primary-menu\",\n  surfaces: [\"*\"],\n  order: 1000,\n  componentToken: \"auth.web.profile.menu.link-item\",\n  props: {\n    label: \"Sign out\",\n    to: \"/auth/signout\"\n  },\n  when: ({ auth }) => Boolean(auth?.authenticated)\n});\n",
+              "value": "\naddPlacement({\n  id: \"auth.profile.widget\",\n  target: \"shell-layout:top-right\",\n  surfaces: [\"*\"],\n  order: 1000,\n  componentToken: \"auth.web.profile.widget\"\n});\n\naddPlacement({\n  id: \"auth.profile.menu.sign-in\",\n  target: \"auth-profile-menu:primary-menu\",\n  surfaces: [\"*\"],\n  order: 200,\n  componentToken: \"auth.web.profile.menu.link-item\",\n  props: {\n    label: \"Sign in\",\n    to: \"/auth/login\"\n  },\n  when: ({ auth }) => !Boolean(auth?.authenticated)\n});\n\naddPlacement({\n  id: \"auth.profile.menu.sign-out\",\n  target: \"auth-profile-menu:primary-menu\",\n  surfaces: [\"*\"],\n  order: 1000,\n  componentToken: \"auth.web.profile.menu.link-item\",\n  props: {\n    label: \"Sign out\",\n    to: \"/auth/signout\"\n  },\n  when: ({ auth }) => Boolean(auth?.authenticated)\n});\n",
               "reason": "Append auth profile placement entries into app-owned placement registry.",
               "category": "auth-web",
               "id": "auth-web-placement-block"
@@ -1098,11 +1117,11 @@
     },
     {
       "packageId": "@jskit-ai/crud-core",
-      "version": "0.1.40",
+      "version": "0.1.42",
       "descriptor": {
         "packageVersion": 1,
         "packageId": "@jskit-ai/crud-core",
-        "version": "0.1.40",
+        "version": "0.1.42",
         "kind": "runtime",
         "description": "Shared CRUD helpers used by CRUD modules.",
         "dependsOn": [
@@ -1129,7 +1148,7 @@
         "mutations": {
           "dependencies": {
             "runtime": {
-              "@jskit-ai/crud-core": "0.1.40"
+              "@jskit-ai/crud-core": "0.1.42"
             },
             "dev": {}
           },
@@ -1143,11 +1162,11 @@
     },
     {
       "packageId": "@jskit-ai/crud-server-generator",
-      "version": "0.1.40",
+      "version": "0.1.42",
       "descriptor": {
         "packageVersion": 1,
         "packageId": "@jskit-ai/crud-server-generator",
-        "version": "0.1.40",
+        "version": "0.1.42",
         "kind": "generator",
         "description": "CRUD server generator with routes, actions, and persistence scaffolding.",
         "options": {
@@ -1159,16 +1178,24 @@
             "promptHint": "Required slug (example: customers, appointments, vendors)."
           },
           "surface": {
-            "required": true,
+            "required": false,
             "inputType": "text",
             "validationType": "enabled-surface-id",
             "promptLabel": "Target surface",
-            "promptHint": "Must match an enabled surface id."
+            "promptHint": "Optional for non-workspace apps; otherwise must match an enabled surface id."
           },
           "ownership-filter": {
             "required": true,
             "inputType": "text",
             "defaultValue": "auto",
+            "validationType": "enum",
+            "allowedValues": [
+              "auto",
+              "public",
+              "user",
+              "workspace",
+              "workspace_user"
+            ],
             "promptLabel": "Ownership filter",
             "promptHint": "auto | public | user | workspace | workspace_user"
           },
@@ -1180,11 +1207,12 @@
             "promptHint": "Optional subpath prepended to the CRUD route path (example: crm or ops/team-a)."
           },
           "table-name": {
-            "required": true,
+            "required": false,
             "inputType": "text",
             "defaultValue": "",
+            "defaultFromOptionTemplate": "${option:namespace}",
             "promptLabel": "Table name",
-            "promptHint": "Required existing MySQL table to introspect for CRUD schema generation."
+            "promptHint": "Existing MySQL table to introspect for CRUD schema generation (defaults to namespace)."
           },
           "id-column": {
             "required": false,
@@ -1296,13 +1324,13 @@
         "mutations": {
           "dependencies": {
             "runtime": {
-              "@jskit-ai/auth-core": "0.1.31",
-              "@jskit-ai/crud-core": "0.1.40",
-              "@jskit-ai/database-runtime": "0.1.32",
-              "@jskit-ai/http-runtime": "0.1.31",
-              "@jskit-ai/kernel": "0.1.32",
-              "@jskit-ai/realtime": "0.1.31",
-              "@jskit-ai/users-core": "0.1.42",
+              "@jskit-ai/auth-core": "0.1.33",
+              "@jskit-ai/crud-core": "0.1.42",
+              "@jskit-ai/database-runtime": "0.1.34",
+              "@jskit-ai/http-runtime": "0.1.33",
+              "@jskit-ai/kernel": "0.1.34",
+              "@jskit-ai/realtime": "0.1.33",
+              "@jskit-ai/users-core": "0.1.44",
               "@local/${option:namespace|kebab}": "file:packages/${option:namespace|kebab}",
               "typebox": "^1.0.81"
             },
@@ -1356,7 +1384,11 @@
               "to": "packages/${option:namespace|kebab}/src/server/actions.js",
               "reason": "Install app-local CRUD action definitions.",
               "category": "crud",
-              "id": "crud-local-package-server-actions-${option:namespace|snake}"
+              "id": "crud-local-package-server-actions-${option:namespace|snake}",
+              "templateContext": {
+                "entrypoint": "src/server/buildTemplateContext.js",
+                "export": "buildTemplateContext"
+              }
             },
             {
               "from": "templates/src/local-package/server/actionIds.js",
@@ -1365,12 +1397,27 @@
               "category": "crud",
               "id": "crud-local-package-server-action-ids-${option:namespace|snake}"
             },
+            {
+              "from": "templates/src/local-package/server/listConfig.js",
+              "to": "packages/${option:namespace|kebab}/src/server/listConfig.js",
+              "reason": "Install app-local CRUD list configuration.",
+              "category": "crud",
+              "id": "crud-local-package-server-list-config-${option:namespace|snake}",
+              "templateContext": {
+                "entrypoint": "src/server/buildTemplateContext.js",
+                "export": "buildTemplateContext"
+              }
+            },
             {
               "from": "templates/src/local-package/server/registerRoutes.js",
               "to": "packages/${option:namespace|kebab}/src/server/registerRoutes.js",
               "reason": "Install app-local CRUD route registration.",
               "category": "crud",
-              "id": "crud-local-package-server-routes-${option:namespace|snake}"
+              "id": "crud-local-package-server-routes-${option:namespace|snake}",
+              "templateContext": {
+                "entrypoint": "src/server/buildTemplateContext.js",
+                "export": "buildTemplateContext"
+              }
             },
             {
               "from": "templates/src/local-package/server/repository.js",
@@ -1415,10 +1462,14 @@
               "file": "config/roles.js",
               "position": "bottom",
               "skipIfContains": "\"crud.${option:namespace|snake}.list\"",
-              "value": "\nroleCatalog.roles.member.permissions.push(\n  \"crud.${option:namespace|snake}.list\",\n  \"crud.${option:namespace|snake}.view\",\n  \"crud.${option:namespace|snake}.create\",\n  \"crud.${option:namespace|snake}.update\",\n  \"crud.${option:namespace|snake}.delete\"\n);\n",
+              "value": "__JSKIT_CRUD_ROLE_CATALOG_PERMISSION_GRANTS__",
               "reason": "Grant generated CRUD action permissions to the default member role in the app-owned role catalog.",
               "category": "crud",
-              "id": "crud-role-catalog-permissions-${option:namespace|snake}"
+              "id": "crud-role-catalog-permissions-${option:namespace|snake}",
+              "templateContext": {
+                "entrypoint": "src/server/buildTemplateContext.js",
+                "export": "buildTemplateContext"
+              }
             }
           ]
         }
@@ -1426,11 +1477,11 @@
     },
     {
       "packageId": "@jskit-ai/crud-ui-generator",
-      "version": "0.1.15",
+      "version": "0.1.17",
       "descriptor": {
         "packageVersion": 1,
         "packageId": "@jskit-ai/crud-ui-generator",
-        "version": "0.1.15",
+        "version": "0.1.17",
         "kind": "generator",
         "description": "Generate CRUD route trees from resource validators at an explicit route root relative to src/pages/.",
         "options": {
@@ -1453,6 +1504,13 @@
             "required": false,
             "inputType": "text",
             "defaultValue": "list,view,new,edit",
+            "validationType": "csv-enum",
+            "allowedValues": [
+              "list",
+              "view",
+              "new",
+              "edit"
+            ],
             "promptLabel": "Operations",
             "promptHint": "Optional comma-separated values from: list, view, new, edit. Defaults to all four."
           },
@@ -1482,7 +1540,14 @@
             "inputType": "text",
             "defaultValue": "",
             "promptLabel": "Link placement",
-            "promptHint": "Optional host:position override for the generated list-page link placement."
+            "promptHint": "Optional target override for the generated list-page link placement (format: host:position)."
+          },
+          "link-component-token": {
+            "required": false,
+            "inputType": "text",
+            "defaultValue": "",
+            "promptLabel": "Link component token",
+            "promptHint": "Optional component token override for the generated list-page link placement (example: local.main.ui.tab-link-item)."
           },
           "namespace": {
             "required": false,
@@ -1511,10 +1576,11 @@
           "generatorPrimarySubcommand": "crud",
           "generatorSubcommands": {
             "crud": {
+              "requiresShellWeb": true,
               "description": "Create CRUD pages at an explicit route root relative to src/pages/.",
               "longDescription": [
                 "CRUD generation follows the same page-placement model as `ui-generator page`.",
-                "That means the generated list page link uses the same nearest-parent-host inference, tab-link inference, and relative `props.to` inference as a normal generated page. If you want the detailed host behavior, read `jskit generate ui-generator page help`."
+                "That means the generated list page link uses the same nearest-parent-target inference, tab-link inference, and relative `props.to` inference as a normal generated page. If you want the detailed target behavior, read `jskit generate ui-generator page help`."
               ],
               "positionalArgs": [
                 {
@@ -1529,6 +1595,7 @@
                 "display-fields",
                 "id-param",
                 "link-placement",
+                "link-component-token",
                 "namespace",
                 "force"
               ],
@@ -1568,6 +1635,7 @@
               ]
             },
             "field": {
+              "requiresShellWeb": true,
               "entrypoint": "src/server/subcommands/addField.js",
               "export": "runGeneratorSubcommand"
             }
@@ -1588,7 +1656,7 @@
         "mutations": {
           "dependencies": {
             "runtime": {
-              "@jskit-ai/users-web": "0.1.47"
+              "@jskit-ai/users-web": "0.1.49"
             },
             "dev": {}
           },
@@ -1800,7 +1868,7 @@
               "file": "src/placement.js",
               "position": "bottom",
               "skipIfContains": "__JSKIT_UI_MENU_MARKER__",
-              "value": "\n// __JSKIT_UI_MENU_MARKER__\n{\n  addPlacement({\n    id: \"__JSKIT_UI_MENU_PLACEMENT_ID__\",\n    host: \"__JSKIT_UI_MENU_PLACEMENT_HOST__\",\n    position: \"__JSKIT_UI_MENU_PLACEMENT_POSITION__\",\n    surfaces: [\"__JSKIT_UI_SURFACE_ID__\"],\n    order: 155,\n    componentToken: \"__JSKIT_UI_MENU_COMPONENT_TOKEN__\",\n    props: {\n      label: \"__JSKIT_UI_MENU_LABEL__\",\n      surface: \"__JSKIT_UI_SURFACE_ID__\",\n      workspaceSuffix: \"__JSKIT_UI_MENU_WORKSPACE_SUFFIX__\",\n      nonWorkspaceSuffix: \"__JSKIT_UI_MENU_NON_WORKSPACE_SUFFIX__\",\n__JSKIT_UI_MENU_TO_PROP_LINE__    },\n    when: ({ auth }) => Boolean(auth?.authenticated)\n  });\n}\n",
+              "value": "\n// __JSKIT_UI_MENU_MARKER__\n{\n  addPlacement({\n    id: \"__JSKIT_UI_MENU_PLACEMENT_ID__\",\n    target: \"__JSKIT_UI_MENU_PLACEMENT_TARGET__\",\n    surfaces: [\"__JSKIT_UI_SURFACE_ID__\"],\n    order: 155,\n    componentToken: \"__JSKIT_UI_MENU_COMPONENT_TOKEN__\",\n    props: {\n      label: \"__JSKIT_UI_MENU_LABEL__\",\n      surface: \"__JSKIT_UI_SURFACE_ID__\",\n      workspaceSuffix: \"__JSKIT_UI_MENU_WORKSPACE_SUFFIX__\",\n      nonWorkspaceSuffix: \"__JSKIT_UI_MENU_NON_WORKSPACE_SUFFIX__\",\n__JSKIT_UI_MENU_TO_PROP_LINE__    },\n__JSKIT_UI_MENU_WHEN_LINE__  });\n}\n",
               "reason": "Append generated CRUD list-page placement.",
               "category": "crud-ui-generator",
               "id": "crud-ui-placement-menu",
@@ -1821,11 +1889,11 @@
     },
     {
       "packageId": "@jskit-ai/database-runtime",
-      "version": "0.1.32",
+      "version": "0.1.34",
       "descriptor": {
         "packageVersion": 1,
         "packageId": "@jskit-ai/database-runtime",
-        "version": "0.1.32",
+        "version": "0.1.34",
         "kind": "runtime",
         "dependsOn": [
           "@jskit-ai/kernel"
@@ -1882,7 +1950,7 @@
         "mutations": {
           "dependencies": {
             "runtime": {
-              "@jskit-ai/kernel": "0.1.32",
+              "@jskit-ai/kernel": "0.1.34",
               "dotenv": "^16.4.5",
               "knex": "^3.1.0"
             },
@@ -1917,11 +1985,11 @@
     },
     {
       "packageId": "@jskit-ai/database-runtime-mysql",
-      "version": "0.1.31",
+      "version": "0.1.33",
       "descriptor": {
         "packageVersion": 1,
         "packageId": "@jskit-ai/database-runtime-mysql",
-        "version": "0.1.31",
+        "version": "0.1.33",
         "kind": "runtime",
         "options": {
           "db-host": {
@@ -2011,7 +2079,7 @@
         "mutations": {
           "dependencies": {
             "runtime": {
-              "@jskit-ai/database-runtime": "0.1.32",
+              "@jskit-ai/database-runtime": "0.1.34",
               "mysql2": "^3.11.2"
             },
             "dev": {}
@@ -2082,11 +2150,11 @@
     },
     {
       "packageId": "@jskit-ai/database-runtime-postgres",
-      "version": "0.1.31",
+      "version": "0.1.33",
       "descriptor": {
         "packageVersion": 1,
         "packageId": "@jskit-ai/database-runtime-postgres",
-        "version": "0.1.31",
+        "version": "0.1.33",
         "kind": "runtime",
         "options": {
           "db-host": {
@@ -2176,7 +2244,7 @@
         "mutations": {
           "dependencies": {
             "runtime": {
-              "@jskit-ai/database-runtime": "0.1.32",
+              "@jskit-ai/database-runtime": "0.1.34",
               "pg": "^8.13.1"
             },
             "dev": {}
@@ -2247,11 +2315,11 @@
     },
     {
       "packageId": "@jskit-ai/http-runtime",
-      "version": "0.1.31",
+      "version": "0.1.33",
       "descriptor": {
         "packageVersion": 1,
         "packageId": "@jskit-ai/http-runtime",
-        "version": "0.1.31",
+        "version": "0.1.33",
         "kind": "runtime",
         "dependsOn": [],
         "capabilities": {
@@ -2317,7 +2385,7 @@
         "mutations": {
           "dependencies": {
             "runtime": {
-              "@jskit-ai/kernel": "0.1.32",
+              "@jskit-ai/kernel": "0.1.34",
               "@fastify/type-provider-typebox": "^6.1.0",
               "typebox": "^1.0.81"
             },
@@ -2333,11 +2401,11 @@
     },
     {
       "packageId": "@jskit-ai/realtime",
-      "version": "0.1.31",
+      "version": "0.1.33",
       "descriptor": {
         "packageVersion": 1,
         "packageId": "@jskit-ai/realtime",
-        "version": "0.1.31",
+        "version": "0.1.33",
         "kind": "runtime",
         "description": "Thin, generic realtime runtime wrappers for socket.io server and client.",
         "options": {
@@ -2417,8 +2485,7 @@
               "contributions": [
                 {
                   "id": "realtime.connection.indicator",
-                  "host": "shell-layout",
-                  "position": "top-right",
+                  "target": "shell-layout:top-right",
                   "surfaces": [
                     "*"
                   ],
@@ -2433,7 +2500,7 @@
         "mutations": {
           "dependencies": {
             "runtime": {
-              "@jskit-ai/kernel": "0.1.32",
+              "@jskit-ai/kernel": "0.1.34",
               "@socket.io/redis-adapter": "^8.3.0",
               "redis": "^5.8.2",
               "socket.io": "^4.8.3",
@@ -2471,7 +2538,7 @@
               "file": "src/placement.js",
               "position": "bottom",
               "skipIfContains": "id: \"realtime.connection.indicator\"",
-              "value": "\naddPlacement({\n  id: \"realtime.connection.indicator\",\n  host: \"shell-layout\",\n  position: \"top-right\",\n  surfaces: [\"*\"],\n  order: 950,\n  componentToken: \"realtime.web.connection.indicator\"\n});\n",
+              "value": "\naddPlacement({\n  id: \"realtime.connection.indicator\",\n  target: \"shell-layout:top-right\",\n  surfaces: [\"*\"],\n  order: 950,\n  componentToken: \"realtime.web.connection.indicator\"\n});\n",
               "reason": "Append realtime connection indicator placement into app-owned placement registry.",
               "category": "realtime-web",
               "id": "realtime-placement-indicator"
@@ -2482,11 +2549,11 @@
     },
     {
       "packageId": "@jskit-ai/shell-web",
-      "version": "0.1.31",
+      "version": "0.1.33",
       "descriptor": {
         "packageVersion": 1,
         "packageId": "@jskit-ai/shell-web",
-        "version": "0.1.31",
+        "version": "0.1.33",
         "kind": "runtime",
         "description": "Web shell layout runtime with outlet-based placement contributions.",
         "dependsOn": [],
@@ -2515,7 +2582,7 @@
             "surfaces": [
               {
                 "subpath": "./client",
-                "summary": "Exports shell layout/outlet/error-host components and ShellWebClientProvider."
+                "summary": "Exports shell layout/outlet/outlet-menu/error-host components and ShellWebClientProvider."
               },
               {
                 "subpath": "./client/placement",
@@ -2540,40 +2607,38 @@
             "placements": {
               "outlets": [
                 {
-                  "host": "shell-layout",
-                  "position": "top-left",
+                  "target": "shell-layout:top-left",
                   "surfaces": [
                     "*"
                   ],
                   "source": "src/client/components/ShellLayout.vue"
                 },
                 {
-                  "host": "shell-layout",
-                  "position": "top-right",
+                  "target": "shell-layout:top-right",
                   "surfaces": [
                     "*"
                   ],
                   "source": "src/client/components/ShellLayout.vue"
                 },
                 {
-                  "host": "shell-layout",
-                  "position": "primary-menu",
+                  "target": "shell-layout:primary-menu",
+                  "defaultLinkComponentToken": "local.main.ui.surface-aware-menu-link-item",
                   "surfaces": [
                     "*"
                   ],
                   "source": "src/client/components/ShellLayout.vue"
                 },
                 {
-                  "host": "shell-layout",
-                  "position": "secondary-menu",
+                  "target": "shell-layout:secondary-menu",
+                  "defaultLinkComponentToken": "local.main.ui.surface-aware-menu-link-item",
                   "surfaces": [
                     "*"
                   ],
                   "source": "src/client/components/ShellLayout.vue"
                 },
                 {
-                  "host": "home-settings",
-                  "position": "primary-menu",
+                  "target": "home-settings:primary-menu",
+                  "defaultLinkComponentToken": "local.main.ui.surface-aware-menu-link-item",
                   "surfaces": [
                     "home"
                   ],
@@ -2587,8 +2652,9 @@
         "mutations": {
           "dependencies": {
             "runtime": {
+              "@mdi/js": "^7.4.47",
               "@tanstack/vue-query": "^5.90.5",
-              "@jskit-ai/kernel": "0.1.32",
+              "@jskit-ai/kernel": "0.1.34",
               "vuetify": "^4.0.0"
             },
             "dev": {}
@@ -2601,11 +2667,74 @@
             }
           },
           "procfile": {},
-          "text": [],
+          "text": [
+            {
+              "op": "append-text",
+              "file": "packages/main/src/client/providers/MainClientProvider.js",
+              "position": "top",
+              "skipIfContains": "import MenuLinkItem from \"/src/components/menus/MenuLinkItem.vue\";",
+              "value": "import MenuLinkItem from \"/src/components/menus/MenuLinkItem.vue\";\n",
+              "reason": "Bind app-owned shell menu link-item scaffold into local main client provider imports.",
+              "category": "shell-web",
+              "id": "shell-web-main-client-provider-menu-link-item-import"
+            },
+            {
+              "op": "append-text",
+              "file": "packages/main/src/client/providers/MainClientProvider.js",
+              "position": "top",
+              "skipIfContains": "import SurfaceAwareMenuLinkItem from \"/src/components/menus/SurfaceAwareMenuLinkItem.vue\";",
+              "value": "import SurfaceAwareMenuLinkItem from \"/src/components/menus/SurfaceAwareMenuLinkItem.vue\";\n",
+              "reason": "Bind app-owned shell surface-aware menu link-item scaffold into local main client provider imports.",
+              "category": "shell-web",
+              "id": "shell-web-main-client-provider-surface-aware-menu-link-item-import"
+            },
+            {
+              "op": "append-text",
+              "file": "packages/main/src/client/providers/MainClientProvider.js",
+              "position": "top",
+              "skipIfContains": "import TabLinkItem from \"/src/components/menus/TabLinkItem.vue\";",
+              "value": "import TabLinkItem from \"/src/components/menus/TabLinkItem.vue\";\n",
+              "reason": "Bind app-owned shell tab link-item scaffold into local main client provider imports.",
+              "category": "shell-web",
+              "id": "shell-web-main-client-provider-tab-link-item-import"
+            },
+            {
+              "op": "append-text",
+              "file": "packages/main/src/client/providers/MainClientProvider.js",
+              "position": "bottom",
+              "skipIfContains": "registerMainClientComponent(\"local.main.ui.menu-link-item\", () => MenuLinkItem);",
+              "value": "\nregisterMainClientComponent(\"local.main.ui.menu-link-item\", () => MenuLinkItem);\n",
+              "reason": "Bind app-owned shell menu link-item token into local main client provider registry.",
+              "category": "shell-web",
+              "id": "shell-web-main-client-provider-menu-link-item-register"
+            },
+            {
+              "op": "append-text",
+              "file": "packages/main/src/client/providers/MainClientProvider.js",
+              "position": "bottom",
+              "skipIfContains": "registerMainClientComponent(\"local.main.ui.surface-aware-menu-link-item\", () => SurfaceAwareMenuLinkItem);",
+              "value": "\nregisterMainClientComponent(\"local.main.ui.surface-aware-menu-link-item\", () => SurfaceAwareMenuLinkItem);\n",
+              "reason": "Bind app-owned shell surface-aware menu link-item token into local main client provider registry.",
+              "category": "shell-web",
+              "id": "shell-web-main-client-provider-surface-aware-menu-link-item-register"
+            },
+            {
+              "op": "append-text",
+              "file": "packages/main/src/client/providers/MainClientProvider.js",
+              "position": "bottom",
+              "skipIfContains": "registerMainClientComponent(\"local.main.ui.tab-link-item\", () => TabLinkItem);",
+              "value": "\nregisterMainClientComponent(\"local.main.ui.tab-link-item\", () => TabLinkItem);\n",
+              "reason": "Bind app-owned shell tab link-item token into local main client provider registry.",
+              "category": "shell-web",
+              "id": "shell-web-main-client-provider-tab-link-item-register"
+            }
+          ],
           "files": [
             {
               "from": "templates/src/App.vue",
               "to": "src/App.vue",
+              "ownership": "app",
+              "expectedExistingFrom": "templates/expected-existing/src/App.vue",
               "reason": "Install full-width shell app root with shell-web error host and edge-to-edge layout.",
               "category": "shell-web",
               "id": "shell-web-app-root"
@@ -2613,13 +2742,39 @@
             {
               "from": "templates/src/components/ShellLayout.vue",
               "to": "src/components/ShellLayout.vue",
+              "ownership": "app",
               "reason": "Install app-owned shell layout component so apps can customize structure and slots.",
               "category": "shell-web",
               "id": "shell-web-component-shell-layout"
             },
+            {
+              "from": "templates/src/components/menus/MenuLinkItem.vue",
+              "to": "src/components/menus/MenuLinkItem.vue",
+              "ownership": "app",
+              "reason": "Install app-owned shell menu link-item scaffold for local placement customization.",
+              "category": "shell-web",
+              "id": "shell-web-component-menu-link-item"
+            },
+            {
+              "from": "templates/src/components/menus/SurfaceAwareMenuLinkItem.vue",
+              "to": "src/components/menus/SurfaceAwareMenuLinkItem.vue",
+              "ownership": "app",
+              "reason": "Install app-owned surface-aware shell menu link-item scaffold for local placement customization.",
+              "category": "shell-web",
+              "id": "shell-web-component-surface-aware-menu-link-item"
+            },
+            {
+              "from": "templates/src/components/menus/TabLinkItem.vue",
+              "to": "src/components/menus/TabLinkItem.vue",
+              "ownership": "app",
+              "reason": "Install app-owned shell tab link-item scaffold for local placement customization.",
+              "category": "shell-web",
+              "id": "shell-web-component-tab-link-item"
+            },
             {
               "from": "templates/src/error.js",
               "to": "src/error.js",
+              "ownership": "app",
               "reason": "Install app-owned error runtime policy and presenter config scaffold.",
               "category": "shell-web",
               "id": "shell-web-error-config"
@@ -2627,6 +2782,7 @@
             {
               "from": "templates/src/placement.js",
               "to": "src/placement.js",
+              "ownership": "app",
               "reason": "Install app-owned placement registry scaffold used by shell-web placement runtime.",
               "category": "shell-web",
               "id": "shell-web-placement-registry"
@@ -2635,6 +2791,8 @@
               "from": "templates/src/pages/home.vue",
               "toSurface": "home",
               "toSurfaceRoot": true,
+              "ownership": "app",
+              "expectedExistingFrom": "templates/expected-existing/src/pages/home.vue",
               "reason": "Install shell-driven home wrapper page.",
               "category": "shell-web",
               "id": "shell-web-page-home-wrapper"
@@ -2643,6 +2801,8 @@
               "from": "templates/src/pages/home/index.vue",
               "toSurface": "home",
               "toSurfacePath": "index.vue",
+              "ownership": "app",
+              "expectedExistingFrom": "templates/expected-existing/src/pages/home/index.vue",
               "reason": "Install shell-driven home surface starter page.",
               "category": "shell-web",
               "id": "shell-web-page-home"
@@ -2651,6 +2811,7 @@
               "from": "templates/src/pages/home/settings.vue",
               "toSurface": "home",
               "toSurfacePath": "settings.vue",
+              "ownership": "app",
               "reason": "Install shell-driven home settings shell route with section navigation.",
               "category": "shell-web",
               "id": "shell-web-page-home-settings-shell"
@@ -2659,7 +2820,8 @@
               "from": "templates/src/pages/home/settings/index.vue",
               "toSurface": "home",
               "toSurfacePath": "settings/index.vue",
-              "reason": "Install shell-driven home settings landing page scaffold.",
+              "ownership": "app",
+              "reason": "Install shell-driven home settings index stub scaffold for app-owned landing or redirect behavior.",
               "category": "shell-web",
               "id": "shell-web-page-home-settings"
             },
@@ -2667,6 +2829,8 @@
               "from": "templates/src/pages/console.vue",
               "toSurface": "console",
               "toSurfaceRoot": true,
+              "ownership": "app",
+              "expectedExistingFrom": "templates/expected-existing/src/pages/console.vue",
               "reason": "Install shell-driven console wrapper page.",
               "category": "shell-web",
               "id": "shell-web-page-console-wrapper"
@@ -2675,6 +2839,8 @@
               "from": "templates/src/pages/console/index.vue",
               "toSurface": "console",
               "toSurfacePath": "index.vue",
+              "ownership": "app",
+              "expectedExistingFrom": "templates/expected-existing/src/pages/console/index.vue",
               "reason": "Install shell-driven console page starter.",
               "category": "shell-web",
               "id": "shell-web-page-console"
@@ -2685,11 +2851,11 @@
     },
     {
       "packageId": "@jskit-ai/storage-runtime",
-      "version": "0.1.31",
+      "version": "0.1.33",
       "descriptor": {
         "packageVersion": 1,
         "packageId": "@jskit-ai/storage-runtime",
-        "version": "0.1.31",
+        "version": "0.1.33",
         "kind": "runtime",
         "dependsOn": [
           "@jskit-ai/kernel"
@@ -2738,7 +2904,7 @@
         "mutations": {
           "dependencies": {
             "runtime": {
-              "@jskit-ai/kernel": "0.1.32",
+              "@jskit-ai/kernel": "0.1.34",
               "unstorage": "^1.17.3"
             },
             "dev": {}
@@ -2754,11 +2920,11 @@
     },
     {
       "packageId": "@jskit-ai/ui-generator",
-      "version": "0.1.15",
+      "version": "0.1.17",
       "descriptor": {
         "packageVersion": 1,
         "packageId": "@jskit-ai/ui-generator",
-        "version": "0.1.15",
+        "version": "0.1.17",
         "kind": "generator",
         "description": "Create non-CRUD pages, reusable UI elements, and subpage hosts.",
         "options": {
@@ -2796,14 +2962,14 @@
             "inputType": "text",
             "defaultValue": "",
             "promptLabel": "Placement target",
-            "promptHint": "Optional host:position target for placed-element placement (defaults to shell-layout:top-right)."
+            "promptHint": "Optional target for placed-element placement (format: host:position, default: shell-layout:top-right)."
           },
           "link-placement": {
             "required": false,
             "inputType": "text",
             "defaultValue": "",
             "promptLabel": "Link placement",
-            "promptHint": "Optional host:position target for the generated page link placement."
+            "promptHint": "Optional target for the generated page link placement (format: host:position)."
           },
           "link-component-token": {
             "required": false,
@@ -2817,14 +2983,14 @@
             "inputType": "text",
             "defaultValue": "",
             "promptLabel": "Link to",
-            "promptHint": "Optional explicit props.to value for the generated page link placement (example: ./notes). If omitted for pages under a detected parent subpages host, it is inferred from the page path."
+            "promptHint": "Optional explicit props.to value for the generated page link placement (example: ./notes). If omitted for pages under a detected parent subpages target, it is inferred from the page path."
           },
           "target": {
             "required": false,
             "inputType": "text",
             "defaultValue": "",
             "promptLabel": "Outlet target",
-            "promptHint": "Used by add-subpages and outlet. Accepts host or host:position. If only host is given, position defaults to sub-pages."
+            "promptHint": "Used by add-subpages and outlet. Must be a target in host:position format."
           },
           "title": {
             "required": false,
@@ -2860,13 +3026,14 @@
           "generatorPrimarySubcommand": "page",
           "generatorSubcommands": {
             "page": {
+              "requiresShellWeb": true,
               "entrypoint": "src/server/subcommands/page.js",
               "export": "runGeneratorSubcommand",
               "description": "Create a route page at an explicit target file and add a link placement entry for it.",
               "longDescription": [
                 "This command always creates one route page file. By default, its page link is placed from the page path itself.",
-                "If an ancestor page has already been enhanced with sub-pages, JSKIT treats that ancestor as the real host. In that case the new page is linked into the nearest parent sub-pages outlet instead of the shell menu.",
-                "That means the generated link normally becomes a tab or child-page link under that ancestor host, and `props.to` is inferred relative to that host. If the host page is `index.vue`, child pages belong under `index/...` so the router keeps the parent page visible while the child route renders underneath it."
+                "If an ancestor page has already been enhanced with sub-pages, JSKIT treats that ancestor outlet as the real placement target. In that case the new page is linked into the nearest parent sub-pages outlet instead of the shell menu.",
+                "That means the generated link normally becomes a tab or child-page link under that ancestor target, and `props.to` is inferred relative to that target. If the outlet page is `index.vue`, child pages belong under `index/...` so the router keeps the parent page visible while the child route renders underneath it."
               ],
               "positionalArgs": [
                 {
@@ -2883,8 +3050,8 @@
                 "force"
               ],
               "notes": [
-                "If a nearest parent subpages host is found, placement, link component token, and props.to are inferred automatically.",
-                "If the parent host page is index.vue, child pages belong under index/...",
+                "If a nearest parent subpages target is found, placement, link component token, and props.to are inferred automatically.",
+                "If the parent target page is index.vue, child pages belong under index/...",
                 "If the target page file already exists, rerun with --force to overwrite it."
               ],
               "examples": [
@@ -2908,6 +3075,7 @@
               ]
             },
             "placed-element": {
+              "requiresShellWeb": true,
               "entrypoint": "src/server/subcommands/element.js",
               "export": "runGeneratorSubcommand",
               "description": "Create a Vue component file under the chosen component directory (default: src/components) and add a placement entry that renders it.",
@@ -2949,6 +3117,7 @@
               ]
             },
             "add-subpages": {
+              "requiresShellWeb": true,
               "entrypoint": "src/server/subcommands/addSubpages.js",
               "export": "runGeneratorSubcommand",
               "description": "Upgrade an existing page into a routed subpage host with SectionContainerShell, ShellOutlet, and RouterView.",
@@ -2967,7 +3136,7 @@
               ],
               "notes": [
                 "Use this when the page should render shared content plus child routes below it.",
-                "If the host page is index.vue, create child pages under index/..."
+                "If the outlet page is index.vue, create child pages under index/..."
               ],
               "examples": [
                 {
@@ -2993,13 +3162,14 @@
               ]
             },
             "outlet": {
+              "requiresShellWeb": true,
               "entrypoint": "src/server/subcommands/outlet.js",
               "export": "runGeneratorSubcommand",
               "description": "Inject a generic ShellOutlet block into an existing Vue page/component.",
               "longDescription": [
                 "A ShellOutlet creates a named placement target inside a Vue file. That target is what other parts of JSKIT render into later.",
-                "After an outlet exists, `jskit list-placements` will discover it and show it as `host:position`. That makes the target visible to humans and to generators that need a placement destination.",
-                "Commands that create placed UI, such as `ui-generator placed-element`, and commands that add page links can then target that outlet by writing placement entries that point at the same `host:position`."
+                "After an outlet exists, `jskit list-placements` will discover it and show its `target`. That makes the outlet visible to humans and to generators that need a placement destination.",
+                "Commands that create placed UI, such as `ui-generator placed-element`, and commands that add page links can then target that outlet by writing placement entries that point at the same target."
               ],
               "positionalArgs": [
                 {
@@ -3015,7 +3185,7 @@
                 "target"
               ],
               "notes": [
-                "Use --target host or --target host:position. If only host is given, position defaults to sub-pages."
+                "Use --target host:position."
               ],
               "examples": [
                 {
@@ -3023,7 +3193,7 @@
                   "lines": [
                     "npx jskit generate ui-generator outlet \\",
                     "  src/components/ContactSummaryCard.vue \\",
-                    "  --target contact-view"
+                    "  --target contact-view:sub-pages"
                   ]
                 },
                 {
@@ -3053,7 +3223,7 @@
         "mutations": {
           "dependencies": {
             "runtime": {
-              "@jskit-ai/users-web": "0.1.47"
+              "@jskit-ai/users-web": "0.1.49"
             },
             "dev": {}
           },
@@ -3068,11 +3238,11 @@
     },
     {
       "packageId": "@jskit-ai/uploads-image-web",
-      "version": "0.1.10",
+      "version": "0.1.12",
       "descriptor": {
         "packageVersion": 1,
         "packageId": "@jskit-ai/uploads-image-web",
-        "version": "0.1.10",
+        "version": "0.1.12",
         "kind": "runtime",
         "description": "Reusable client-side image upload runtime with pre-upload image editing.",
         "dependsOn": [
@@ -3136,7 +3306,7 @@
         "mutations": {
           "dependencies": {
             "runtime": {
-              "@jskit-ai/uploads-runtime": "0.1.10",
+              "@jskit-ai/uploads-runtime": "0.1.12",
               "@uppy/compressor": "^3.1.0",
               "@uppy/core": "^5.2.0",
               "@uppy/dashboard": "^5.1.1",
@@ -3156,11 +3326,11 @@
     },
     {
       "packageId": "@jskit-ai/uploads-runtime",
-      "version": "0.1.10",
+      "version": "0.1.12",
       "descriptor": {
         "packageVersion": 1,
         "packageId": "@jskit-ai/uploads-runtime",
-        "version": "0.1.10",
+        "version": "0.1.12",
         "kind": "runtime",
         "description": "Reusable upload runtime primitives for multipart parsing, policy validation, and blob storage.",
         "dependsOn": [
@@ -3230,7 +3400,7 @@
           "dependencies": {
             "runtime": {
               "@fastify/multipart": "^9.4.0",
-              "@jskit-ai/kernel": "0.1.32"
+              "@jskit-ai/kernel": "0.1.34"
             },
             "dev": {}
           },
@@ -3245,11 +3415,11 @@
     },
     {
       "packageId": "@jskit-ai/users-core",
-      "version": "0.1.42",
+      "version": "0.1.44",
       "descriptor": {
         "packageVersion": 1,
         "packageId": "@jskit-ai/users-core",
-        "version": "0.1.42",
+        "version": "0.1.44",
         "kind": "runtime",
         "description": "Users/account runtime plus HTTP routes for account and console features.",
         "dependsOn": [
@@ -3385,11 +3555,11 @@
         "mutations": {
           "dependencies": {
             "runtime": {
-              "@jskit-ai/auth-core": "0.1.31",
-              "@jskit-ai/database-runtime": "0.1.32",
-              "@jskit-ai/http-runtime": "0.1.31",
-              "@jskit-ai/kernel": "0.1.32",
-              "@jskit-ai/uploads-runtime": "0.1.10",
+              "@jskit-ai/auth-core": "0.1.33",
+              "@jskit-ai/database-runtime": "0.1.34",
+              "@jskit-ai/http-runtime": "0.1.33",
+              "@jskit-ai/kernel": "0.1.34",
+              "@jskit-ai/uploads-runtime": "0.1.12",
               "@fastify/type-provider-typebox": "^6.1.0",
               "typebox": "^1.0.81"
             },
@@ -3500,14 +3670,15 @@
     },
     {
       "packageId": "@jskit-ai/users-web",
-      "version": "0.1.47",
+      "version": "0.1.49",
       "descriptor": {
         "packageVersion": 1,
         "packageId": "@jskit-ai/users-web",
-        "version": "0.1.47",
+        "version": "0.1.49",
         "kind": "runtime",
-        "description": "Users web module: account/profile UI plus shared shell link components.",
+        "description": "Users web module: account/profile UI plus shared users web widgets.",
         "dependsOn": [
+          "@jskit-ai/auth-web",
           "@jskit-ai/http-runtime",
           "@jskit-ai/shell-web",
           "@jskit-ai/uploads-image-web",
@@ -3550,14 +3721,6 @@
                 "subpath": "./client/components/ProfileClientElement",
                 "summary": "Exports profile settings client element scaffold component."
               },
-              {
-                "subpath": "./client/components/ConsoleSettingsClientElement",
-                "summary": "Exports console settings landing-page client element."
-              },
-              {
-                "subpath": "./client/components/WorkspaceSettingsClientElement",
-                "summary": "Exports workspace settings client element."
-              },
               {
                 "subpath": "./client/composables/useAddEdit",
                 "summary": "Exports add/edit operation composable."
@@ -3598,9 +3761,8 @@
             "containerTokens": {
               "server": [],
               "client": [
-                "users.web.shell.menu-link-item",
-                "users.web.shell.surface-aware-menu-link-item",
                 "users.web.profile.menu.surface-switch-item",
+                "users.web.home.tools.widget",
                 "users.web.profile.element",
                 "users.web.bootstrap-placement.runtime"
               ]
@@ -3610,8 +3772,24 @@
             "placements": {
               "outlets": [
                 {
-                  "host": "console-settings",
-                  "position": "primary-menu",
+                  "target": "home-tools:primary-menu",
+                  "defaultLinkComponentToken": "local.main.ui.surface-aware-menu-link-item",
+                  "surfaces": [
+                    "home"
+                  ],
+                  "source": "src/client/components/UsersHomeToolsWidget.vue"
+                },
+                {
+                  "target": "workspace-tools:primary-menu",
+                  "defaultLinkComponentToken": "local.main.ui.surface-aware-menu-link-item",
+                  "surfaces": [
+                    "admin"
+                  ],
+                  "source": "src/client/components/UsersWorkspaceToolsWidget.vue"
+                },
+                {
+                  "target": "console-settings:primary-menu",
+                  "defaultLinkComponentToken": "local.main.ui.surface-aware-menu-link-item",
                   "surfaces": [
                     "console"
                   ],
@@ -3621,8 +3799,7 @@
               "contributions": [
                 {
                   "id": "users.profile.menu.surface-switch",
-                  "host": "auth-profile-menu",
-                  "position": "primary-menu",
+                  "target": "auth-profile-menu:primary-menu",
                   "surfaces": [
                     "*"
                   ],
@@ -3633,27 +3810,58 @@
                 },
                 {
                   "id": "users.profile.menu.settings",
-                  "host": "auth-profile-menu",
-                  "position": "primary-menu",
+                  "target": "auth-profile-menu:primary-menu",
                   "surfaces": [
                     "*"
                   ],
                   "order": 500,
-                  "componentToken": "users.web.shell.menu-link-item",
+                  "componentToken": "auth.web.profile.menu.link-item",
                   "when": "auth.authenticated === true",
                   "source": "mutations.text#users-web-profile-settings-placement"
                 },
+                {
+                  "id": "users.home.menu.home",
+                  "target": "shell-layout:primary-menu",
+                  "surfaces": [
+                    "*"
+                  ],
+                  "order": 50,
+                  "componentToken": "local.main.ui.surface-aware-menu-link-item",
+                  "when": "auth.authenticated === true",
+                  "source": "mutations.text#users-web-home-shell-menu-placement"
+                },
                 {
                   "id": "users.console.menu.settings",
-                  "host": "shell-layout",
-                  "position": "primary-menu",
+                  "target": "shell-layout:primary-menu",
                   "surfaces": [
                     "console"
                   ],
                   "order": 100,
-                  "componentToken": "users.web.shell.menu-link-item",
+                  "componentToken": "local.main.ui.menu-link-item",
                   "when": "auth.authenticated === true",
                   "source": "mutations.text#users-web-console-settings-placement"
+                },
+                {
+                  "id": "users.home.tools.widget",
+                  "target": "shell-layout:top-right",
+                  "surfaces": [
+                    "home"
+                  ],
+                  "order": 900,
+                  "componentToken": "users.web.home.tools.widget",
+                  "when": "auth.authenticated === true",
+                  "source": "mutations.text#users-web-home-tools-placement"
+                },
+                {
+                  "id": "users.home.menu.settings",
+                  "target": "home-tools:primary-menu",
+                  "surfaces": [
+                    "home"
+                  ],
+                  "order": 100,
+                  "componentToken": "local.main.ui.surface-aware-menu-link-item",
+                  "when": "auth.authenticated === true",
+                  "source": "mutations.text#users-web-home-tools-placement"
                 }
               ]
             }
@@ -3664,12 +3872,12 @@
             "runtime": {
               "@tanstack/vue-query": "5.92.12",
               "@mdi/js": "^7.4.47",
-              "@jskit-ai/http-runtime": "0.1.31",
-              "@jskit-ai/realtime": "0.1.31",
-              "@jskit-ai/kernel": "0.1.32",
-              "@jskit-ai/shell-web": "0.1.31",
-              "@jskit-ai/uploads-image-web": "0.1.10",
-              "@jskit-ai/users-core": "0.1.42",
+              "@jskit-ai/http-runtime": "0.1.33",
+              "@jskit-ai/realtime": "0.1.33",
+              "@jskit-ai/kernel": "0.1.34",
+              "@jskit-ai/shell-web": "0.1.33",
+              "@jskit-ai/uploads-image-web": "0.1.12",
+              "@jskit-ai/users-core": "0.1.44",
               "vuetify": "^4.0.0"
             },
             "dev": {}
@@ -3737,7 +3945,7 @@
               "from": "templates/src/pages/console/settings/index.vue",
               "toSurface": "console",
               "toSurfacePath": "settings/index.vue",
-              "reason": "Install console settings landing page scaffold for users-web console UI.",
+              "reason": "Install console settings index stub scaffold for app-owned landing or redirect behavior.",
               "category": "users-web",
               "id": "users-web-page-console-settings"
             }
@@ -3758,7 +3966,7 @@
               "file": "src/placement.js",
               "position": "bottom",
               "skipIfContains": "id: \"users.profile.menu.surface-switch\"",
-              "value": "\naddPlacement({\n  id: \"users.profile.menu.surface-switch\",\n  host: \"auth-profile-menu\",\n  position: \"primary-menu\",\n  surfaces: [\"*\"],\n  order: 100,\n  componentToken: \"users.web.profile.menu.surface-switch-item\",\n  when: ({ auth }) => Boolean(auth?.authenticated)\n});\n",
+              "value": "\naddPlacement({\n  id: \"users.profile.menu.surface-switch\",\n  target: \"auth-profile-menu:primary-menu\",\n  surfaces: [\"*\"],\n  order: 100,\n  componentToken: \"users.web.profile.menu.surface-switch-item\",\n  when: ({ auth }) => Boolean(auth?.authenticated)\n});\n",
               "reason": "Append users-web profile surface switch placement into app-owned placement registry.",
               "category": "users-web",
               "id": "users-web-profile-surface-switch-placement"
@@ -3768,20 +3976,40 @@
               "file": "src/placement.js",
               "position": "bottom",
               "skipIfContains": "id: \"users.profile.menu.settings\"",
-              "value": "\naddPlacement({\n  id: \"users.profile.menu.settings\",\n  host: \"auth-profile-menu\",\n  position: \"primary-menu\",\n  surfaces: [\"*\"],\n  order: 500,\n  componentToken: \"users.web.shell.menu-link-item\",\n  props: {\n    label: \"Settings\",\n    to: \"/account\"\n  },\n  when: ({ auth }) => Boolean(auth?.authenticated)\n});\n",
+              "value": "\naddPlacement({\n  id: \"users.profile.menu.settings\",\n  target: \"auth-profile-menu:primary-menu\",\n  surfaces: [\"*\"],\n  order: 500,\n  componentToken: \"auth.web.profile.menu.link-item\",\n  props: {\n    label: \"Settings\",\n    to: \"/account\"\n  },\n  when: ({ auth }) => Boolean(auth?.authenticated)\n});\n",
               "reason": "Append users-web profile settings menu placement into app-owned placement registry.",
               "category": "users-web",
               "id": "users-web-profile-settings-placement"
             },
+            {
+              "op": "append-text",
+              "file": "src/placement.js",
+              "position": "bottom",
+              "skipIfContains": "id: \"users.home.menu.home\"",
+              "value": "\naddPlacement({\n  id: \"users.home.menu.home\",\n  target: \"shell-layout:primary-menu\",\n  surfaces: [\"*\"],\n  order: 50,\n  componentToken: \"local.main.ui.surface-aware-menu-link-item\",\n  props: {\n    label: \"Home\",\n    surface: \"home\",\n    workspaceSuffix: \"/\",\n    nonWorkspaceSuffix: \"/\",\n    exact: true\n  },\n  when: ({ auth }) => Boolean(auth?.authenticated)\n});\n",
+              "reason": "Append users-web home shell menu placement into app-owned placement registry.",
+              "category": "users-web",
+              "id": "users-web-home-shell-menu-placement"
+            },
             {
               "op": "append-text",
               "file": "src/placement.js",
               "position": "bottom",
               "skipIfContains": "id: \"users.console.menu.settings\"",
-              "value": "\naddPlacement({\n  id: \"users.console.menu.settings\",\n  host: \"shell-layout\",\n  position: \"primary-menu\",\n  surfaces: [\"console\"],\n  order: 100,\n  componentToken: \"users.web.shell.menu-link-item\",\n  props: {\n    label: \"Settings\",\n    to: \"/console/settings\",\n    icon: \"mdi-cog-outline\"\n  },\n  when: ({ auth }) => Boolean(auth?.authenticated)\n});\n",
+              "value": "\naddPlacement({\n  id: \"users.console.menu.settings\",\n  target: \"shell-layout:primary-menu\",\n  surfaces: [\"console\"],\n  order: 100,\n  componentToken: \"local.main.ui.menu-link-item\",\n  props: {\n    label: \"Settings\",\n    to: \"/console/settings\",\n    icon: \"mdi-cog-outline\"\n  },\n  when: ({ auth }) => Boolean(auth?.authenticated)\n});\n",
               "reason": "Append users-web console settings menu placement into app-owned placement registry.",
               "category": "users-web",
               "id": "users-web-console-settings-placement"
+            },
+            {
+              "op": "append-text",
+              "file": "src/placement.js",
+              "position": "bottom",
+              "skipIfContains": "id: \"users.home.tools.widget\"",
+              "value": "\naddPlacement({\n  id: \"users.home.tools.widget\",\n  target: \"shell-layout:top-right\",\n  surfaces: [\"home\"],\n  order: 900,\n  componentToken: \"users.web.home.tools.widget\",\n  when: ({ auth }) => Boolean(auth?.authenticated)\n});\n\naddPlacement({\n  id: \"users.home.menu.settings\",\n  target: \"home-tools:primary-menu\",\n  surfaces: [\"home\"],\n  order: 100,\n  componentToken: \"local.main.ui.surface-aware-menu-link-item\",\n  props: {\n    label: \"Settings\",\n    surface: \"home\",\n    workspaceSuffix: \"/settings\",\n    nonWorkspaceSuffix: \"/settings\"\n  },\n  when: ({ auth }) => Boolean(auth?.authenticated)\n});\n",
+              "reason": "Append users-web home tools widget and settings menu placements into app-owned placement registry.",
+              "category": "users-web",
+              "id": "users-web-home-tools-placement"
             }
           ]
         }
@@ -3789,11 +4017,11 @@
     },
     {
       "packageId": "@jskit-ai/workspaces-core",
-      "version": "0.1.8",
+      "version": "0.1.10",
       "descriptor": {
         "packageVersion": 1,
         "packageId": "@jskit-ai/workspaces-core",
-        "version": "0.1.8",
+        "version": "0.1.10",
         "kind": "runtime",
         "description": "Workspace tenancy runtime plus HTTP routes, role catalog, and workspace config scaffolding.",
         "dependsOn": [
@@ -3902,7 +4130,7 @@
         "mutations": {
           "dependencies": {
             "runtime": {
-              "@jskit-ai/users-core": "0.1.42"
+              "@jskit-ai/users-core": "0.1.44"
             },
             "dev": {}
           },
@@ -4031,7 +4259,7 @@
               "file": "config/public.js",
               "position": "bottom",
               "skipIfContains": "config.workspaceSwitching =",
-              "value": "\nconfig.workspaceSwitching = true;\nconfig.workspaceInvitations = {\n  enabled: true,\n  allowInPersonalMode: true\n};\nconfig.assistantEnabled = false;\nconfig.assistantRequiredPermission = \"\";\nconfig.socialEnabled = false;\nconfig.socialFederationEnabled = false;\n",
+              "value": "\nconfig.workspaceSwitching = true;\nconfig.workspaceInvitations = {\n  enabled: true,\n  allowInPersonalMode: true\n};\n",
               "reason": "Append default workspace feature toggles into app-owned config.",
               "category": "workspaces-core",
               "id": "users-core-public-config"
@@ -4092,11 +4320,11 @@
     },
     {
       "packageId": "@jskit-ai/workspaces-web",
-      "version": "0.1.8",
+      "version": "0.1.10",
       "descriptor": {
         "packageVersion": 1,
         "packageId": "@jskit-ai/workspaces-web",
-        "version": "0.1.8",
+        "version": "0.1.10",
         "kind": "runtime",
         "description": "Workspace web module: workspace selector, tools widget, workspace surfaces, and members/settings UI.",
         "dependsOn": [
@@ -4140,8 +4368,7 @@
                 "users.web.workspace.tools.widget",
                 "users.web.workspace-settings.menu-item",
                 "users.web.workspace-members.menu-item",
-                "users.web.members-admin.element",
-                "users.web.workspace-settings.element"
+                "users.web.members-admin.element"
               ]
             }
           },
@@ -4149,8 +4376,8 @@
             "placements": {
               "outlets": [
                 {
-                  "host": "admin-settings",
-                  "position": "primary-menu",
+                  "target": "admin-settings:primary-menu",
+                  "defaultLinkComponentToken": "local.main.ui.surface-aware-menu-link-item",
                   "surfaces": [
                     "admin"
                   ],
@@ -4160,8 +4387,7 @@
               "contributions": [
                 {
                   "id": "users.workspace.selector",
-                  "host": "shell-layout",
-                  "position": "top-left",
+                  "target": "shell-layout:top-left",
                   "surfaces": [
                     "*"
                   ],
@@ -4172,8 +4398,7 @@
                 },
                 {
                   "id": "users.account.invites.cue",
-                  "host": "shell-layout",
-                  "position": "top-right",
+                  "target": "shell-layout:top-right",
                   "surfaces": [
                     "*"
                   ],
@@ -4184,8 +4409,7 @@
                 },
                 {
                   "id": "users.workspace.tools.widget",
-                  "host": "shell-layout",
-                  "position": "top-right",
+                  "target": "shell-layout:top-right",
                   "surfaces": [
                     "admin"
                   ],
@@ -4195,8 +4419,7 @@
                 },
                 {
                   "id": "users.workspace.menu.workspace-settings",
-                  "host": "workspace-tools",
-                  "position": "primary-menu",
+                  "target": "workspace-tools:primary-menu",
                   "surfaces": [
                     "admin"
                   ],
@@ -4206,25 +4429,13 @@
                 },
                 {
                   "id": "users.workspace.menu.members",
-                  "host": "workspace-tools",
-                  "position": "primary-menu",
+                  "target": "workspace-tools:primary-menu",
                   "surfaces": [
                     "admin"
                   ],
                   "order": 200,
                   "componentToken": "users.web.workspace-members.menu-item",
                   "source": "mutations.text#users-web-placement-block"
-                },
-                {
-                  "id": "users.workspace.settings.general",
-                  "host": "admin-settings",
-                  "position": "primary-menu",
-                  "surfaces": [
-                    "admin"
-                  ],
-                  "order": 100,
-                  "componentToken": "users.web.shell.surface-aware-menu-link-item",
-                  "source": "mutations.text#users-web-workspace-settings-general-placement"
                 }
               ]
             }
@@ -4233,8 +4444,8 @@
         "mutations": {
           "dependencies": {
             "runtime": {
-              "@jskit-ai/workspaces-core": "0.1.8",
-              "@jskit-ai/users-web": "0.1.47"
+              "@jskit-ai/workspaces-core": "0.1.10",
+              "@jskit-ai/users-web": "0.1.49"
             },
             "dev": {}
           },
@@ -4377,7 +4588,7 @@
               "from": "templates/src/pages/admin/workspace/settings/index.vue",
               "toSurface": "admin",
               "toSurfacePath": "workspace/settings/index.vue",
-              "reason": "Install workspace settings landing page scaffold for workspaces-web workspace admin UI.",
+              "reason": "Install workspace settings index stub scaffold for app-owned landing or redirect behavior.",
               "category": "workspaces-web",
               "id": "users-web-page-admin-workspace-settings",
               "when": {
@@ -4395,7 +4606,7 @@
               "file": "src/placement.js",
               "position": "bottom",
               "skipIfContains": "id: \"users.workspace.selector\"",
-              "value": "\naddPlacement({\n  id: \"users.workspace.selector\",\n  host: \"shell-layout\",\n  position: \"top-left\",\n  surfaces: [\"*\"],\n  order: 200,\n  componentToken: \"users.web.workspace.selector\",\n  props: {\n    allowOnNonWorkspaceSurface: true,\n    targetSurfaceId: \"app\"\n  },\n  when: ({ auth }) => {\n    return Boolean(auth?.authenticated);\n  }\n});\n\naddPlacement({\n  id: \"users.account.invites.cue\",\n  host: \"shell-layout\",\n  position: \"top-right\",\n  surfaces: [\"*\"],\n  order: 850,\n  componentToken: \"local.main.account.pending-invites.cue\",\n  when: ({ auth }) => Boolean(auth?.authenticated)\n});\n\naddPlacement({\n  id: \"users.workspace.tools.widget\",\n  host: \"shell-layout\",\n  position: \"top-right\",\n  surfaces: [\"admin\"],\n  order: 900,\n  componentToken: \"users.web.workspace.tools.widget\"\n});\n\naddPlacement({\n  id: \"users.workspace.menu.workspace-settings\",\n  host: \"workspace-tools\",\n  position: \"primary-menu\",\n  surfaces: [\"admin\"],\n  order: 100,\n  componentToken: \"users.web.workspace-settings.menu-item\"\n});\n\naddPlacement({\n  id: \"users.workspace.menu.members\",\n  host: \"workspace-tools\",\n  position: \"primary-menu\",\n  surfaces: [\"admin\"],\n  order: 200,\n  componentToken: \"users.web.workspace-members.menu-item\"\n});\n",
+              "value": "\naddPlacement({\n  id: \"users.workspace.selector\",\n  target: \"shell-layout:top-left\",\n  surfaces: [\"*\"],\n  order: 200,\n  componentToken: \"users.web.workspace.selector\",\n  props: {\n    allowOnNonWorkspaceSurface: true,\n    targetSurfaceId: \"app\"\n  },\n  when: ({ auth }) => {\n    return Boolean(auth?.authenticated);\n  }\n});\n\naddPlacement({\n  id: \"users.account.invites.cue\",\n  target: \"shell-layout:top-right\",\n  surfaces: [\"*\"],\n  order: 850,\n  componentToken: \"local.main.account.pending-invites.cue\",\n  when: ({ auth }) => Boolean(auth?.authenticated)\n});\n\naddPlacement({\n  id: \"users.workspace.tools.widget\",\n  target: \"shell-layout:top-right\",\n  surfaces: [\"admin\"],\n  order: 900,\n  componentToken: \"users.web.workspace.tools.widget\"\n});\n\naddPlacement({\n  id: \"users.workspace.menu.workspace-settings\",\n  target: \"workspace-tools:primary-menu\",\n  surfaces: [\"admin\"],\n  order: 100,\n  componentToken: \"users.web.workspace-settings.menu-item\"\n});\n\naddPlacement({\n  id: \"users.workspace.menu.members\",\n  target: \"workspace-tools:primary-menu\",\n  surfaces: [\"admin\"],\n  order: 200,\n  componentToken: \"users.web.workspace-members.menu-item\"\n});\n",
               "reason": "Append workspace placement entries into app-owned placement registry.",
               "category": "workspaces-web",
               "id": "users-web-placement-block",
@@ -4426,23 +4637,6 @@
               "reason": "Bind app-owned account pending invites cue component token into local main client provider registry.",
               "category": "workspaces-web",
               "id": "users-web-main-client-provider-account-invites-register"
-            },
-            {
-              "op": "append-text",
-              "file": "src/placement.js",
-              "position": "bottom",
-              "skipIfContains": "id: \"users.workspace.settings.general\"",
-              "value": "\naddPlacement({\n  id: \"users.workspace.settings.general\",\n  host: \"admin-settings\",\n  position: \"primary-menu\",\n  surfaces: [\"admin\"],\n  order: 100,\n  componentToken: \"users.web.shell.surface-aware-menu-link-item\",\n  props: {\n    label: \"General\",\n    surface: \"admin\",\n    workspaceSuffix: \"/workspace/settings\",\n    nonWorkspaceSuffix: \"/workspace/settings\"\n  },\n  when: ({ auth }) => Boolean(auth?.authenticated)\n});\n",
-              "reason": "Append workspace settings general-page placement into app-owned placement registry.",
-              "category": "workspaces-web",
-              "id": "users-web-workspace-settings-general-placement",
-              "when": {
-                "config": "tenancyMode",
-                "in": [
-                  "personal",
-                  "workspaces"
-                ]
-              }
             }
           ]
         }