@jskit-ai/agent-docs 0.1.206 → 0.1.207

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 (28) hide show
  1. package/guide/agent/app-extras/assistant-conversation.md +51 -2
  2. package/guide/agent/framework/crud-operations.md +73 -0
  3. package/package.json +1 -1
  4. package/patterns/feature-package/example/booking-engine/package.json +1 -1
  5. package/patterns/minimal-foundation/example/package.json +4 -4
  6. package/patterns/shell-foundation/example/package.json +5 -5
  7. package/patterns/shell-foundation/example/packages/main/package.json +1 -1
  8. package/patterns/ui-testing.md +7 -0
  9. package/reference/autogen/PATTERN_INDEX.md +35 -35
  10. package/reference/autogen/packages/assistant-core.md +1 -1
  11. package/reference/autogen/packages/assistant-voice-sherpa.md +1 -1
  12. package/skills/jskit/SKILL.md +9 -0
  13. package/skills/jskit/references/crud-operations.md +73 -0
  14. package/skills/jskit/references/pattern-index.md +35 -35
  15. package/skills/jskit/references/patterns/app/minimal-foundation/example/package.json +4 -4
  16. package/skills/jskit/references/patterns/app/shell-foundation/example/package.json +5 -5
  17. package/skills/jskit/references/patterns/app/shell-foundation/example/packages/main/package.json +1 -1
  18. package/skills/jskit/references/patterns/auth/supabase-auth/example/package.json +1 -1
  19. package/skills/jskit/references/patterns/connectors/calendar-cli/example/package.json +4 -4
  20. package/skills/jskit/references/patterns/crud/crud-screen-set/PATTERN.md +15 -0
  21. package/skills/jskit/references/patterns/crud/json-api-resource-package/PATTERN.md +5 -0
  22. package/skills/jskit/references/patterns/crud/json-api-resource-package/example/packages/books/package.json +2 -2
  23. package/skills/jskit/references/patterns/database/mysql-application/example/package.json +1 -1
  24. package/skills/jskit/references/patterns/database/postgres-application/example/package.json +1 -1
  25. package/skills/jskit/references/patterns/realtime/realtime-application/example/package.json +2 -2
  26. package/skills/jskit/references/patterns/server/feature-package/example/booking-engine/package.json +1 -1
  27. package/skills/jskit/references/patterns/users/user-administration-server/example/packages/users/package.json +2 -2
  28. package/skills/jskit/references/patterns/users/user-administration-server/example/packages/users-workspace/package.json +3 -3
@@ -1485,8 +1485,37 @@ does not abort that newer input. Owned executor failure stops its still-current
1485
1485
  native turn; Stop and disposal drain and close
1486
1486
  only its private bridge under the original owner. Unconfigured bound and scoped
1487
1487
  conversations retain their original behavior. These source tests do not establish
1488
- an application's composition or installed/native acceptance. Bound Claude
1489
- application-tool dispatch remains unavailable.
1488
+ an application's composition or installed/native acceptance.
1489
+
1490
+ An opted-in supplied Claude conversation uses its original retained owner/store
1491
+ and SDK MCP control pipe. The owner exposes `applicationToolsSupported: true`;
1492
+ that capability does not authorize an application action. Its configured command
1493
+ is attached before native process configuration. The host must expose the same
1494
+ application SDK declaration through `process.configure` using the owner's tool
1495
+ schemas, without selecting standalone execution-release or isolated policy.
1496
+ Original native ACK, canonical admission/publication and the common accepted
1497
+ request callback precede tool effects. Each call matches the exact recorded
1498
+ native tool-use ID, name, arguments and originating accepted message. Optional
1499
+ supplied-owner checks at the same executor boundary refuse retired input before
1500
+ execution and report only a still-current owned executor failure through the
1501
+ original Stop/drain path. Already invoked old work cannot fail a later accepted
1502
+ input. The common ordered tool-work catch attributes a failure only to its
1503
+ still-current Claude request; prior action error receipts and once-only execution remain
1504
+ unchanged. This successor-query exception is specific to Claude. Codex retains
1505
+ its active-turn failure guard across steering: an unconfirmed application effect
1506
+ cannot be reported as a successful turn, even if an answer has arrived.
1507
+ The original retained-turn reader's opt-in current mode requires the exact
1508
+ live process, account, command and native tuple; its default retained/history
1509
+ projection is unchanged. Stop and completion join existing tool work; clearing custody leaves the original supplied
1510
+ process/storage lifecycle intact. Unconfigured supplied conversations keep their
1511
+ original behavior.
1512
+
1513
+ `claudeCodeArguments({ applicationTools: true })` adds the existing SDK MCP config
1514
+ also for normal Claude execution. It does not change native source tools or
1515
+ permission defaults; existing tool-free and isolated branches are unchanged.
1516
+ Applications still supply exact action authorization, native instruction/account
1517
+ configuration and checkpoints. Source/component proofs do not establish a host's
1518
+ installed or real CLI/application acceptance.
1490
1519
 
1491
1520
  Such a server integration may open a handle with `representation: "native"` when
1492
1521
  its existing command contract requires the original result. The option belongs
@@ -1776,6 +1805,13 @@ selecting that segment's engine; recovery never revives a rewound turn. Neither
1776
1805
  inspection nor reopening sends the message again. If native process cleanup fails,
1777
1806
  the handle reports unavailable and rejects new work; `cancel()` retries that exact
1778
1807
  owned cleanup rather than starting another process.
1808
+ Claude streaming startup can fail after the host admits an execution but before
1809
+ it returns a stream. The adapter preserves that execution identity and the host's
1810
+ actual cleanup proof; a rejected startup never supplies a successful stop proof.
1811
+ Unconfirmed cleanup retains the identity through the existing native binding for
1812
+ Stop/recovery. If binding publication also fails, the original startup failure and
1813
+ in-memory custody remain, with the persistence error in `bindingError`; durable
1814
+ restart recovery is not established until that binding can be saved.
1779
1815
  An optional `limits.timeoutMs` deadline aborts work and waits for owned cleanup;
1780
1816
  a failed cleanup is still reported as unavailable rather than as a successful stop.
1781
1817
 
@@ -2838,6 +2874,19 @@ An exact native acknowledgement ends its ACK deadline before the admission
2838
2874
  writer runs; a slow write remains awaited, and a rejected write rejects admission.
2839
2875
  A missing acknowledgement remains uncertain. Native failure-result text stays
2840
2876
  in the turn's error rather than becoming an assistant answer.
2877
+ The retained owner also exposes
2878
+ `readFinalAssistantResult(contextKey, conversationId, turnId)` for a trusted host
2879
+ that returns its canonical turn from a successful complete-message publication.
2880
+ This synchronous lookup clones the current native receipt; it does not acquire
2881
+ a conversation, read history, resume, or resend work. It requires the exact
2882
+ current context, conversation, turn, accepted input, process, execution and account,
2883
+ and successful native settlement after pending commands and background tasks.
2884
+ The receipt becomes readable before the original before-state checkpoint; a
2885
+ failed publication or checkpoint invalidates it. Default event sinks and saved
2886
+ completion metadata cannot supply this proof. New input, steering, account
2887
+ changes, interruption and cleanup invalidate it. Pending or failed native Stop
2888
+ cannot revive an older receipt. This optional getter preserves existing storage,
2889
+ checkpoint and cleanup behavior; the host still owns question or grading policy.
2841
2890
  The turn owner preserves the production receiver's block lifecycle: deltas are
2842
2891
  temporary, block-stop removes them, and completed snapshots use their native
2843
2892
  UUIDs. It does not group distinct history snapshots into a synthetic reply.
@@ -136,6 +136,79 @@ are declared. Verify create, list, blank-name rejection and reload persistence
136
136
  without signing in for this public variant; owner-scoped variants additionally
137
137
  need cross-owner denial tests.
138
138
 
139
+ ## Save navigation
140
+
141
+ `useCrudAddEditScreen()` accepts `saveSuccess` at the top level. After saving,
142
+ the default behaviour invalidates `saveSuccess.invalidateQueryKey`, navigates
143
+ to a configured record-view URL when one resolves, and otherwise falls back to
144
+ the list URL. For a create-and-list app, use `navigateToView: false` and the
145
+ configured `listUrlTemplate`, as in the public example above. The list URL may
146
+ also come from `addEditOptions.listUrlTemplate`.
147
+
148
+ To keep the saved form open, set both `saveSuccess.navigateToView` and
149
+ `saveSuccess.navigateToList` to `false`. `addEditOptions.onSaveSuccess` replaces
150
+ the default success handling, including query invalidation and navigation;
151
+ reserve it for custom success behaviour. Returning to the list needs only the
152
+ documented `saveSuccess` options, not a custom router callback or inspection of
153
+ the shared form implementation.
154
+
155
+ ## Browser routes and responsive lists
156
+
157
+ `newUrlTemplate`, `viewUrlTemplate`, `editUrlTemplate`, `listUrlTemplate`, and
158
+ `cancelTo` describe browser routes, not surface-relative API suffixes. Include
159
+ the configured surface prefix: if a public library lives at `/library`, its new
160
+ page is `/library/new` and its list is `/library`, not `/new` and `/`. For links
161
+ without record placeholders, `paths.page()` can resolve the configured surface;
162
+ for record placeholders use the current CRUD runtime's `resolveParams()`.
163
+ Request-scope inference does not add missing prefixes to browser links.
164
+
165
+ `CrudListScreen` uses `createLabel` for its toolbar, empty-state and compact
166
+ create actions. Its card and table layouts coexist in the DOM, with CSS choosing
167
+ the visible layout. Browser assertions on record text must select the visible
168
+ match, for example `page.getByText(title, { exact: true }).filter({ visible: true })`.
169
+ When the same create action appears in more than one visible location, choose
170
+ one visible action deliberately; do not relax the expected label to accept an
171
+ unrelated fallback.
172
+
173
+ ## Direct API tests use JSON:API documents
174
+
175
+ JSKIT's CRUD screens and HTTP client apply the resource's JSON:API transport
176
+ automatically. Direct Playwright `request` calls and other raw HTTP clients must
177
+ supply that transport themselves. An ordinary JSON body such as `{ title }`
178
+ with `Content-Type: application/json` does not test field validation on a
179
+ JSON:API route; it is rejected as an unsupported media type (HTTP 415).
180
+
181
+ Use the application's actual API base and scope, not its page URL. For the
182
+ public Books resource above, with API base `/api` and transport type `books`:
183
+
184
+ ```js
185
+ const headers = {
186
+ "Content-Type": "application/vnd.api+json",
187
+ Accept: "application/vnd.api+json"
188
+ };
189
+ const response = await request.post("/api/books", {
190
+ headers,
191
+ data: {
192
+ data: {
193
+ type: "books",
194
+ attributes: { title: "Kindred" }
195
+ }
196
+ }
197
+ });
198
+ expect(response.status()).toBe(201);
199
+ const document = await response.json();
200
+ expect(document.data.attributes.title).toBe("Kindred");
201
+ ```
202
+
203
+ Keep the same headers and `data.type/attributes` envelope when testing invalid
204
+ field values; for this contract, an empty `title` or one over 255 characters
205
+ should return HTTP 400. Raw responses contain fields under `data.attributes`,
206
+ while the shared client simplifies resource responses. A collection response
207
+ has an array in `data`. Match `data.type` to the configured resource transport;
208
+ retain the application's existing identity and CSRF fixture for protected APIs.
209
+ Prefer the shared resource client for application requests rather than copying
210
+ this raw test encoding into page code.
211
+
139
212
  ## Record deletion
140
213
 
141
214
  Deletion requires an explicit shared `DELETE` operation and confirmation
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jskit-ai/agent-docs",
3
- "version": "0.1.206",
3
+ "version": "0.1.207",
4
4
  "description": "Distributed JSKIT agent references, prompts, guides, and generated reference maps.",
5
5
  "type": "module",
6
6
  "files": [
@@ -5,7 +5,7 @@
5
5
  "private": true,
6
6
  "type": "module",
7
7
  "dependencies": {
8
- "@jskit-ai/kernel": "0.1.234",
8
+ "@jskit-ai/kernel": "0.1.235",
9
9
  "json-rest-schema": "^1.0.17"
10
10
  },
11
11
  "exports": {
@@ -34,7 +34,7 @@
34
34
  "dependencies": {
35
35
  "@local/main": "0.1.0",
36
36
  "@fastify/static": "^10.1.3",
37
- "@jskit-ai/kernel": "0.1.234",
37
+ "@jskit-ai/kernel": "0.1.235",
38
38
  "@tanstack/vue-query": "^5.101.0",
39
39
  "fastify": "^5.8.5",
40
40
  "json-rest-schema": "^1.0.17",
@@ -42,13 +42,13 @@
42
42
  "vue": "^3.5.43",
43
43
  "vue-router": "^5.3.1",
44
44
  "vuetify": "^4.1.2",
45
- "@jskit-ai/http-runtime": "0.1.232",
45
+ "@jskit-ai/http-runtime": "0.1.233",
46
46
  "@fastify/fast-json-stringify-compiler": "^5.1.0",
47
47
  "@vue/devtools-api": "^8.2.1"
48
48
  },
49
49
  "devDependencies": {
50
- "@jskit-ai/config-eslint": "0.1.231",
51
- "@jskit-ai/jskit-catalog": "0.1.259",
50
+ "@jskit-ai/config-eslint": "0.1.232",
51
+ "@jskit-ai/jskit-catalog": "0.1.260",
52
52
  "@playwright/test": "1.61.1",
53
53
  "@vitejs/plugin-vue": "^6.0.7",
54
54
  "eslint": "^10.8.0",
@@ -34,7 +34,7 @@
34
34
  "dependencies": {
35
35
  "@local/main": "0.1.0",
36
36
  "@fastify/static": "^10.1.3",
37
- "@jskit-ai/kernel": "0.1.234",
37
+ "@jskit-ai/kernel": "0.1.235",
38
38
  "@tanstack/vue-query": "^5.101.0",
39
39
  "fastify": "^5.8.5",
40
40
  "json-rest-schema": "^1.0.17",
@@ -42,15 +42,15 @@
42
42
  "vue": "^3.5.43",
43
43
  "vue-router": "^5.3.1",
44
44
  "vuetify": "^4.1.2",
45
- "@jskit-ai/http-runtime": "0.1.232",
45
+ "@jskit-ai/http-runtime": "0.1.233",
46
46
  "@mdi/js": "^7.4.47",
47
- "@jskit-ai/shell-web": "0.1.238",
47
+ "@jskit-ai/shell-web": "0.1.239",
48
48
  "@fastify/fast-json-stringify-compiler": "^5.1.0",
49
49
  "@vue/devtools-api": "^8.2.1"
50
50
  },
51
51
  "devDependencies": {
52
- "@jskit-ai/config-eslint": "0.1.231",
53
- "@jskit-ai/jskit-catalog": "0.1.259",
52
+ "@jskit-ai/config-eslint": "0.1.232",
53
+ "@jskit-ai/jskit-catalog": "0.1.260",
54
54
  "@playwright/test": "1.61.1",
55
55
  "@vitejs/plugin-vue": "^6.0.7",
56
56
  "eslint": "^10.8.0",
@@ -9,7 +9,7 @@
9
9
  },
10
10
  "description": "App-local runtime composition and lightweight glue.",
11
11
  "dependencies": {
12
- "@jskit-ai/kernel": "0.1.234"
12
+ "@jskit-ai/kernel": "0.1.235"
13
13
  },
14
14
  "jskit": {
15
15
  "kind": "runtime",
@@ -21,6 +21,13 @@ Rules:
21
21
  - A managed runner supplies `PLAYWRIGHT_BASE_URL`. When it is set, JSKIT does not start another app server.
22
22
  - Vibe64 supplies an authenticated context through `VIBE64_PLAYWRIGHT_STORAGE_STATE`. Treat that file as a temporary secret: do not commit it, print it, or retain it after the run.
23
23
  - Do not install a browser when the environment provides a managed browser runner.
24
+ - Shared CRUD lists retain both card and table markup and hide the inactive
25
+ layout with CSS. Select visible record text with
26
+ `page.getByText(title, { exact: true }).filter({ visible: true })`; asserting on
27
+ an unfiltered text locator can fail with a strict-mode duplicate after saving.
28
+ Keep the expected text and persistence assertion. If repeated create controls
29
+ perform the same action, select one visible control deliberately rather than
30
+ accepting a different label to make a test pass.
24
31
 
25
32
  ## Keep startup incremental
26
33
 
@@ -15,7 +15,7 @@ A concrete Fastify, Vue, and JSKIT application foundation for products that do n
15
15
 
16
16
  - Id: `app/minimal-foundation`
17
17
  - Keywords: `app`, `fastify`, `foundation`, `minimal`, `server`, `vite`, `vue`
18
- - Owner: `@jskit-ai/agent-docs@0.1.206`
18
+ - Owner: `@jskit-ai/agent-docs@0.1.207`
19
19
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/app/minimal-foundation/PATTERN.md)
20
20
  - Examples: [example/](../../skills/jskit/references/patterns/app/minimal-foundation/example/)
21
21
  - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`
@@ -26,7 +26,7 @@ A concrete JSKIT web application foundation with responsive shell navigation, se
26
26
 
27
27
  - Id: `app/shell-foundation`
28
28
  - Keywords: `app`, `foundation`, `material`, `navigation`, `placements`, `shell`, `vite`, `vue`
29
- - Owner: `@jskit-ai/agent-docs@0.1.206`
29
+ - Owner: `@jskit-ai/agent-docs@0.1.207`
30
30
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/app/shell-foundation/PATTERN.md)
31
31
  - Examples: [example/](../../skills/jskit/references/patterns/app/shell-foundation/example/)
32
32
  - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -37,7 +37,7 @@ Configure an assistant runtime for one application surface and expose its chat a
37
37
 
38
38
  - Id: `assistant/assistant-surface`
39
39
  - Keywords: `ai`, `assistant`, `chat`, `config`, `environment`, `page`, `placement`, `settings`, `surface`
40
- - Owner: `@jskit-ai/assistant-runtime@0.1.205`
40
+ - Owner: `@jskit-ai/assistant-runtime@0.1.206`
41
41
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/assistant/assistant-surface/PATTERN.md)
42
42
  - Examples: [example/](../../skills/jskit/references/patterns/assistant/assistant-surface/example/)
43
43
  - Requires: `@jskit-ai/assistant-runtime`, `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`, `@jskit-ai/shell-web`
@@ -48,7 +48,7 @@ Compose JSKIT authentication routes, views, profile controls, and public surface
48
48
 
49
49
  - Id: `auth/auth-surface`
50
50
  - Keywords: `account`, `auth`, `login`, `logout`, `password`, `placement`, `profile`, `reset`, `surface`
51
- - Owner: `@jskit-ai/auth-web@0.1.234`
51
+ - Owner: `@jskit-ai/auth-web@0.1.235`
52
52
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/auth/auth-surface/PATTERN.md)
53
53
  - Examples: [example/](../../skills/jskit/references/patterns/auth/auth-surface/example/)
54
54
  - Requires: `@jskit-ai/auth-core`, `@jskit-ai/auth-web`, `@jskit-ai/shell-web`
@@ -59,7 +59,7 @@ Add Supabase authentication through normal npm composition, explicit environment
59
59
 
60
60
  - Id: `auth/supabase-auth`
61
61
  - Keywords: `auth`, `authentication`, `oauth`, `sessions`, `supabase`
62
- - Owner: `@jskit-ai/auth-provider-supabase-core@0.1.231`
62
+ - Owner: `@jskit-ai/auth-provider-supabase-core@0.1.232`
63
63
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/auth/supabase-auth/PATTERN.md)
64
64
  - Examples: [example/](../../skills/jskit/references/patterns/auth/supabase-auth/example/)
65
65
  - Requires: `@jskit-ai/auth-provider-supabase-core`
@@ -70,7 +70,7 @@ Resolve an administrator environment key or an individual user's grant, then use
70
70
 
71
71
  - Id: `connectors/ai-connections`
72
72
  - Keywords: `ai`, `api-key`, `big-pickle`, `cli`, `environment`, `free`, `models`, `ownership`, `zai`, `zen`
73
- - Owner: `@jskit-ai/connectors-catalog@0.1.51`
73
+ - Owner: `@jskit-ai/connectors-catalog@0.1.52`
74
74
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/ai-connections/PATTERN.md)
75
75
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/ai-connections/example/)
76
76
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -81,7 +81,7 @@ Compose provider operations, authorization and encrypted file storage from a CLI
81
81
 
82
82
  - Id: `connectors/api-key-connection`
83
83
  - Keywords: `api-key`, `clay`, `cli`, `clickhouse`, `connectors`, `dbt`, `files`, `firecrawl`, `granola`, `integrations`, `metrics`, `prestashop`, `resend`, `semantic-layer`, `semrush`, `x-twitter`
84
- - Owner: `@jskit-ai/connectors-catalog@0.1.51`
84
+ - Owner: `@jskit-ai/connectors-catalog@0.1.52`
85
85
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/api-key-connection/PATTERN.md)
86
86
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/api-key-connection/example/)
87
87
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -92,7 +92,7 @@ Compose token-based MCP discovery and explicitly authorized tool calls using the
92
92
 
93
93
  - Id: `connectors/assistant-mcp`
94
94
  - Keywords: `assistant`, `cli`, `connectors`, `files`, `integrations`, `mcp`, `n8n`, `sanity`
95
- - Owner: `@jskit-ai/connectors-catalog@0.1.51`
95
+ - Owner: `@jskit-ai/connectors-catalog@0.1.52`
96
96
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/assistant-mcp/PATTERN.md)
97
97
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/assistant-mcp/example/)
98
98
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -103,7 +103,7 @@ Configure assistant OAuth clients, then compose existing state, encrypted file g
103
103
 
104
104
  - Id: `connectors/assistant-mcp-oauth`
105
105
  - Keywords: `amplitude`, `assistant`, `atlassian`, `canva`, `cli`, `client metadata`, `confidence`, `connectors`, `figma`, `files`, `granola`, `hex`, `mcp`, `miro`, `oauth`
106
- - Owner: `@jskit-ai/connectors-catalog@0.1.51`
106
+ - Owner: `@jskit-ai/connectors-catalog@0.1.52`
107
107
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/assistant-mcp-oauth/PATTERN.md)
108
108
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/assistant-mcp-oauth/example/)
109
109
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -114,7 +114,7 @@ Compose signed AWS operations, file configuration and application authorization
114
114
 
115
115
  - Id: `connectors/aws-storage-queries`
116
116
  - Keywords: `athena`, `aws`, `cli`, `connectors`, `files`, `iam`, `queries`, `s3`, `storage`, `sts`
117
- - Owner: `@jskit-ai/connectors-catalog@0.1.51`
117
+ - Owner: `@jskit-ai/connectors-catalog@0.1.52`
118
118
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/aws-storage-queries/PATTERN.md)
119
119
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/aws-storage-queries/example/)
120
120
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -125,7 +125,7 @@ Compose reusable connection libraries with portable configuration, application o
125
125
 
126
126
  - Id: `connectors/calendar-cli`
127
127
  - Keywords: `calendar`, `cli`, `connectors`, `google`, `integrations`, `oauth`, `permissions`
128
- - Owner: `@jskit-ai/connector-google-calendar@0.1.51`
128
+ - Owner: `@jskit-ai/connector-google-calendar@0.1.52`
129
129
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/calendar-cli/PATTERN.md)
130
130
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/calendar-cli/example/)
131
131
  - Requires: `@jskit-ai/connector-google-calendar`, `@jskit-ai/connectors-core`, `@jskit-ai/database-runtime-mysql`
@@ -136,7 +136,7 @@ Compose the shared connector runtime for event delivery while leaving workflow c
136
136
 
137
137
  - Id: `connectors/event-delivery`
138
138
  - Keywords: `cli`, `connectors`, `events`, `files`, `inngest`, `integrations`, `workflows`
139
- - Owner: `@jskit-ai/connectors-catalog@0.1.51`
139
+ - Owner: `@jskit-ai/connectors-catalog@0.1.52`
140
140
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/event-delivery/PATTERN.md)
141
141
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/event-delivery/example/)
142
142
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -147,7 +147,7 @@ Wire service-account grants, file storage, explicit message actions and public b
147
147
 
148
148
  - Id: `connectors/firebase-messaging`
149
149
  - Keywords: `cli`, `connectors`, `fcm`, `files`, `firebase`, `integrations`, `jwt`, `notifications`, `push`, `service-account`, `vapid`
150
- - Owner: `@jskit-ai/connectors-catalog@0.1.51`
150
+ - Owner: `@jskit-ai/connectors-catalog@0.1.52`
151
151
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/firebase-messaging/PATTERN.md)
152
152
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/firebase-messaging/example/)
153
153
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -158,7 +158,7 @@ Compose reviewed Search campaigns with project-owned Google OAuth and portable s
158
158
 
159
159
  - Id: `connectors/google-ads-search`
160
160
  - Keywords: `ads`, `campaigns`, `cli`, `connectors`, `conversion`, `google`, `search`
161
- - Owner: `@jskit-ai/connectors-catalog@0.1.51`
161
+ - Owner: `@jskit-ai/connectors-catalog@0.1.52`
162
162
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/google-ads-search/PATTERN.md)
163
163
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/google-ads-search/example/)
164
164
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -169,7 +169,7 @@ Compose provider consent, verification and encrypted file persistence from an ap
169
169
 
170
170
  - Id: `connectors/oauth-connection`
171
171
  - Keywords: `accounting`, `assistant permissions`, `books`, `cli`, `client credentials`, `connectors`, `consent`, `crm`, `databricks`, `developer token`, `fabric`, `files`, `gaql`, `google ads`, `graphql`, `integrations`, `linkedin`, `microsoft`, `oauth`, `powerpoint`, `salesforce`, `service principal`, `shopify`, `soql`, `staffing`, `tiktok`, `twitch`, `wave`, `word`, `wordpress`, `workday`, `xero`, `zoho`
172
- - Owner: `@jskit-ai/connectors-catalog@0.1.51`
172
+ - Owner: `@jskit-ai/connectors-catalog@0.1.52`
173
173
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/oauth-connection/PATTERN.md)
174
174
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/oauth-connection/example/)
175
175
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -180,7 +180,7 @@ Compose a sequential catalogue batch and preserve partial success for applicatio
180
180
 
181
181
  - Id: `connectors/paddle-catalogue`
182
182
  - Keywords: `batch`, `paddle`, `payments`, `prices`, `products`
183
- - Owner: `@jskit-ai/connectors-catalog@0.1.51`
183
+ - Owner: `@jskit-ai/connectors-catalog@0.1.52`
184
184
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/paddle-catalogue/PATTERN.md)
185
185
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/paddle-catalogue/example/)
186
186
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -191,7 +191,7 @@ Resolve a publishable image key deliberately and use the shared URL library in a
191
191
 
192
192
  - Id: `connectors/public-image`
193
193
  - Keywords: `cli`, `connectors`, `files`, `images`, `integrations`, `logo-dev`, `public-key`
194
- - Owner: `@jskit-ai/connectors-catalog@0.1.51`
194
+ - Owner: `@jskit-ai/connectors-catalog@0.1.52`
195
195
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/public-image/PATTERN.md)
196
196
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/public-image/example/)
197
197
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -202,7 +202,7 @@ Compose file configuration, Redshift Data API operations and application query o
202
202
 
203
203
  - Id: `connectors/redshift-queries`
204
204
  - Keywords: `aws`, `cli`, `connectors`, `files`, `iam`, `provisioned`, `redshift`, `serverless`, `sql`, `warehouse`
205
- - Owner: `@jskit-ai/connectors-catalog@0.1.51`
205
+ - Owner: `@jskit-ai/connectors-catalog@0.1.52`
206
206
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/redshift-queries/PATTERN.md)
207
207
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/redshift-queries/example/)
208
208
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -213,7 +213,7 @@ Use the shared scanner runtime from a CLI or a host worker with portable configu
213
213
 
214
214
  - Id: `connectors/source-scanning`
215
215
  - Keywords: `cancellation`, `cli`, `connectors`, `integrations`, `scanning`, `security`, `source`, `wiz`, `worker`
216
- - Owner: `@jskit-ai/connectors-catalog@0.1.51`
216
+ - Owner: `@jskit-ai/connectors-catalog@0.1.52`
217
217
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/source-scanning/PATTERN.md)
218
218
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/source-scanning/example/)
219
219
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -224,7 +224,7 @@ Add a protected administration surface, settings shell, and semantic navigation
224
224
 
225
225
  - Id: `console/console-surface`
226
226
  - Keywords: `admin`, `console`, `navigation`, `owner`, `placement`, `settings`, `surface`
227
- - Owner: `@jskit-ai/console-web@0.1.202`
227
+ - Owner: `@jskit-ai/console-web@0.1.203`
228
228
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/console/console-surface/PATTERN.md)
229
229
  - Examples: [example/](../../skills/jskit/references/patterns/console/console-surface/example/)
230
230
  - Requires: `@jskit-ai/console-core`, `@jskit-ai/console-web`, `@jskit-ai/shell-web`
@@ -235,7 +235,7 @@ Build a routed CRUD user interface as thin application pages over JSKIT's shared
235
235
 
236
236
  - Id: `crud/crud-screen-set`
237
237
  - Keywords: `actions`, `add`, `crud`, `delete`, `edit`, `filters`, `list`, `material`, `routes`, `view`, `vue`
238
- - Owner: `@jskit-ai/http-web@0.1.79`
238
+ - Owner: `@jskit-ai/http-web@0.1.80`
239
239
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/crud/crud-screen-set/PATTERN.md)
240
240
  - Examples: [example/](../../skills/jskit/references/patterns/crud/crud-screen-set/example/)
241
241
  - Requires: `@jskit-ai/http-web`, `@jskit-ai/resource-crud-core`
@@ -246,7 +246,7 @@ Build a complete application-owned CRUD server package from a migration, resourc
246
246
 
247
247
  - Id: `crud/json-api-resource-package`
248
248
  - Keywords: `actions`, `crud`, `database`, `json-api`, `migration`, `permissions`, `provider`, `repository`, `routes`, `service`
249
- - Owner: `@jskit-ai/crud-core@0.1.245`
249
+ - Owner: `@jskit-ai/crud-core@0.1.246`
250
250
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/crud/json-api-resource-package/PATTERN.md)
251
251
  - Examples: [example/](../../skills/jskit/references/patterns/crud/json-api-resource-package/example/)
252
252
  - Requires: `@jskit-ai/crud-core`, `@jskit-ai/resource-crud-core`
@@ -257,7 +257,7 @@ Define an authenticated application resource whose records belong to the current
257
257
 
258
258
  - Id: `crud/resource-contract`
259
259
  - Keywords: `authenticated`, `crud`, `database`, `owner-scoped`, `resource`, `user`
260
- - Owner: `@jskit-ai/resource-crud-core@0.1.176`
260
+ - Owner: `@jskit-ai/resource-crud-core@0.1.177`
261
261
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/crud/resource-contract/PATTERN.md)
262
262
  - Examples: [example/](../../skills/jskit/references/patterns/crud/resource-contract/example/)
263
263
  - Requires: `@jskit-ai/resource-crud-core`
@@ -268,7 +268,7 @@ Configure a JSKIT application for MySQL with a fixed driver, ordinary environmen
268
268
 
269
269
  - Id: `database/mysql-application`
270
270
  - Keywords: `database`, `knex`, `mariadb`, `migrations`, `mysql`, `mysql2`
271
- - Owner: `@jskit-ai/database-runtime-mysql@0.1.232`
271
+ - Owner: `@jskit-ai/database-runtime-mysql@0.1.233`
272
272
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/database/mysql-application/PATTERN.md)
273
273
  - Examples: [example/](../../skills/jskit/references/patterns/database/mysql-application/example/)
274
274
  - Requires: `@jskit-ai/database-runtime-mysql`
@@ -279,7 +279,7 @@ Configure a JSKIT application for PostgreSQL with a fixed driver, ordinary envir
279
279
 
280
280
  - Id: `database/postgres-application`
281
281
  - Keywords: `database`, `knex`, `migrations`, `pg`, `postgres`, `postgresql`
282
- - Owner: `@jskit-ai/database-runtime-postgres@0.1.231`
282
+ - Owner: `@jskit-ai/database-runtime-postgres@0.1.232`
283
283
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/database/postgres-application/PATTERN.md)
284
284
  - Examples: [example/](../../skills/jskit/references/patterns/database/postgres-application/example/)
285
285
  - Requires: `@jskit-ai/database-runtime-postgres`
@@ -290,7 +290,7 @@ Wrap a JSKIT web application in a Capacitor Android shell using native Capacitor
290
290
 
291
291
  - Id: `mobile/android-application`
292
292
  - Keywords: `android`, `capacitor`, `device`, `mobile`, `native`, `shell`, `webview`
293
- - Owner: `@jskit-ai/mobile-capacitor@0.1.169`
293
+ - Owner: `@jskit-ai/mobile-capacitor@0.1.170`
294
294
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/mobile/android-application/PATTERN.md)
295
295
  - Examples: [example/](../../skills/jskit/references/patterns/mobile/android-application/example/)
296
296
  - Requires: `@capacitor/android`, `@capacitor/app`, `@capacitor/cli`, `@jskit-ai/mobile-capacitor`
@@ -301,7 +301,7 @@ Add JSKIT realtime events with an optional Redis backplane and an explicit shell
301
301
 
302
302
  - Id: `realtime/realtime-application`
303
303
  - Keywords: `realtime`, `redis`, `socket.io`, `sockets`, `status`, `websocket`
304
- - Owner: `@jskit-ai/realtime@0.1.231`
304
+ - Owner: `@jskit-ai/realtime@0.1.232`
305
305
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/realtime/realtime-application/PATTERN.md)
306
306
  - Examples: [example/](../../skills/jskit/references/patterns/realtime/realtime-application/example/)
307
307
  - Requires: `@jskit-ai/realtime`, `@jskit-ai/shell-web`
@@ -312,7 +312,7 @@ Compose application-owned Google Publisher Tag delivery with the generic rewarde
312
312
 
313
313
  - Id: `rewards/google-rewarded`
314
314
  - Keywords: `ads`, `google`, `publisher tag`, `rewarded`, `unlock`
315
- - Owner: `@jskit-ai/rewarded-web@0.1.170`
315
+ - Owner: `@jskit-ai/rewarded-web@0.1.171`
316
316
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/rewards/google-rewarded/PATTERN.md)
317
317
  - Examples: [example/](../../skills/jskit/references/patterns/rewards/google-rewarded/example/)
318
318
  - Requires: `@jskit-ai/rewarded-web`
@@ -323,7 +323,7 @@ Define a server feature through explicit capabilities and first-class actions, a
323
323
 
324
324
  - Id: `server/feature-package`
325
325
  - Keywords: `actions`, `feature`, `json-rest`, `knex`, `orchestration`, `package`, `provider`, `repository`, `routes`, `server`
326
- - Owner: `@jskit-ai/agent-docs@0.1.206`
326
+ - Owner: `@jskit-ai/agent-docs@0.1.207`
327
327
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/server/feature-package/PATTERN.md)
328
328
  - Examples: [example/](../../skills/jskit/references/patterns/server/feature-package/example/)
329
329
  - Requires: `@jskit-ai/kernel`
@@ -334,7 +334,7 @@ Compose the JSKIT responsive shell, semantic placements, settings navigation, an
334
334
 
335
335
  - Id: `shell/application-shell`
336
336
  - Keywords: `adaptive`, `app`, `layout`, `navigation`, `placement`, `responsive`, `settings`, `shell`
337
- - Owner: `@jskit-ai/shell-web@0.1.238`
337
+ - Owner: `@jskit-ai/shell-web@0.1.239`
338
338
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/shell/application-shell/PATTERN.md)
339
339
  - Examples: [example/](../../skills/jskit/references/patterns/shell/application-shell/example/)
340
340
  - Requires: `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -345,7 +345,7 @@ Add product routes and shell extensions through file routing, semantic placement
345
345
 
346
346
  - Id: `ui/page-and-placement`
347
347
  - Keywords: `component`, `navigation`, `outlet`, `page`, `placement`, `routes`, `section`, `shell`, `subpages`, `vue`
348
- - Owner: `@jskit-ai/shell-web@0.1.238`
348
+ - Owner: `@jskit-ai/shell-web@0.1.239`
349
349
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/ui/page-and-placement/PATTERN.md)
350
350
  - Examples: [example/](../../skills/jskit/references/patterns/ui/page-and-placement/example/)
351
351
  - Requires: `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -356,7 +356,7 @@ Compose an account settings route and profile, preference, and notification sect
356
356
 
357
357
  - Id: `users/account-settings`
358
358
  - Keywords: `account`, `notifications`, `preferences`, `profile`, `settings`, `user`, `vue`
359
- - Owner: `@jskit-ai/users-web@0.1.252`
359
+ - Owner: `@jskit-ai/users-web@0.1.253`
360
360
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/users/account-settings/PATTERN.md)
361
361
  - Examples: [example/](../../skills/jskit/references/patterns/users/account-settings/example/)
362
362
  - Requires: `@jskit-ai/shell-web`, `@jskit-ai/users-core`, `@jskit-ai/users-web`
@@ -367,7 +367,7 @@ Expose user administration and workspace-scoped member operations through app-ow
367
367
 
368
368
  - Id: `users/user-administration-server`
369
369
  - Keywords: `account`, `admin`, `member`, `repository`, `resource`, `routes`, `service`, `user`, `workspace`
370
- - Owner: `@jskit-ai/users-core@0.1.247`
370
+ - Owner: `@jskit-ai/users-core@0.1.248`
371
371
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/users/user-administration-server/PATTERN.md)
372
372
  - Examples: [example/](../../skills/jskit/references/patterns/users/user-administration-server/example/)
373
373
  - Requires: `@jskit-ai/crud-core`, `@jskit-ai/users-core`
@@ -378,7 +378,7 @@ Configure roles, workspace access policy, invitations, and app-owned invitation
378
378
 
379
379
  - Id: `workspaces/workspace-server`
380
380
  - Keywords: `access`, `invite`, `membership`, `multitenancy`, `policy`, `role`, `tenancy`, `workspace`
381
- - Owner: `@jskit-ai/workspaces-core@0.1.212`
381
+ - Owner: `@jskit-ai/workspaces-core@0.1.213`
382
382
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/workspaces/workspace-server/PATTERN.md)
383
383
  - Examples: [example/](../../skills/jskit/references/patterns/workspaces/workspace-server/example/)
384
384
  - Requires: `@jskit-ai/users-core`, `@jskit-ai/workspaces-core`
@@ -389,7 +389,7 @@ Compose workspace selection, invitation, member administration, settings, and re
389
389
 
390
390
  - Id: `workspaces/workspace-surfaces`
391
391
  - Keywords: `admin`, `invite`, `member`, `navigation`, `settings`, `surface`, `switcher`, `workspace`
392
- - Owner: `@jskit-ai/workspaces-web@0.1.213`
392
+ - Owner: `@jskit-ai/workspaces-web@0.1.214`
393
393
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/workspaces/workspace-surfaces/PATTERN.md)
394
394
  - Examples: [example/](../../skills/jskit/references/patterns/workspaces/workspace-surfaces/example/)
395
395
  - Requires: `@jskit-ai/shell-web`, `@jskit-ai/workspaces-core`, `@jskit-ai/workspaces-web`
@@ -331,7 +331,7 @@ Local functions
331
331
 
332
332
  ### `src/server/conversation/claudeTools.js`
333
333
  Exports
334
- - `claudeApplicationToolResponse(request, { schemas, turn, signal })`
334
+ - `claudeApplicationToolResponse(request, { schemas, turn, signal, assertCurrent, onExecutionFailure })`
335
335
  - `CLAUDE_APPLICATION_TOOL_SERVER`
336
336
 
337
337
  ### `src/server/conversation/claudeTurn.js`
@@ -39,7 +39,7 @@ Exports
39
39
 
40
40
  ### `src/synthesisProcess.js`
41
41
  Exports
42
- - `createSynthesisProcess(configuration, { outputSampleRate, workerUrl = new URL("./synthesisWorker.js", import.meta.url) } = {})`
42
+ - `createSynthesisProcess(configuration, { outputSampleRate, signal = null, workerUrl = new URL("./synthesisWorker.js", import.meta.url) } = {})`
43
43
 
44
44
  ### `src/synthesisWorker.js`
45
45
  Exports
@@ -57,6 +57,15 @@ composables. JSKIT has no general authoring CLI: inspect current source and
57
57
  installed packages directly, edit app-owned files deliberately, and use npm
58
58
  for dependency installation.
59
59
 
60
+ Finish a dependency installation before inspecting the installed package or
61
+ changing the same manifest/lockfile; do not overlap npm operations on one app. Import
62
+ subpaths are package `exports` aliases, not physical file paths: a package may
63
+ map `client/...` to `src/client/...` and keep shared code outside `src`. If source
64
+ inspection is still needed, resolve the import with the installed `package.json`
65
+ `exports` or `import.meta.resolve()`, or locate the file with `rg --files` before
66
+ opening it. Do not guess a package's directory layout. Use the documented option
67
+ when the guide or pattern already explains the required behaviour.
68
+
60
69
  ## Implement a change
61
70
 
62
71
  Read the matching pattern and reference, then implement the smallest complete
@@ -130,6 +130,79 @@ are declared. Verify create, list, blank-name rejection and reload persistence
130
130
  without signing in for this public variant; owner-scoped variants additionally
131
131
  need cross-owner denial tests.
132
132
 
133
+ ## Save navigation
134
+
135
+ `useCrudAddEditScreen()` accepts `saveSuccess` at the top level. After saving,
136
+ the default behaviour invalidates `saveSuccess.invalidateQueryKey`, navigates
137
+ to a configured record-view URL when one resolves, and otherwise falls back to
138
+ the list URL. For a create-and-list app, use `navigateToView: false` and the
139
+ configured `listUrlTemplate`, as in the public example above. The list URL may
140
+ also come from `addEditOptions.listUrlTemplate`.
141
+
142
+ To keep the saved form open, set both `saveSuccess.navigateToView` and
143
+ `saveSuccess.navigateToList` to `false`. `addEditOptions.onSaveSuccess` replaces
144
+ the default success handling, including query invalidation and navigation;
145
+ reserve it for custom success behaviour. Returning to the list needs only the
146
+ documented `saveSuccess` options, not a custom router callback or inspection of
147
+ the shared form implementation.
148
+
149
+ ## Browser routes and responsive lists
150
+
151
+ `newUrlTemplate`, `viewUrlTemplate`, `editUrlTemplate`, `listUrlTemplate`, and
152
+ `cancelTo` describe browser routes, not surface-relative API suffixes. Include
153
+ the configured surface prefix: if a public library lives at `/library`, its new
154
+ page is `/library/new` and its list is `/library`, not `/new` and `/`. For links
155
+ without record placeholders, `paths.page()` can resolve the configured surface;
156
+ for record placeholders use the current CRUD runtime's `resolveParams()`.
157
+ Request-scope inference does not add missing prefixes to browser links.
158
+
159
+ `CrudListScreen` uses `createLabel` for its toolbar, empty-state and compact
160
+ create actions. Its card and table layouts coexist in the DOM, with CSS choosing
161
+ the visible layout. Browser assertions on record text must select the visible
162
+ match, for example `page.getByText(title, { exact: true }).filter({ visible: true })`.
163
+ When the same create action appears in more than one visible location, choose
164
+ one visible action deliberately; do not relax the expected label to accept an
165
+ unrelated fallback.
166
+
167
+ ## Direct API tests use JSON:API documents
168
+
169
+ JSKIT's CRUD screens and HTTP client apply the resource's JSON:API transport
170
+ automatically. Direct Playwright `request` calls and other raw HTTP clients must
171
+ supply that transport themselves. An ordinary JSON body such as `{ title }`
172
+ with `Content-Type: application/json` does not test field validation on a
173
+ JSON:API route; it is rejected as an unsupported media type (HTTP 415).
174
+
175
+ Use the application's actual API base and scope, not its page URL. For the
176
+ public Books resource above, with API base `/api` and transport type `books`:
177
+
178
+ ```js
179
+ const headers = {
180
+ "Content-Type": "application/vnd.api+json",
181
+ Accept: "application/vnd.api+json"
182
+ };
183
+ const response = await request.post("/api/books", {
184
+ headers,
185
+ data: {
186
+ data: {
187
+ type: "books",
188
+ attributes: { title: "Kindred" }
189
+ }
190
+ }
191
+ });
192
+ expect(response.status()).toBe(201);
193
+ const document = await response.json();
194
+ expect(document.data.attributes.title).toBe("Kindred");
195
+ ```
196
+
197
+ Keep the same headers and `data.type/attributes` envelope when testing invalid
198
+ field values; for this contract, an empty `title` or one over 255 characters
199
+ should return HTTP 400. Raw responses contain fields under `data.attributes`,
200
+ while the shared client simplifies resource responses. A collection response
201
+ has an array in `data`. Match `data.type` to the configured resource transport;
202
+ retain the application's existing identity and CSRF fixture for protected APIs.
203
+ Prefer the shared resource client for application requests rather than copying
204
+ this raw test encoding into page code.
205
+
133
206
  ## Record deletion
134
207
 
135
208
  Deletion requires an explicit shared `DELETE` operation and confirmation
@@ -15,7 +15,7 @@ A concrete Fastify, Vue, and JSKIT application foundation for products that do n
15
15
 
16
16
  - Id: `app/minimal-foundation`
17
17
  - Keywords: `app`, `fastify`, `foundation`, `minimal`, `server`, `vite`, `vue`
18
- - Owner: `@jskit-ai/agent-docs@0.1.206`
18
+ - Owner: `@jskit-ai/agent-docs@0.1.207`
19
19
  - Read: [PATTERN.md](patterns/app/minimal-foundation/PATTERN.md)
20
20
  - Examples: [example/](patterns/app/minimal-foundation/example/)
21
21
  - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`
@@ -26,7 +26,7 @@ A concrete JSKIT web application foundation with responsive shell navigation, se
26
26
 
27
27
  - Id: `app/shell-foundation`
28
28
  - Keywords: `app`, `foundation`, `material`, `navigation`, `placements`, `shell`, `vite`, `vue`
29
- - Owner: `@jskit-ai/agent-docs@0.1.206`
29
+ - Owner: `@jskit-ai/agent-docs@0.1.207`
30
30
  - Read: [PATTERN.md](patterns/app/shell-foundation/PATTERN.md)
31
31
  - Examples: [example/](patterns/app/shell-foundation/example/)
32
32
  - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -37,7 +37,7 @@ Configure an assistant runtime for one application surface and expose its chat a
37
37
 
38
38
  - Id: `assistant/assistant-surface`
39
39
  - Keywords: `ai`, `assistant`, `chat`, `config`, `environment`, `page`, `placement`, `settings`, `surface`
40
- - Owner: `@jskit-ai/assistant-runtime@0.1.205`
40
+ - Owner: `@jskit-ai/assistant-runtime@0.1.206`
41
41
  - Read: [PATTERN.md](patterns/assistant/assistant-surface/PATTERN.md)
42
42
  - Examples: [example/](patterns/assistant/assistant-surface/example/)
43
43
  - Requires: `@jskit-ai/assistant-runtime`, `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`, `@jskit-ai/shell-web`
@@ -48,7 +48,7 @@ Compose JSKIT authentication routes, views, profile controls, and public surface
48
48
 
49
49
  - Id: `auth/auth-surface`
50
50
  - Keywords: `account`, `auth`, `login`, `logout`, `password`, `placement`, `profile`, `reset`, `surface`
51
- - Owner: `@jskit-ai/auth-web@0.1.234`
51
+ - Owner: `@jskit-ai/auth-web@0.1.235`
52
52
  - Read: [PATTERN.md](patterns/auth/auth-surface/PATTERN.md)
53
53
  - Examples: [example/](patterns/auth/auth-surface/example/)
54
54
  - Requires: `@jskit-ai/auth-core`, `@jskit-ai/auth-web`, `@jskit-ai/shell-web`
@@ -59,7 +59,7 @@ Add Supabase authentication through normal npm composition, explicit environment
59
59
 
60
60
  - Id: `auth/supabase-auth`
61
61
  - Keywords: `auth`, `authentication`, `oauth`, `sessions`, `supabase`
62
- - Owner: `@jskit-ai/auth-provider-supabase-core@0.1.231`
62
+ - Owner: `@jskit-ai/auth-provider-supabase-core@0.1.232`
63
63
  - Read: [PATTERN.md](patterns/auth/supabase-auth/PATTERN.md)
64
64
  - Examples: [example/](patterns/auth/supabase-auth/example/)
65
65
  - Requires: `@jskit-ai/auth-provider-supabase-core`
@@ -70,7 +70,7 @@ Resolve an administrator environment key or an individual user's grant, then use
70
70
 
71
71
  - Id: `connectors/ai-connections`
72
72
  - Keywords: `ai`, `api-key`, `big-pickle`, `cli`, `environment`, `free`, `models`, `ownership`, `zai`, `zen`
73
- - Owner: `@jskit-ai/connectors-catalog@0.1.51`
73
+ - Owner: `@jskit-ai/connectors-catalog@0.1.52`
74
74
  - Read: [PATTERN.md](patterns/connectors/ai-connections/PATTERN.md)
75
75
  - Examples: [example/](patterns/connectors/ai-connections/example/)
76
76
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -81,7 +81,7 @@ Compose provider operations, authorization and encrypted file storage from a CLI
81
81
 
82
82
  - Id: `connectors/api-key-connection`
83
83
  - Keywords: `api-key`, `clay`, `cli`, `clickhouse`, `connectors`, `dbt`, `files`, `firecrawl`, `granola`, `integrations`, `metrics`, `prestashop`, `resend`, `semantic-layer`, `semrush`, `x-twitter`
84
- - Owner: `@jskit-ai/connectors-catalog@0.1.51`
84
+ - Owner: `@jskit-ai/connectors-catalog@0.1.52`
85
85
  - Read: [PATTERN.md](patterns/connectors/api-key-connection/PATTERN.md)
86
86
  - Examples: [example/](patterns/connectors/api-key-connection/example/)
87
87
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -92,7 +92,7 @@ Compose token-based MCP discovery and explicitly authorized tool calls using the
92
92
 
93
93
  - Id: `connectors/assistant-mcp`
94
94
  - Keywords: `assistant`, `cli`, `connectors`, `files`, `integrations`, `mcp`, `n8n`, `sanity`
95
- - Owner: `@jskit-ai/connectors-catalog@0.1.51`
95
+ - Owner: `@jskit-ai/connectors-catalog@0.1.52`
96
96
  - Read: [PATTERN.md](patterns/connectors/assistant-mcp/PATTERN.md)
97
97
  - Examples: [example/](patterns/connectors/assistant-mcp/example/)
98
98
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -103,7 +103,7 @@ Configure assistant OAuth clients, then compose existing state, encrypted file g
103
103
 
104
104
  - Id: `connectors/assistant-mcp-oauth`
105
105
  - Keywords: `amplitude`, `assistant`, `atlassian`, `canva`, `cli`, `client metadata`, `confidence`, `connectors`, `figma`, `files`, `granola`, `hex`, `mcp`, `miro`, `oauth`
106
- - Owner: `@jskit-ai/connectors-catalog@0.1.51`
106
+ - Owner: `@jskit-ai/connectors-catalog@0.1.52`
107
107
  - Read: [PATTERN.md](patterns/connectors/assistant-mcp-oauth/PATTERN.md)
108
108
  - Examples: [example/](patterns/connectors/assistant-mcp-oauth/example/)
109
109
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -114,7 +114,7 @@ Compose signed AWS operations, file configuration and application authorization
114
114
 
115
115
  - Id: `connectors/aws-storage-queries`
116
116
  - Keywords: `athena`, `aws`, `cli`, `connectors`, `files`, `iam`, `queries`, `s3`, `storage`, `sts`
117
- - Owner: `@jskit-ai/connectors-catalog@0.1.51`
117
+ - Owner: `@jskit-ai/connectors-catalog@0.1.52`
118
118
  - Read: [PATTERN.md](patterns/connectors/aws-storage-queries/PATTERN.md)
119
119
  - Examples: [example/](patterns/connectors/aws-storage-queries/example/)
120
120
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -125,7 +125,7 @@ Compose reusable connection libraries with portable configuration, application o
125
125
 
126
126
  - Id: `connectors/calendar-cli`
127
127
  - Keywords: `calendar`, `cli`, `connectors`, `google`, `integrations`, `oauth`, `permissions`
128
- - Owner: `@jskit-ai/connector-google-calendar@0.1.51`
128
+ - Owner: `@jskit-ai/connector-google-calendar@0.1.52`
129
129
  - Read: [PATTERN.md](patterns/connectors/calendar-cli/PATTERN.md)
130
130
  - Examples: [example/](patterns/connectors/calendar-cli/example/)
131
131
  - Requires: `@jskit-ai/connector-google-calendar`, `@jskit-ai/connectors-core`, `@jskit-ai/database-runtime-mysql`
@@ -136,7 +136,7 @@ Compose the shared connector runtime for event delivery while leaving workflow c
136
136
 
137
137
  - Id: `connectors/event-delivery`
138
138
  - Keywords: `cli`, `connectors`, `events`, `files`, `inngest`, `integrations`, `workflows`
139
- - Owner: `@jskit-ai/connectors-catalog@0.1.51`
139
+ - Owner: `@jskit-ai/connectors-catalog@0.1.52`
140
140
  - Read: [PATTERN.md](patterns/connectors/event-delivery/PATTERN.md)
141
141
  - Examples: [example/](patterns/connectors/event-delivery/example/)
142
142
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -147,7 +147,7 @@ Wire service-account grants, file storage, explicit message actions and public b
147
147
 
148
148
  - Id: `connectors/firebase-messaging`
149
149
  - Keywords: `cli`, `connectors`, `fcm`, `files`, `firebase`, `integrations`, `jwt`, `notifications`, `push`, `service-account`, `vapid`
150
- - Owner: `@jskit-ai/connectors-catalog@0.1.51`
150
+ - Owner: `@jskit-ai/connectors-catalog@0.1.52`
151
151
  - Read: [PATTERN.md](patterns/connectors/firebase-messaging/PATTERN.md)
152
152
  - Examples: [example/](patterns/connectors/firebase-messaging/example/)
153
153
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -158,7 +158,7 @@ Compose reviewed Search campaigns with project-owned Google OAuth and portable s
158
158
 
159
159
  - Id: `connectors/google-ads-search`
160
160
  - Keywords: `ads`, `campaigns`, `cli`, `connectors`, `conversion`, `google`, `search`
161
- - Owner: `@jskit-ai/connectors-catalog@0.1.51`
161
+ - Owner: `@jskit-ai/connectors-catalog@0.1.52`
162
162
  - Read: [PATTERN.md](patterns/connectors/google-ads-search/PATTERN.md)
163
163
  - Examples: [example/](patterns/connectors/google-ads-search/example/)
164
164
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -169,7 +169,7 @@ Compose provider consent, verification and encrypted file persistence from an ap
169
169
 
170
170
  - Id: `connectors/oauth-connection`
171
171
  - Keywords: `accounting`, `assistant permissions`, `books`, `cli`, `client credentials`, `connectors`, `consent`, `crm`, `databricks`, `developer token`, `fabric`, `files`, `gaql`, `google ads`, `graphql`, `integrations`, `linkedin`, `microsoft`, `oauth`, `powerpoint`, `salesforce`, `service principal`, `shopify`, `soql`, `staffing`, `tiktok`, `twitch`, `wave`, `word`, `wordpress`, `workday`, `xero`, `zoho`
172
- - Owner: `@jskit-ai/connectors-catalog@0.1.51`
172
+ - Owner: `@jskit-ai/connectors-catalog@0.1.52`
173
173
  - Read: [PATTERN.md](patterns/connectors/oauth-connection/PATTERN.md)
174
174
  - Examples: [example/](patterns/connectors/oauth-connection/example/)
175
175
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -180,7 +180,7 @@ Compose a sequential catalogue batch and preserve partial success for applicatio
180
180
 
181
181
  - Id: `connectors/paddle-catalogue`
182
182
  - Keywords: `batch`, `paddle`, `payments`, `prices`, `products`
183
- - Owner: `@jskit-ai/connectors-catalog@0.1.51`
183
+ - Owner: `@jskit-ai/connectors-catalog@0.1.52`
184
184
  - Read: [PATTERN.md](patterns/connectors/paddle-catalogue/PATTERN.md)
185
185
  - Examples: [example/](patterns/connectors/paddle-catalogue/example/)
186
186
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -191,7 +191,7 @@ Resolve a publishable image key deliberately and use the shared URL library in a
191
191
 
192
192
  - Id: `connectors/public-image`
193
193
  - Keywords: `cli`, `connectors`, `files`, `images`, `integrations`, `logo-dev`, `public-key`
194
- - Owner: `@jskit-ai/connectors-catalog@0.1.51`
194
+ - Owner: `@jskit-ai/connectors-catalog@0.1.52`
195
195
  - Read: [PATTERN.md](patterns/connectors/public-image/PATTERN.md)
196
196
  - Examples: [example/](patterns/connectors/public-image/example/)
197
197
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -202,7 +202,7 @@ Compose file configuration, Redshift Data API operations and application query o
202
202
 
203
203
  - Id: `connectors/redshift-queries`
204
204
  - Keywords: `aws`, `cli`, `connectors`, `files`, `iam`, `provisioned`, `redshift`, `serverless`, `sql`, `warehouse`
205
- - Owner: `@jskit-ai/connectors-catalog@0.1.51`
205
+ - Owner: `@jskit-ai/connectors-catalog@0.1.52`
206
206
  - Read: [PATTERN.md](patterns/connectors/redshift-queries/PATTERN.md)
207
207
  - Examples: [example/](patterns/connectors/redshift-queries/example/)
208
208
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -213,7 +213,7 @@ Use the shared scanner runtime from a CLI or a host worker with portable configu
213
213
 
214
214
  - Id: `connectors/source-scanning`
215
215
  - Keywords: `cancellation`, `cli`, `connectors`, `integrations`, `scanning`, `security`, `source`, `wiz`, `worker`
216
- - Owner: `@jskit-ai/connectors-catalog@0.1.51`
216
+ - Owner: `@jskit-ai/connectors-catalog@0.1.52`
217
217
  - Read: [PATTERN.md](patterns/connectors/source-scanning/PATTERN.md)
218
218
  - Examples: [example/](patterns/connectors/source-scanning/example/)
219
219
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -224,7 +224,7 @@ Add a protected administration surface, settings shell, and semantic navigation
224
224
 
225
225
  - Id: `console/console-surface`
226
226
  - Keywords: `admin`, `console`, `navigation`, `owner`, `placement`, `settings`, `surface`
227
- - Owner: `@jskit-ai/console-web@0.1.202`
227
+ - Owner: `@jskit-ai/console-web@0.1.203`
228
228
  - Read: [PATTERN.md](patterns/console/console-surface/PATTERN.md)
229
229
  - Examples: [example/](patterns/console/console-surface/example/)
230
230
  - Requires: `@jskit-ai/console-core`, `@jskit-ai/console-web`, `@jskit-ai/shell-web`
@@ -235,7 +235,7 @@ Build a routed CRUD user interface as thin application pages over JSKIT's shared
235
235
 
236
236
  - Id: `crud/crud-screen-set`
237
237
  - Keywords: `actions`, `add`, `crud`, `delete`, `edit`, `filters`, `list`, `material`, `routes`, `view`, `vue`
238
- - Owner: `@jskit-ai/http-web@0.1.79`
238
+ - Owner: `@jskit-ai/http-web@0.1.80`
239
239
  - Read: [PATTERN.md](patterns/crud/crud-screen-set/PATTERN.md)
240
240
  - Examples: [example/](patterns/crud/crud-screen-set/example/)
241
241
  - Requires: `@jskit-ai/http-web`, `@jskit-ai/resource-crud-core`
@@ -246,7 +246,7 @@ Build a complete application-owned CRUD server package from a migration, resourc
246
246
 
247
247
  - Id: `crud/json-api-resource-package`
248
248
  - Keywords: `actions`, `crud`, `database`, `json-api`, `migration`, `permissions`, `provider`, `repository`, `routes`, `service`
249
- - Owner: `@jskit-ai/crud-core@0.1.245`
249
+ - Owner: `@jskit-ai/crud-core@0.1.246`
250
250
  - Read: [PATTERN.md](patterns/crud/json-api-resource-package/PATTERN.md)
251
251
  - Examples: [example/](patterns/crud/json-api-resource-package/example/)
252
252
  - Requires: `@jskit-ai/crud-core`, `@jskit-ai/resource-crud-core`
@@ -257,7 +257,7 @@ Define an authenticated application resource whose records belong to the current
257
257
 
258
258
  - Id: `crud/resource-contract`
259
259
  - Keywords: `authenticated`, `crud`, `database`, `owner-scoped`, `resource`, `user`
260
- - Owner: `@jskit-ai/resource-crud-core@0.1.176`
260
+ - Owner: `@jskit-ai/resource-crud-core@0.1.177`
261
261
  - Read: [PATTERN.md](patterns/crud/resource-contract/PATTERN.md)
262
262
  - Examples: [example/](patterns/crud/resource-contract/example/)
263
263
  - Requires: `@jskit-ai/resource-crud-core`
@@ -268,7 +268,7 @@ Configure a JSKIT application for MySQL with a fixed driver, ordinary environmen
268
268
 
269
269
  - Id: `database/mysql-application`
270
270
  - Keywords: `database`, `knex`, `mariadb`, `migrations`, `mysql`, `mysql2`
271
- - Owner: `@jskit-ai/database-runtime-mysql@0.1.232`
271
+ - Owner: `@jskit-ai/database-runtime-mysql@0.1.233`
272
272
  - Read: [PATTERN.md](patterns/database/mysql-application/PATTERN.md)
273
273
  - Examples: [example/](patterns/database/mysql-application/example/)
274
274
  - Requires: `@jskit-ai/database-runtime-mysql`
@@ -279,7 +279,7 @@ Configure a JSKIT application for PostgreSQL with a fixed driver, ordinary envir
279
279
 
280
280
  - Id: `database/postgres-application`
281
281
  - Keywords: `database`, `knex`, `migrations`, `pg`, `postgres`, `postgresql`
282
- - Owner: `@jskit-ai/database-runtime-postgres@0.1.231`
282
+ - Owner: `@jskit-ai/database-runtime-postgres@0.1.232`
283
283
  - Read: [PATTERN.md](patterns/database/postgres-application/PATTERN.md)
284
284
  - Examples: [example/](patterns/database/postgres-application/example/)
285
285
  - Requires: `@jskit-ai/database-runtime-postgres`
@@ -290,7 +290,7 @@ Wrap a JSKIT web application in a Capacitor Android shell using native Capacitor
290
290
 
291
291
  - Id: `mobile/android-application`
292
292
  - Keywords: `android`, `capacitor`, `device`, `mobile`, `native`, `shell`, `webview`
293
- - Owner: `@jskit-ai/mobile-capacitor@0.1.169`
293
+ - Owner: `@jskit-ai/mobile-capacitor@0.1.170`
294
294
  - Read: [PATTERN.md](patterns/mobile/android-application/PATTERN.md)
295
295
  - Examples: [example/](patterns/mobile/android-application/example/)
296
296
  - Requires: `@capacitor/android`, `@capacitor/app`, `@capacitor/cli`, `@jskit-ai/mobile-capacitor`
@@ -301,7 +301,7 @@ Add JSKIT realtime events with an optional Redis backplane and an explicit shell
301
301
 
302
302
  - Id: `realtime/realtime-application`
303
303
  - Keywords: `realtime`, `redis`, `socket.io`, `sockets`, `status`, `websocket`
304
- - Owner: `@jskit-ai/realtime@0.1.231`
304
+ - Owner: `@jskit-ai/realtime@0.1.232`
305
305
  - Read: [PATTERN.md](patterns/realtime/realtime-application/PATTERN.md)
306
306
  - Examples: [example/](patterns/realtime/realtime-application/example/)
307
307
  - Requires: `@jskit-ai/realtime`, `@jskit-ai/shell-web`
@@ -312,7 +312,7 @@ Compose application-owned Google Publisher Tag delivery with the generic rewarde
312
312
 
313
313
  - Id: `rewards/google-rewarded`
314
314
  - Keywords: `ads`, `google`, `publisher tag`, `rewarded`, `unlock`
315
- - Owner: `@jskit-ai/rewarded-web@0.1.170`
315
+ - Owner: `@jskit-ai/rewarded-web@0.1.171`
316
316
  - Read: [PATTERN.md](patterns/rewards/google-rewarded/PATTERN.md)
317
317
  - Examples: [example/](patterns/rewards/google-rewarded/example/)
318
318
  - Requires: `@jskit-ai/rewarded-web`
@@ -323,7 +323,7 @@ Define a server feature through explicit capabilities and first-class actions, a
323
323
 
324
324
  - Id: `server/feature-package`
325
325
  - Keywords: `actions`, `feature`, `json-rest`, `knex`, `orchestration`, `package`, `provider`, `repository`, `routes`, `server`
326
- - Owner: `@jskit-ai/agent-docs@0.1.206`
326
+ - Owner: `@jskit-ai/agent-docs@0.1.207`
327
327
  - Read: [PATTERN.md](patterns/server/feature-package/PATTERN.md)
328
328
  - Examples: [example/](patterns/server/feature-package/example/)
329
329
  - Requires: `@jskit-ai/kernel`
@@ -334,7 +334,7 @@ Compose the JSKIT responsive shell, semantic placements, settings navigation, an
334
334
 
335
335
  - Id: `shell/application-shell`
336
336
  - Keywords: `adaptive`, `app`, `layout`, `navigation`, `placement`, `responsive`, `settings`, `shell`
337
- - Owner: `@jskit-ai/shell-web@0.1.238`
337
+ - Owner: `@jskit-ai/shell-web@0.1.239`
338
338
  - Read: [PATTERN.md](patterns/shell/application-shell/PATTERN.md)
339
339
  - Examples: [example/](patterns/shell/application-shell/example/)
340
340
  - Requires: `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -345,7 +345,7 @@ Add product routes and shell extensions through file routing, semantic placement
345
345
 
346
346
  - Id: `ui/page-and-placement`
347
347
  - Keywords: `component`, `navigation`, `outlet`, `page`, `placement`, `routes`, `section`, `shell`, `subpages`, `vue`
348
- - Owner: `@jskit-ai/shell-web@0.1.238`
348
+ - Owner: `@jskit-ai/shell-web@0.1.239`
349
349
  - Read: [PATTERN.md](patterns/ui/page-and-placement/PATTERN.md)
350
350
  - Examples: [example/](patterns/ui/page-and-placement/example/)
351
351
  - Requires: `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -356,7 +356,7 @@ Compose an account settings route and profile, preference, and notification sect
356
356
 
357
357
  - Id: `users/account-settings`
358
358
  - Keywords: `account`, `notifications`, `preferences`, `profile`, `settings`, `user`, `vue`
359
- - Owner: `@jskit-ai/users-web@0.1.252`
359
+ - Owner: `@jskit-ai/users-web@0.1.253`
360
360
  - Read: [PATTERN.md](patterns/users/account-settings/PATTERN.md)
361
361
  - Examples: [example/](patterns/users/account-settings/example/)
362
362
  - Requires: `@jskit-ai/shell-web`, `@jskit-ai/users-core`, `@jskit-ai/users-web`
@@ -367,7 +367,7 @@ Expose user administration and workspace-scoped member operations through app-ow
367
367
 
368
368
  - Id: `users/user-administration-server`
369
369
  - Keywords: `account`, `admin`, `member`, `repository`, `resource`, `routes`, `service`, `user`, `workspace`
370
- - Owner: `@jskit-ai/users-core@0.1.247`
370
+ - Owner: `@jskit-ai/users-core@0.1.248`
371
371
  - Read: [PATTERN.md](patterns/users/user-administration-server/PATTERN.md)
372
372
  - Examples: [example/](patterns/users/user-administration-server/example/)
373
373
  - Requires: `@jskit-ai/crud-core`, `@jskit-ai/users-core`
@@ -378,7 +378,7 @@ Configure roles, workspace access policy, invitations, and app-owned invitation
378
378
 
379
379
  - Id: `workspaces/workspace-server`
380
380
  - Keywords: `access`, `invite`, `membership`, `multitenancy`, `policy`, `role`, `tenancy`, `workspace`
381
- - Owner: `@jskit-ai/workspaces-core@0.1.212`
381
+ - Owner: `@jskit-ai/workspaces-core@0.1.213`
382
382
  - Read: [PATTERN.md](patterns/workspaces/workspace-server/PATTERN.md)
383
383
  - Examples: [example/](patterns/workspaces/workspace-server/example/)
384
384
  - Requires: `@jskit-ai/users-core`, `@jskit-ai/workspaces-core`
@@ -389,7 +389,7 @@ Compose workspace selection, invitation, member administration, settings, and re
389
389
 
390
390
  - Id: `workspaces/workspace-surfaces`
391
391
  - Keywords: `admin`, `invite`, `member`, `navigation`, `settings`, `surface`, `switcher`, `workspace`
392
- - Owner: `@jskit-ai/workspaces-web@0.1.213`
392
+ - Owner: `@jskit-ai/workspaces-web@0.1.214`
393
393
  - Read: [PATTERN.md](patterns/workspaces/workspace-surfaces/PATTERN.md)
394
394
  - Examples: [example/](patterns/workspaces/workspace-surfaces/example/)
395
395
  - Requires: `@jskit-ai/shell-web`, `@jskit-ai/workspaces-core`, `@jskit-ai/workspaces-web`
@@ -34,7 +34,7 @@
34
34
  "dependencies": {
35
35
  "@local/main": "0.1.0",
36
36
  "@fastify/static": "^10.1.3",
37
- "@jskit-ai/kernel": "0.1.234",
37
+ "@jskit-ai/kernel": "0.1.235",
38
38
  "@tanstack/vue-query": "^5.101.0",
39
39
  "fastify": "^5.8.5",
40
40
  "json-rest-schema": "^1.0.17",
@@ -42,13 +42,13 @@
42
42
  "vue": "^3.5.43",
43
43
  "vue-router": "^5.3.1",
44
44
  "vuetify": "^4.1.2",
45
- "@jskit-ai/http-runtime": "0.1.232",
45
+ "@jskit-ai/http-runtime": "0.1.233",
46
46
  "@fastify/fast-json-stringify-compiler": "^5.1.0",
47
47
  "@vue/devtools-api": "^8.2.1"
48
48
  },
49
49
  "devDependencies": {
50
- "@jskit-ai/config-eslint": "0.1.231",
51
- "@jskit-ai/jskit-catalog": "0.1.259",
50
+ "@jskit-ai/config-eslint": "0.1.232",
51
+ "@jskit-ai/jskit-catalog": "0.1.260",
52
52
  "@playwright/test": "1.61.1",
53
53
  "@vitejs/plugin-vue": "^6.0.7",
54
54
  "eslint": "^10.8.0",
@@ -34,7 +34,7 @@
34
34
  "dependencies": {
35
35
  "@local/main": "0.1.0",
36
36
  "@fastify/static": "^10.1.3",
37
- "@jskit-ai/kernel": "0.1.234",
37
+ "@jskit-ai/kernel": "0.1.235",
38
38
  "@tanstack/vue-query": "^5.101.0",
39
39
  "fastify": "^5.8.5",
40
40
  "json-rest-schema": "^1.0.17",
@@ -42,15 +42,15 @@
42
42
  "vue": "^3.5.43",
43
43
  "vue-router": "^5.3.1",
44
44
  "vuetify": "^4.1.2",
45
- "@jskit-ai/http-runtime": "0.1.232",
45
+ "@jskit-ai/http-runtime": "0.1.233",
46
46
  "@mdi/js": "^7.4.47",
47
- "@jskit-ai/shell-web": "0.1.238",
47
+ "@jskit-ai/shell-web": "0.1.239",
48
48
  "@fastify/fast-json-stringify-compiler": "^5.1.0",
49
49
  "@vue/devtools-api": "^8.2.1"
50
50
  },
51
51
  "devDependencies": {
52
- "@jskit-ai/config-eslint": "0.1.231",
53
- "@jskit-ai/jskit-catalog": "0.1.259",
52
+ "@jskit-ai/config-eslint": "0.1.232",
53
+ "@jskit-ai/jskit-catalog": "0.1.260",
54
54
  "@playwright/test": "1.61.1",
55
55
  "@vitejs/plugin-vue": "^6.0.7",
56
56
  "eslint": "^10.8.0",
@@ -9,7 +9,7 @@
9
9
  },
10
10
  "description": "App-local runtime composition and lightweight glue.",
11
11
  "dependencies": {
12
- "@jskit-ai/kernel": "0.1.234"
12
+ "@jskit-ai/kernel": "0.1.235"
13
13
  },
14
14
  "jskit": {
15
15
  "kind": "runtime",
@@ -2,6 +2,6 @@
2
2
  "private": true,
3
3
  "type": "module",
4
4
  "dependencies": {
5
- "@jskit-ai/auth-provider-supabase-core": "0.1.231"
5
+ "@jskit-ai/auth-provider-supabase-core": "0.1.232"
6
6
  }
7
7
  }
@@ -7,10 +7,10 @@
7
7
  "db:migrate:status": "knex --knexfile ./knexfile.js migrate:list"
8
8
  },
9
9
  "dependencies": {
10
- "@jskit-ai/connectors-core": "0.1.51",
11
- "@jskit-ai/connector-google-calendar": "0.1.51",
12
- "@jskit-ai/database-runtime": "0.1.234",
13
- "@jskit-ai/database-runtime-mysql": "0.1.232",
10
+ "@jskit-ai/connectors-core": "0.1.52",
11
+ "@jskit-ai/connector-google-calendar": "0.1.52",
12
+ "@jskit-ai/database-runtime": "0.1.235",
13
+ "@jskit-ai/database-runtime-mysql": "0.1.233",
14
14
  "knex": "^3.1.0"
15
15
  }
16
16
  }
@@ -42,6 +42,13 @@ questionnaire.
42
42
  - Resource-load errors stay inside the screen with retry. Command success and
43
43
  failure use JSKIT's shared toast/snackbar feedback path.
44
44
  - URLs are route templates or route objects resolved through the screen runtime.
45
+ - Browser URL templates include the configured surface prefix; unlike API
46
+ suffixes, `/new` and `/` are absolute browser paths. Use the complete route or
47
+ `paths.page()` for a link without record placeholders, and the owning CRUD
48
+ runtime's `resolveParams()` for record placeholders.
49
+ - `CrudListScreen` applies `createLabel` to all create actions. Its responsive
50
+ card and table layouts both remain in the DOM; Playwright text assertions
51
+ should filter to visible matches rather than match a hidden layout too.
45
52
  - Product field components are ordinary application source.
46
53
  - Query keys and placement sources describe the resource, not an authoring tool.
47
54
  - No generated-file markers, overwrite contracts, receipts, or provenance remain.
@@ -69,6 +76,14 @@ id (or a distinct new-record marker) so form cache entries stay separate.
69
76
  The New/Edit examples supply it; list/view screen wrappers derive their
70
77
  standard keys from `resourceNamespace`.
71
78
 
79
+ Save navigation is configured in the top-level `saveSuccess` object. The default
80
+ prefers a configured record-view URL, then the list. A create-and-list variation
81
+ sets `navigateToView: false` and `listUrlTemplate` to its list route. Set both
82
+ `navigateToView` and `navigateToList` to `false` to stay on the form. A custom
83
+ `addEditOptions.onSaveSuccess` replaces default invalidation and navigation;
84
+ it is unnecessary for ordinary list navigation. The generic CRUD guide explains
85
+ this contract under **Save navigation**.
86
+
72
87
  Ownership and permission-bootstrap mode are different options. For a public
73
88
  resource on a public surface, use `ownershipFilter: "public"` in form options
74
89
  or lower-level request composables. List/view screen wrappers derive request
@@ -145,6 +145,11 @@ const BookingsFeature = defineCrudJsonApiFeature({
145
145
  when both drivers are supported by the application.
146
146
  - Validate representative accepted and rejected resource values.
147
147
  - Exercise every enabled route and JSON API document shape.
148
+ - Direct HTTP tests send `Content-Type` and `Accept` as
149
+ `application/vnd.api+json`, with `data.type` and `data.attributes`; raw
150
+ response fields remain in `data.attributes`. Use the configured API route,
151
+ transport type and existing identity/CSRF fixture. The generic CRUD guide's
152
+ **Direct API tests use JSON:API documents** section has a complete example.
148
153
  - Prove positive owner access and negative cross-owner access.
149
154
  - Verify public routes require neither identity nor CSRF only when explicitly
150
155
  declared public.
@@ -8,8 +8,8 @@
8
8
  "./shared": "./src/shared/index.js"
9
9
  },
10
10
  "dependencies": {
11
- "@jskit-ai/crud-core": "0.1.245",
12
- "@jskit-ai/resource-crud-core": "0.1.176"
11
+ "@jskit-ai/crud-core": "0.1.246",
12
+ "@jskit-ai/resource-crud-core": "0.1.177"
13
13
  },
14
14
  "jskit": {
15
15
  "kind": "runtime",
@@ -8,6 +8,6 @@
8
8
  "db:migrate:status": "knex --knexfile ./knexfile.js migrate:list"
9
9
  },
10
10
  "dependencies": {
11
- "@jskit-ai/database-runtime-mysql": "0.1.232"
11
+ "@jskit-ai/database-runtime-mysql": "0.1.233"
12
12
  }
13
13
  }
@@ -8,6 +8,6 @@
8
8
  "db:migrate:status": "knex --knexfile ./knexfile.js migrate:list"
9
9
  },
10
10
  "dependencies": {
11
- "@jskit-ai/database-runtime-postgres": "0.1.231"
11
+ "@jskit-ai/database-runtime-postgres": "0.1.232"
12
12
  }
13
13
  }
@@ -2,7 +2,7 @@
2
2
  "private": true,
3
3
  "type": "module",
4
4
  "dependencies": {
5
- "@jskit-ai/realtime": "0.1.231",
6
- "@jskit-ai/shell-web": "0.1.238"
5
+ "@jskit-ai/realtime": "0.1.232",
6
+ "@jskit-ai/shell-web": "0.1.239"
7
7
  }
8
8
  }
@@ -5,7 +5,7 @@
5
5
  "private": true,
6
6
  "type": "module",
7
7
  "dependencies": {
8
- "@jskit-ai/kernel": "0.1.234",
8
+ "@jskit-ai/kernel": "0.1.235",
9
9
  "json-rest-schema": "^1.0.17"
10
10
  },
11
11
  "exports": {
@@ -9,8 +9,8 @@
9
9
  "./shared": "./src/shared/index.js"
10
10
  },
11
11
  "dependencies": {
12
- "@jskit-ai/crud-core": "0.1.245",
13
- "@jskit-ai/resource-crud-core": "0.1.176"
12
+ "@jskit-ai/crud-core": "0.1.246",
13
+ "@jskit-ai/resource-crud-core": "0.1.177"
14
14
  },
15
15
  "jskit": {
16
16
  "kind": "runtime",
@@ -9,9 +9,9 @@
9
9
  "./shared": "./src/shared/index.js"
10
10
  },
11
11
  "dependencies": {
12
- "@jskit-ai/crud-core": "0.1.245",
13
- "@jskit-ai/resource-crud-core": "0.1.176",
14
- "@jskit-ai/workspaces-core": "0.1.212"
12
+ "@jskit-ai/crud-core": "0.1.246",
13
+ "@jskit-ai/resource-crud-core": "0.1.177",
14
+ "@jskit-ai/workspaces-core": "0.1.213"
15
15
  },
16
16
  "jskit": {
17
17
  "kind": "runtime",