@jskit-ai/agent-docs 0.1.291 → 0.1.293

package/skills/jskit/references/patterns/app/shell-foundation/example/package.json

@@ -34,24 +34,24 @@
   "dependencies": {
     "@local/main": "0.1.0",
     "@fastify/static": "^10.1.3",
-    "@jskit-ai/kernel": "0.2.17",
+    "@jskit-ai/kernel": "0.2.18",
     "@jskit-ai/material-web": "0.1.5",
     "@tanstack/vue-query": "^5.101.0",
     "fastify": "^5.12.7",
     "pino": "^10.3.1",
-    "json-rest-schema": "^1.0.17",
+    "json-rest-schema": "^1.0.20",
     "pinia": "^4.0.3",
     "vue": "^3.5.44",
     "vue-router": "^5.3.1",
     "vuetify": "^4.3.0",
-    "@jskit-ai/http-runtime": "0.2.17",
-    "@jskit-ai/shell-web": "0.2.21",
+    "@jskit-ai/http-runtime": "0.2.18",
+    "@jskit-ai/shell-web": "0.2.22",
     "@fastify/fast-json-stringify-compiler": "^5.1.0",
     "@vue/devtools-api": "^8.2.1"
   },
   "devDependencies": {
-    "@jskit-ai/config-eslint": "0.1.248",
-    "@jskit-ai/jskit-catalog": "0.2.43",
+    "@jskit-ai/config-eslint": "0.1.249",
+    "@jskit-ai/jskit-catalog": "0.2.45",
     "@playwright/test": "1.61.1",
     "@vitejs/plugin-vue": "^6.0.7",
     "eslint": "^10.8.0",

package/skills/jskit/references/patterns/app/shell-foundation/example/packages/main/package.json

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

package/skills/jskit/references/patterns/auth/accounts-hub/example/package.json

@@ -2,8 +2,8 @@
   "private": true,
   "type": "module",
   "dependencies": {
-    "@jskit-ai/database-runtime": "0.1.266",
-    "@jskit-ai/database-runtime-mysql": "0.1.264",
-    "@jskit-ai/oidc-issuer-core": "0.1.25"
+    "@jskit-ai/database-runtime": "0.1.267",
+    "@jskit-ai/database-runtime-mysql": "0.1.265",
+    "@jskit-ai/oidc-issuer-core": "0.1.26"
   }
 }

package/skills/jskit/references/patterns/auth/oidc-sign-in/example/package.json

@@ -2,7 +2,7 @@
   "private": true,
   "type": "module",
   "dependencies": {
-    "@jskit-ai/auth-provider-oidc-core": "0.2.25",
-    "@jskit-ai/auth-web": "0.2.23"
+    "@jskit-ai/auth-provider-oidc-core": "0.2.26",
+    "@jskit-ai/auth-web": "0.2.24"
   }
 }

package/skills/jskit/references/patterns/auth/supabase-auth/example/package.json

@@ -2,6 +2,6 @@
   "private": true,
   "type": "module",
   "dependencies": {
-    "@jskit-ai/auth-provider-supabase-core": "0.2.19"
+    "@jskit-ai/auth-provider-supabase-core": "0.2.20"
   }
 }

package/skills/jskit/references/patterns/connectors/calendar-cli/example/package.json

@@ -7,10 +7,10 @@
     "db:migrate:status": "knex --knexfile ./knexfile.js migrate:list"
   },
   "dependencies": {
-    "@jskit-ai/connectors-core": "0.2.21",
-    "@jskit-ai/connector-google-calendar": "0.2.21",
-    "@jskit-ai/database-runtime": "0.1.266",
-    "@jskit-ai/database-runtime-mysql": "0.1.264",
+    "@jskit-ai/connectors-core": "0.2.23",
+    "@jskit-ai/connector-google-calendar": "0.2.23",
+    "@jskit-ai/database-runtime": "0.1.267",
+    "@jskit-ai/database-runtime-mysql": "0.1.265",
     "knex": "^3.1.0"
   }
 }

package/skills/jskit/references/patterns/crud/crud-feature-package/example/packages/books/package.json

@@ -9,9 +9,9 @@
     "./shared": "./src/shared/index.js"
   },
   "dependencies": {
-    "@jskit-ai/crud-core": "0.2.21",
-    "@jskit-ai/resource-core": "0.1.208",
-    "@jskit-ai/resource-crud-core": "0.1.208"
+    "@jskit-ai/crud-core": "0.2.23",
+    "@jskit-ai/resource-core": "0.1.209",
+    "@jskit-ai/resource-crud-core": "0.1.209"
   },
   "jskit": {
     "kind": "runtime",

package/skills/jskit/references/patterns/crud/crud-screen-set/PATTERN.md

@@ -143,7 +143,9 @@ arrive. `SelectField` hides an unresolved value while `loading` is true, shows
 "Unavailable option" once the options settle, and remembers titles it has seen
 so a narrowing search does not blank a chosen value. Display never changes the
 stored value. `searchable` renders an autocomplete; other props and slots pass
-through to Vuetify.
+through to Vuetify. The lint rule `jskit/selection-field` reports a raw
+selection whose items are not fixed, and a `SelectField` over loaded items
+without `loading`.
 
 ```vue
 <CrudAddEditScreen :screen="screen" v-bind="lookups">

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

@@ -9,7 +9,7 @@
     "test": "jskit test --databases"
   },
   "dependencies": {
-    "@jskit-ai/database-runtime": "0.1.266",
-    "@jskit-ai/database-runtime-mysql": "0.1.264"
+    "@jskit-ai/database-runtime": "0.1.267",
+    "@jskit-ai/database-runtime-mysql": "0.1.265"
   }
 }

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

@@ -9,7 +9,7 @@
     "test": "jskit test --databases"
   },
   "dependencies": {
-    "@jskit-ai/database-runtime": "0.1.266",
-    "@jskit-ai/database-runtime-postgres": "0.1.263"
+    "@jskit-ai/database-runtime": "0.1.267",
+    "@jskit-ai/database-runtime-postgres": "0.1.264"
   }
 }

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

@@ -2,7 +2,7 @@
   "private": true,
   "type": "module",
   "dependencies": {
-    "@jskit-ai/realtime": "0.2.24",
-    "@jskit-ai/shell-web": "0.2.21"
+    "@jskit-ai/realtime": "0.2.25",
+    "@jskit-ai/shell-web": "0.2.22"
   }
 }

package/skills/jskit/references/patterns/server/feature-package/example/booking-engine/package.json

@@ -5,8 +5,8 @@
   "private": true,
   "type": "module",
   "dependencies": {
-    "@jskit-ai/kernel": "0.2.17",
-    "json-rest-schema": "^1.0.17"
+    "@jskit-ai/kernel": "0.2.18",
+    "json-rest-schema": "^1.0.20"
   },
   "exports": {
     "./server/actions": "./src/server/bookingEngineActions.js",

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

@@ -15,6 +15,7 @@ const preferences = props.runtime.preferences;
       <v-form @submit.prevent="preferences.submit" novalidate>
         <v-row>
           <v-col cols="12" md="4">
+            <!-- readable-check: allow selection-field - data: the account settings runtime holds these as fixed lists, so nothing loads -->
             <v-select
               v-model="preferences.form.theme"
               label="Theme"
@@ -29,6 +30,7 @@ const preferences = props.runtime.preferences;
           </v-col>
 
           <v-col cols="12" md="4">
+            <!-- readable-check: allow selection-field - data: the account settings runtime holds these as fixed lists, so nothing loads -->
             <v-select
               v-model="preferences.form.locale"
               label="Language / locale"
@@ -43,6 +45,7 @@ const preferences = props.runtime.preferences;
           </v-col>
 
           <v-col cols="12" md="4">
+            <!-- readable-check: allow selection-field - data: the account settings runtime holds these as fixed lists, so nothing loads -->
             <v-select
               v-model="preferences.form.timeZone"
               label="Time zone"
@@ -55,6 +58,7 @@ const preferences = props.runtime.preferences;
           </v-col>
 
           <v-col cols="12" md="4">
+            <!-- readable-check: allow selection-field - data: the account settings runtime holds these as fixed lists, so nothing loads -->
             <v-select
               v-model="preferences.form.dateFormat"
               label="Date format"
@@ -69,6 +73,7 @@ const preferences = props.runtime.preferences;
           </v-col>
 
           <v-col cols="12" md="4">
+            <!-- readable-check: allow selection-field - data: the account settings runtime holds these as fixed lists, so nothing loads -->
             <v-select
               v-model="preferences.form.numberFormat"
               label="Number format"
@@ -83,6 +88,7 @@ const preferences = props.runtime.preferences;
           </v-col>
 
           <v-col cols="12" md="4">
+            <!-- readable-check: allow selection-field - data: the account settings runtime holds these as fixed lists, so nothing loads -->
             <v-select
               v-model="preferences.form.currencyCode"
               label="Currency"
@@ -95,6 +101,7 @@ const preferences = props.runtime.preferences;
           </v-col>
 
           <v-col cols="12" md="4">
+            <!-- readable-check: allow selection-field - data: the account settings runtime holds these as fixed lists, so nothing loads -->
             <v-select
               v-model.number="preferences.form.avatarSize"
               label="Avatar size"

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

@@ -10,9 +10,9 @@
     "./shared": "./src/shared/index.js"
   },
   "dependencies": {
-    "@jskit-ai/crud-core": "0.2.21",
-    "@jskit-ai/resource-crud-core": "0.1.208",
-    "@jskit-ai/users-core": "0.2.22"
+    "@jskit-ai/crud-core": "0.2.23",
+    "@jskit-ai/resource-crud-core": "0.1.209",
+    "@jskit-ai/users-core": "0.2.24"
   },
   "jskit": {
     "kind": "runtime",

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

@@ -10,14 +10,14 @@
     "./shared": "./src/shared/index.js"
   },
   "dependencies": {
-    "@jskit-ai/crud-core": "0.2.21",
-    "@jskit-ai/resource-crud-core": "0.1.208",
-    "@jskit-ai/users-core": "0.2.22",
-    "@jskit-ai/workspaces-core": "0.2.22"
+    "@jskit-ai/crud-core": "0.2.23",
+    "@jskit-ai/resource-crud-core": "0.1.209",
+    "@jskit-ai/users-core": "0.2.24",
+    "@jskit-ai/workspaces-core": "0.2.24"
   },
   "peerDependencies": {
-    "@jskit-ai/kernel": "0.2.17",
-    "@jskit-ai/resource-runtime": "0.2.18"
+    "@jskit-ai/kernel": "0.2.18",
+    "@jskit-ai/resource-runtime": "0.2.20"
   },
   "jskit": {
     "kind": "runtime",

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

@@ -74,6 +74,15 @@ external effects out of it. Without the capability, acceptance activates the
 membership only. Allow ordinary invitations; reject stale, revoked, conflicting
 or unexpectedly missing application associations.
 
+Provide the optional `workspaces.workspace-created-participant` capability the
+same way to write application records for every new workspace. The
+`workspace.workspaces.create` action and personal workspace provisioning invoke
+`fn({ workspace, owner }, txOptions)` after writing the workspace, its owner's
+membership and its settings, in the creation's uncommitted transaction (the
+caller's when it passes one). Pass `txOptions` on and propagate failures: a
+failure rolls the whole creation back. An existing personal workspace does not
+call it.
+
 Call `members.prepareInvite(workspace, actor, payload, txOptions)` inside
 `repositories.workspaceInvites.withTransaction(options, async (txOptions) => …)`
 or another resource handle's `withTransaction`. It returns

package/skills/jskit/references/sanity-checks.md

@@ -116,6 +116,10 @@ expects the relationship id or an unselected field never gets it.
   once](typed-features.md#test-databases-are-prepared-once),
   [integration test
   databases](database-layer.md#integration-test-databases)).
+- A component's content and states are checked in a Vitest component test;
+  a browser check is an assertion in the Playwright spec that already reaches
+  that screen. Every Playwright run ends with its 10 slowest tests: compare a
+  new test's time, and the suite's, before and after.
 
 ### Inputs and access
 

package/skills/jskit/references/typed-features.md

@@ -76,6 +76,31 @@ setup: ({ resources }) => ({ invoices: { list: (options) => resources.invoices.q
 actions: ({ invoices }) => [{ id: "invoices.list", execute: () => invoices.list() }]
 ```
 
+### Package manifest
+
+**A package's manifest, `jskit.capabilities` in its `package.json`, lists
+exactly what its features provide, and every capability they require beyond
+the kernel's own (`runtime.actions`, `runtime.events`, `runtime.http`,
+`runtime.bootstrap`) and those the package provides itself.** Optional
+capabilities are not required. A requirement no feature has stays only when
+the package needs it at install time, such as the database its migrations
+need.
+
+Why: start-up resolves every package's requirements from the manifests, and
+refuses a manifest that disagrees with the package's features. Plain
+`jskit check` loads each application package's features (the server providers
+`jskit.runtime.server.providers` declares) and reports the drift before that
+(`manifest/capabilities`), each capability to add or remove; it lists the
+requirements no feature has for review.
+
+```jsonc
+// good: BooksFeature provides app.books and requires crud.contracts and runtime.actions
+"capabilities": { "provides": ["app.books"], "requires": ["crud.contracts"] }
+
+// bad: app.books missing from provides, crud.contracts from requires
+"capabilities": { "provides": ["app.book"], "requires": [] }
+```
+
 ### Capability types
 
 **Each provided token has one `@typedef` in its package's `src/server/types.js`,
@@ -691,6 +716,11 @@ way (is this user an operator) is a member of its owner's capability.**
   meaning of 0 and false before replacing a copy.
 - A helper two packages of an application use lives in its shared package,
   never inside one of them.
+- A component's closure over its own state is not a helper: a function of at
+  most two statements in `<script setup>` whose every outside name is a
+  binding `<script setup>` declares (not an import or a global). Two pages
+  that reload their own resources the same way keep their own `reload()`;
+  sharing it would take a module that receives each page's state.
 
 Why: the kernel's helpers fix one meaning of empty, and a copy brings its own.
 
@@ -1170,8 +1200,9 @@ Why: a comment that narrates history is wrong the day after it is written.
 
 `npm run lint` runs ESLint with `@jskit-ai/config-eslint`, and `npm run
 verify` runs `jskit check` (the package graph, navigation, [data
-access](data-access.md#exceptions) and [test
-runs](#test-run-rules)), lint, the tests and the build. The foundations'
+access](data-access.md#exceptions), [test
+runs](#test-run-rules) and [package manifests](#package-manifest)), lint, the
+tests and the build. The foundations'
 `eslint.config.mjs` already holds a new
 application's code to every check: