@jskit-ai/agent-docs 0.1.292 → 0.1.293

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.22",
-    "@jskit-ai/resource-crud-core": "0.1.208",
-    "@jskit-ai/users-core": "0.2.23",
-    "@jskit-ai/workspaces-core": "0.2.23"
+    "@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.19"
+    "@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/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: