@jskit-ai/agent-docs 0.1.101 → 0.1.103

package/guide/agent/app-setup/database-layer.md

@@ -96,6 +96,16 @@ The app has two different migration-related layers:
 
 Those are **not** the same step.
 
+There is also an important ownership distinction:
+
+- a CRUD generator owns the installed baseline migration for the table it
+  scaffolds
+- the table's app-local package owns later additive schema evolution
+
+Never modify or replace a generator-owned baseline migration. Later schema
+evolution must use a new immutable, package-owned additive migration in the
+table's app-local package, declared through `install-migration`.
+
 The npm scripts hide the easy-to-miss first step for normal use. `npm run db:migrate` and `npm run db:migrate:status` run `npm run db:migrations:sync` first, then run Knex. That means package upgrades can add new JSKIT-managed migration files before Knex checks what is pending.
 
 ### `jskit migrations ...` writes managed migration files
@@ -157,6 +167,52 @@ So:
 - sometimes you need only `npm run db:migrate`
 - sometimes, after repair or re-materialization work, you need **both**
 
+### Authoring a later app-owned schema change
+
+When an existing CRUD-owned table needs a new column, constraint, index, or
+other compatible evolution, keep the generated baseline unchanged. Ask JSKIT
+to create a new migration source in the app-local package that owns the table:
+
+```bash
+npx jskit create migration \
+  --package @local/workflow-record-report-values \
+  --id extend-report-value-field-types
+```
+
+This command:
+
+1. verifies that the owner is an installed app-local package
+2. rejects duplicate or unsafe migration ids
+3. creates an editable template under the package's
+   `templates/migrations/` directory
+4. adds the matching `install-migration` mutation to the package descriptor
+5. leaves the migration unmaterialized so its implementation can still be
+   completed
+
+Implement and test the template first. It intentionally fails if someone tries
+to apply the untouched scaffold. Then materialize and apply it:
+
+```bash
+npx jskit migrations package @local/workflow-record-report-values
+npm run db:migrate
+```
+
+The materialized migration and its lock record are managed artifacts. Once
+installed, the migration id and content are immutable. Any later correction
+must use another additive migration with a new id.
+
+SQL inside the source-controlled migration is supported when Knex does not
+express the required schema operation directly. Ad-hoc SQL applied only to a
+development or live database is not a migration and must not be used: it
+creates schema drift, breaks fresh reconstruction, and leaves deployment
+history incomplete.
+
+Before completion, exercise the complete migration chain against a fresh
+disposable database as well as the intended upgrade path. A down migration
+must refuse safely when narrowing the schema would invalidate existing data;
+it must never delete or silently transform valuable rows merely to make a
+rollback pass.
+
 ### Shared database helpers
 
 The database layer also gives later server code a shared helper surface:

package/guide/agent/generators/crud-generators.md

@@ -286,6 +286,25 @@ The exact fields will vary by app. What matters for the generator is:
 - the column names are stable enough to become part of your app's resource contract
 - if you are using `crud-server-generator`, do **not** hand-write a separate CRUD migration for this table; the server generator installs the CRUD migration scaffold itself
 
+That last rule governs the generated baseline, not every future schema change.
+Never modify or replace a generator-owned baseline migration after it has been
+installed. Later schema evolution must use a new immutable, package-owned
+additive migration in the table's app-local package, declared through
+`install-migration`.
+
+Create that source and descriptor mutation together with:
+
+```bash
+npx jskit create migration \
+  --package @local/contacts \
+  --id add-contact-status
+```
+
+Implement the generated template before running
+`npx jskit migrations package @local/contacts`. SQL or Knex schema operations
+inside the source-controlled migration are supported. Running ad-hoc SQL
+against only one database is not, because it creates schema drift.
+
 In this table, `workspace_id` is the important ownership clue. That is why the next step uses:
 
 ```bash
@@ -425,6 +444,31 @@ That creates the baseline CRUD route tree:
 - `w/[workspaceSlug]/admin/contacts/[contactId]/edit.vue`
 - shared `_components` files under the same route root
 
+Generated list, view, and lookup reads use the resource contract as their
+response authority. They return every field declared for output by default,
+including the target resource's declared output when a lookup relation is
+hydrated; generated pages do not repeat those fields in a second page-owned
+allowlist. Adding an output field or lookup to the resource therefore does not
+require regenerating endpoint projections.
+
+Put exceptional large fields in the resource-owned default response blacklist,
+`resource.contract.response.defaultExclude`:
+
+```js
+contract: {
+  response: {
+    defaultExclude: ["rawPayload", "largeAuditJson"]
+  }
+}
+```
+
+Each included resource applies its own blacklist. A default-excluded field is
+still part of the public output contract and can be requested through an
+explicit typed JSON:API `fields[type]` fieldset. Use that sparse-field override
+only for a specialised caller; do not add one to ordinary generated pages or
+build a page-local query-string adapter. Fields that must never be exposed do
+not belong in the output schema at all.
+
 This is the most important mental model in the whole chapter:
 
 - `crud-server-generator` creates the reusable CRUD contract and server package

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/agent-docs",
-  "version": "0.1.101",
+  "version": "0.1.103",
   "description": "Distributed JSKIT agent references, prompts, guides, and generated reference maps.",
   "type": "module",
   "files": [

package/patterns/client-requests.md

@@ -49,6 +49,7 @@ Generated screen wrapper extension rules:
 - Use `useCrudListScreen({ readEnabled })` for permission-gated generated list reads instead of splitting the page or replacing the shared list screen.
 - Use `useCrudListScreen({ requestQueryParams })` for list includes or other endpoint query params instead of putting query strings in `apiSuffix`.
 - Use `useCrudViewScreen({ requestQueryParams })` for detail includes instead of putting query strings in `apiUrlTemplate`.
+- Use `requestFieldsets` only when a specialised caller intentionally needs a typed JSON:API sparse fieldset. Ordinary generated reads use the complete resource output contract.
 - Use `readEnabled` and `queryKeyFactory` on `useCrudViewScreen()` when the detail read needs the same gating or cache identity control as `useCrudView()`.
 - Use `CrudViewScreen` slots (`before-fields`, `fields`, `after-fields`, `supporting-content`) for page-specific domain sections while keeping shared load/error/retry chrome.
 - Use `listRowActions` with `defineCrudListRowActions(...)` for row-level commands in `CrudListScreen`.
@@ -72,6 +73,11 @@ Why this is the standard JSKIT shape:
 - `usersWebHttpClient` already handles credentials and CSRF behavior.
 - `useEndpointResource()` is the shared endpoint primitive for loading, saving, and standard load/save error handling. Higher-level runtimes add UI feedback and field-error handling on top.
 - Use `requestQueryParams` for endpoint query strings on list, view, and add/edit runtimes.
+- Generated CRUD and lookup reads use all resource-defined output fields by default. Hydrated relationships use the target resource's output contract. Generated pages and lookup controls do not repeat those definitions as request fieldsets.
+- Put exceptional large fields in `resource.contract.response.defaultExclude`. The target resource owns that default even when it is included by another resource.
+- `requestFieldsets` remains an explicit specialised override and accepts the canonical typed shape, for example `{ jobs: ["id", "status"], contacts: ["id", "displayName"] }`. It participates in both the request and the query cache key.
+- Sparse fieldsets are a serialization boundary, not an authorization mechanism. Server resources reject unknown fields, never serialize hidden fields, and preserve the fields needed internally for relationship linkage.
+- Fields that must never be exposed do not belong in the resource output schema.
 - Keep `apiUrlTemplate` path-only. Do not put `?include=...` or other query strings in URL templates.
 - If an app needs route-aware API URL rewriting, configure the users-web client once with `configureUsersWebHttpClient({ resolveRequestUrl })` before mounting the app. Do not replace `fetchImpl` just to rewrite paths.
 - `resolveRequestUrl` belongs at the HTTP client boundary. It runs after JSKIT encodes query params and before browser `fetch`, so reads, commands, request recovery metadata, JSON:API transport, credentials, and CSRF behavior stay on the standard path.
@@ -96,6 +102,8 @@ Avoid:
 - manually concatenating scoped route params into API URLs
 - using a lower-level seam when a higher-level routed CRUD or command runtime already fits
 - smuggling query params into `apiUrlTemplate`
+- hand-building `fields[type]` parameters or page-local sparse-response adapters
+- repeating resource output fields as page-owned request allowlists
 - replacing `CrudListScreen` or `CrudViewScreen` only to add read gating, row actions, synthetic display rows, includes, or domain detail sections
 - reporting routine resource load errors through hand-written global snackbar/banner calls
 - calling `useShellRequestRecoveryRuntime().report(...)` from normal panels just to recover an HTTP read

package/patterns/crud-scaffolding.md

@@ -51,6 +51,9 @@ Rules:
 - If the table should already be CRUD-owned but should not expose public CRUD HTTP routes yet, scaffold it with `jskit generate crud-server-generator scaffold ... --internal` instead of dropping to direct knex or a hand-built pseudo-repository.
 - Create the real table directly in the database before scaffolding. `crud-server-generator` reads the live table shape.
 - If `crud-server-generator` is going to own the CRUD, do not hand-write a separate CRUD migration for that table. The generator installs and manages the CRUD migration scaffold itself.
+- Never modify or replace a generator-owned baseline migration after it has
+  been installed. Later schema evolution must use a new immutable,
+  package-owned additive migration declared through `install-migration`.
 - Keep generated table creation in `migrations/` and generated foreign keys in
   `migrations/constraints/`. The database runtime deliberately runs those
   phases in that order so valid mutual foreign keys rebuild cleanly without
@@ -72,6 +75,38 @@ Rules:
 - Structured filters should use shared filter definitions and collapse to compact filter controls/sheets when they outgrow simple search. Do not stack dense desktop filter bars on phone widths.
 - Use `--navigation-role` for CRUD list placement intent. Main resources can stay `primary`; nested/detail/workflow CRUD routes should usually be `secondary`, `workflow`, or `none`.
 
+## Baseline generation versus later schema evolution
+
+The initial CRUD scaffold and a later schema change are different operations:
+
+- The server generator owns the baseline migration that recreates the table
+  from zero. Do not edit, replace, or regenerate that installed baseline to
+  express a later change.
+- The table's app-local package owns later schema evolution. Create each change
+  as a new immutable additive migration:
+
+  ```bash
+  npx jskit create migration \
+    --package @local/workflow-record-report-values \
+    --id extend-report-value-field-types
+  ```
+
+- The authoring command creates an editable migration template and adds its
+  `install-migration` mutation to the owning package descriptor in one
+  operation. Implement and test the template before materializing it.
+- Materialize the completed source with
+  `npx jskit migrations package <package-id>`, then apply it with
+  `npm run db:migrate`.
+- SQL or Knex schema operations inside that source-controlled migration are
+  supported. Ad-hoc SQL applied only to one database is not: it creates schema
+  drift and leaves fresh installations incorrect.
+- Installed migration ids and content are immutable. A correction to an
+  installed migration is another additive migration with a new id.
+
+A package-owned additive migration is not the prohibited "separate CRUD
+migration." The prohibition applies to competing with or modifying the
+generator-owned baseline.
+
 Meaning of `--internal`:
 
 - it keeps the generated repository, service, actions, provider, resource, and CRUD migration ownership chain

package/patterns/filters.md

@@ -13,6 +13,7 @@ Ask first:
 - which fields are filterable
 - whether each filter is a flag, enum, multi-enum, date/date-range, number-range, record id, or lookup-backed record id
 - whether filters must sync to the route query
+- whether a filter needs a default before the first request
 - whether the screen needs chips and clear/reset behavior
 - whether lookup filters need remote autocomplete search
 - whether there are presets such as "Today", "Last 7 Days", or "Only Archived"
@@ -25,6 +26,27 @@ Default JSKIT client pattern:
 5. The AI/app author is responsible for ensuring the server accepts and applies the query params declared in `listFilters.js`.
 6. For lookup-backed filters, use `useCrudListFilterLookups(...)` when the page needs remote options or readable chip labels.
 
+Initial-value contract:
+- declare a pre-query default with `defaultValue` in the filter definition
+- a valid route-query value wins over `defaultValue`
+- when the initial route has no value, `defaultValue` is applied before list reading is enabled
+- an invalid initial route value falls back to `defaultValue`
+- clearing a filter after initialization produces the empty value; it does not reapply the default
+- route back/forward navigation rehydrates the same filter state without an early unfiltered request
+
+```js
+const listFilters = defineCrudListFilters({
+  currentness: {
+    type: "enum",
+    defaultValue: "active",
+    options: [
+      { value: "active", label: "Active" },
+      { value: "archived", label: "Archived" }
+    ]
+  }
+});
+```
+
 Generated client shape:
 - `src/pages/<surface>/<resource>/listFilters.js`
 - `const listFilters = defineCrudListFilters({ ... })`
@@ -94,6 +116,7 @@ Avoid:
 - editing generated `.vue` files just to add basic filter controls; use the page-local `listFilters.js` seam first
 - overloading `q` with structured filter meaning
 - inline filter-definition objects passed into `useCrudListFilters(...)`, `createCrudListFilters(...)`, or `createCrudListFilterContract(...)`; keep definitions in a named module
+- assigning a default to `filterRuntime.values` after `useCrudListScreen(...)` has started; that changes the query after construction and can issue a second initial request
 
 Good shape:
 - `src/pages/home/customers/listFilters.js`
@@ -117,5 +140,6 @@ Review checks:
 - one filter definition source of truth: generated page-local `listFilters.js` for client-only filters, or a shared CRUD-package module when server code imports the same definitions
 - server validator, JSON REST search schema, and repository query projection derived from that source through `createCrudListFilterContract(...)`
 - client query params/chips/reset logic derived from that source
+- initial route/default resolution completes before the first list request
 - lookup-backed filters use the shared lookup helper, not a page-local mini-framework
 - the two-phase server exception is intentional and documented, not accidental drift

package/reference/autogen/KERNEL_MAP.md

@@ -64,6 +64,7 @@ Exports
 - `parseCrudListRangeQueryExpression(value = null)`
 - `formatCrudListRangeQueryExpression(startValue = "", endValue = "", { collapseExact = false } = {})`
 - `defineCrudListFilters(definitions = {})`
+- `createCrudListFilterEmptyValue(filter = {})`
 - `createCrudListFilterInitialValue(filter = {})`
 - `isCrudListFilterMultiValue(filter = {})`
 - `isCrudListFilterStructuredValue(filter = {})`
@@ -171,6 +172,12 @@ Exports
 - `shouldRetryTransientQueryFailure`
 - `transientQueryRetryDelay`
 
+### `support/jsonApiFieldsets.js`
+Exports
+- `normalizeJsonApiFieldList(value = [])`
+- `normalizeJsonApiFieldsets(value = {}, { primaryType = "" } = {})`
+- `buildJsonApiFieldsetsToken(value = {})`
+
 ### `support/linkPath.js`
 Exports
 - `isExternalLinkTarget(target = "")`

package/reference/autogen/packages/crud-core.md

@@ -165,6 +165,7 @@ Exports
 - `createCrudCursorPaginationQueryValidator(list = {})`
 - `listSearchQueryValidator`
 - `lookupIncludeQueryValidator`
+- `jsonApiFieldsetsQueryValidator`
 - `resolveCrudParentFilterKeys(resource = {})`
 - `createCrudParentFilterQueryValidator(resource = {})`
 Local functions

package/reference/autogen/packages/http-runtime.md

@@ -247,6 +247,9 @@ Local functions
 - `isRecord(value)`
 - `normalizeQueryKey(key = "")`
 - `buildFieldsTransportKey(responseType = "")`
+- `parseFieldsTransportType(key = "")`
+- `addJsonApiFieldset(fieldsets, type = "", value = [])`
+- `createJsonApiFieldsTransportValueSchema()`
 - `normalizeTransportQueryScalar(value)`
 
 ### `src/shared/validators/jsonApiResponses.js`
@@ -272,18 +275,18 @@ Local functions
 ### `src/shared/validators/jsonApiRouteTransport.js`
 Exports
 - `JSON_API_ERROR_DOCUMENT_SCHEMA`
-- `createJsonApiResourceObjectTransportSchema({ type = "", attributes, requireId = true, includeLinks = false, includeMeta = false, excludeAttributeKeys = [], relationshipEntries = [], relationshipMembersRequired = false } = {})`
+- `createJsonApiResourceObjectTransportSchema({ type = "", attributes, requireId = true, includeLinks = false, includeMeta = false, excludeAttributeKeys = [], relationshipEntries = [], relationshipMembersRequired = false, allowSparseFields = false } = {})`
 - `createJsonApiResourceRequestBodyTransportSchema({ type = "", attributes, requireId = false, excludeAttributeKeys = [], relationshipEntries = [] } = {})`
-- `createJsonApiResourceSuccessTransportSchema({ type = "", attributes, kind = "record", includeLinks = false, includeMeta = false, includeIncluded = false, excludeAttributeKeys = [], relationshipEntries = [] } = {})`
+- `createJsonApiResourceSuccessTransportSchema({ type = "", attributes, kind = "record", includeLinks = false, includeMeta = false, includeIncluded = false, allowSparseFields = false, excludeAttributeKeys = [], relationshipEntries = [] } = {})`
 - `withJsonApiErrorResponses(successResponses, { includeValidation400 = false } = {})`
 - `createJsonApiResourceRouteTransport({ type = "", requestType = "", responseType = "", query = null, allowBodyId = false, successKind = "record", pointerPrefix = "/data/attributes", mapRequestRelationships = null, getRecordType = null, getRecordId = null, getRecordAttributes = null, getRecordRelationships = null, getRecordLinks = null, getRecordMeta = null, getIncluded = null, getDocumentLinks = null, getDocumentMeta = null, getCollectionItems = null } = {})`
-- `createJsonApiResourceRouteContract({ type = "", requestType = "", responseType = "", body = null, query = null, output = null, outputKind = "record", successStatus = 200, includeValidation400 = false, allowBodyId = false, pointerPrefix = "/data/attributes", bodyAttributeExcludeKeys = [], outputAttributeExcludeKeys = [], bodyRelationshipEntries = [], outputRelationshipEntries = [], getRecordType = null, getRecordId = null, getRecordAttributes = null, getRecordRelationships = null, getRecordLinks = null, getRecordMeta = null, getIncluded = null, getDocumentLinks = null, getDocumentMeta = null, getCollectionItems = null, mapRequestRelationships = null } = {})`
+- `createJsonApiResourceRouteContract({ type = "", requestType = "", responseType = "", body = null, query = null, output = null, outputKind = "record", successStatus = 200, includeValidation400 = false, allowSparseFields = false, allowBodyId = false, pointerPrefix = "/data/attributes", bodyAttributeExcludeKeys = [], outputAttributeExcludeKeys = [], bodyRelationshipEntries = [], outputRelationshipEntries = [], getRecordType = null, getRecordId = null, getRecordAttributes = null, getRecordRelationships = null, getRecordLinks = null, getRecordMeta = null, getIncluded = null, getDocumentLinks = null, getDocumentMeta = null, getCollectionItems = null, mapRequestRelationships = null } = {})`
 Local functions
 - `isRecord(value)`
 - `createJsonApiTransportError(statusCode, message, code)`
 - `resolveRouteType(type = "")`
 - `resolveRouteTypes(value = {})`
-- `resolveEmbeddedAttributesTransportSchema(definition, { context = "JSON:API resource", defaultMode = "replace", removeId = false, removeKeys = [] } = {})`
+- `resolveEmbeddedAttributesTransportSchema(definition, { context = "JSON:API resource", defaultMode = "replace", removeId = false, removeKeys = [], allowSparseFields = false } = {})`
 - `normalizeRelationshipSchemaEntries(entries = [])`
 - `createJsonApiRelationshipDataSchema(relationshipType = "", { many = false, nullable = false } = {})`
 - `createJsonApiRelationshipsTransportSchema(entries = [], { includeRequired = false } = {})`

package/reference/autogen/packages/json-rest-api-core.md

@@ -31,6 +31,7 @@ Exports
 - `extractJsonRestCollectionRows(payload = null)`
 - `isJsonRestResourceMissingError(error = null)`
 - `returnNullWhenJsonRestResourceMissing(run)`
+- `returnBadRequestWhenJsonRestFieldsetInvalid(run)`
 - `resolveWorkspaceScopeValue(context = null)`
 - `resolveUserScopeValue(context = null)`
 - `createJsonRestApiHost({ knex })`
@@ -47,7 +48,10 @@ Local functions
 - `normalizeJsonRestQueryField(fieldName = "", fieldDefinition = {}, projectionDefinition = null)`
 - `isJsonRestVirtualField(fieldDefinition = null)`
 - `applyJsonRestQueryFields(scopeOptions = {}, extraQueryFields = {})`
+- `resolveJsonRestDefaultExcludedFields(resource = {})`
+- `applyJsonRestDefaultExclusions(scopeOptions = {}, resource = {})`
 - `extractJsonApiInputRelationships(attributes = {}, resource = null, relationships = null)`
+- `isJsonRestSparseFieldError(error = null)`
 
 ### root
 

package/reference/autogen/packages/kernel.md

@@ -229,6 +229,7 @@ Exports
 - `parseCrudListRangeQueryExpression(value = null)`
 - `formatCrudListRangeQueryExpression(startValue = "", endValue = "", { collapseExact = false } = {})`
 - `defineCrudListFilters(definitions = {})`
+- `createCrudListFilterEmptyValue(filter = {})`
 - `createCrudListFilterInitialValue(filter = {})`
 - `isCrudListFilterMultiValue(filter = {})`
 - `isCrudListFilterStructuredValue(filter = {})`
@@ -336,6 +337,12 @@ Exports
 - `shouldRetryTransientQueryFailure`
 - `transientQueryRetryDelay`
 
+### `shared/support/jsonApiFieldsets.js`
+Exports
+- `normalizeJsonApiFieldList(value = [])`
+- `normalizeJsonApiFieldsets(value = {}, { primaryType = "" } = {})`
+- `buildJsonApiFieldsetsToken(value = {})`
+
 ### `shared/support/linkPath.js`
 Exports
 - `isExternalLinkTarget(target = "")`

package/reference/autogen/packages/users-web.md

@@ -259,11 +259,11 @@ Exports
 
 ### `src/client/composables/records/useList.js`
 Exports
-- `useList({ ownershipFilter = ROUTE_VISIBILITY_WORKSPACE, surfaceId = "", access = "auto", apiSuffix = "", queryKeyFactory = null, viewPermissions = [], readEnabled = true, placementSource = "users-web.list", fallbackLoadError = "Unable to load list.", initialPageParam = null, getNextPageParam, selectItems, client = null, transport = null, requestOptions, queryOptions, requestRecovery, requestRecoveryLabel = "List", realtime = null, adapter = null, recordIdParam = "recordId", recordIdSelector = null, viewUrlTemplate = "", editUrlTemplate = "", search = null, queryParams = null, requestQueryParams = null, syncToRoute = false } = {})`
+- `useList({ ownershipFilter = ROUTE_VISIBILITY_WORKSPACE, surfaceId = "", access = "auto", apiSuffix = "", queryKeyFactory = null, viewPermissions = [], readEnabled = true, placementSource = "users-web.list", fallbackLoadError = "Unable to load list.", initialPageParam = null, getNextPageParam, selectItems, client = null, transport = null, requestOptions, queryOptions, requestRecovery, requestRecoveryLabel = "List", realtime = null, adapter = null, recordIdParam = "recordId", recordIdSelector = null, viewUrlTemplate = "", editUrlTemplate = "", search = null, queryParams = null, routeQueryValueResolvers = null, requestQueryParams = null, requestFieldsets = null, syncToRoute = false } = {})`
 
 ### `src/client/composables/records/useView.js`
 Exports
-- `useView({ resource = null, ownershipFilter = ROUTE_VISIBILITY_WORKSPACE, surfaceId = "", access = "auto", apiSuffix = "", queryKeyFactory = null, viewPermissions = [], readMethod = "GET", readEnabled = true, client = null, transport = null, requestRecovery = null, requestRecoveryLabel = "Resource", placementSource = "users-web.view", fallbackLoadError = "Unable to load resource.", notFoundStatuses = [404], notFoundMessage = "Record not found.", model, mapLoadedToModel, requestQueryParams = null, recordIdParam = "recordId", routeParams = null, routeRecordId = null, apiUrlTemplate = "", listUrlTemplate = "", editUrlTemplate = "", includeRecordIdInQueryKey = false, realtime = undefined, adapter = null } = {})`
+- `useView({ resource = null, ownershipFilter = ROUTE_VISIBILITY_WORKSPACE, surfaceId = "", access = "auto", apiSuffix = "", queryKeyFactory = null, viewPermissions = [], readMethod = "GET", readEnabled = true, client = null, transport = null, requestRecovery = null, requestRecoveryLabel = "Resource", placementSource = "users-web.view", fallbackLoadError = "Unable to load resource.", notFoundStatuses = [404], notFoundMessage = "Record not found.", model, mapLoadedToModel, requestQueryParams = null, requestFieldsets = null, recordIdParam = "recordId", routeParams = null, routeRecordId = null, apiUrlTemplate = "", listUrlTemplate = "", editUrlTemplate = "", includeRecordIdInQueryKey = false, realtime = undefined, adapter = null } = {})`
 
 ### `src/client/composables/runtime/addEditUiRuntime.js`
 Exports
@@ -360,11 +360,11 @@ Local functions
 ### `src/client/composables/support/listQueryParamSupport.js`
 Exports
 - `normalizeListSyncToRouteConfig(syncToRoute = false, { defaultSearchParam = "q" } = {})`
-- `resolveQueryParamDescriptors(queryParams, context = {})`
+- `resolveQueryParamDescriptors(queryParams, context = {}, { routeValueResolvers = null } = {})`
 - `resolveActiveQueryParamEntries(descriptors = [])`
 - `resolveWritableQueryParamBindings(descriptors = [])`
 - `buildQueryParamEntriesToken(entries = [])`
-- `parseRouteBindingValue(binding, routeQueryValue)`
+- `parseRouteBindingValue(binding, routeQueryValue, context = {})`
 - `areQueryParamBindingValuesEqual(left, right)`
 - `buildRouteQueryCompareToken(query = {})`
 - `mergeManagedQueryParamKeyHistory(history = [], keys = [])`
@@ -375,7 +375,7 @@ Local functions
 - `resolveQueryParamsInput(queryParams, context = {})`
 - `resolveQueryParamBindingType(value)`
 - `resolveArrayQueryParamItemType(values = [])`
-- `createWritableQueryParamBinding({ source = {}, rawKey = "", rawValue = null, key = "" } = {})`
+- `createWritableQueryParamBinding({ source = {}, rawKey = "", rawValue = null, key = "", resolveRouteValue = null } = {})`
 - `firstRouteQueryValue(value)`
 - `normalizeRouteQueryValues(value)`
 - `parseRouteBooleanValue(value, fallback = false)`
@@ -398,11 +398,13 @@ Exports
 
 ### `src/client/composables/support/requestQueryRuntimeSupport.js`
 Exports
-- `appendRequestQueryValue(target = {}, key = "", values = [])`
-- `buildRequestQueryObject(entries = [])`
-- `createRequestQueryRuntime({ requestQueryParams = null, context = null, sourceQueryKey = null } = {})`
-- `resolveRequestQueryBaseKey(sourceQueryKey = null)`
+- `buildRequestQueryObject(entries = [], { fieldsets = null } = {})`
+- `createRequestQueryRuntime({ requestQueryParams = null, requestFieldsets = null, context = null, sourceQueryKey = null } = {})`
+Local functions
 - `resolveRequestQueryContext(context = null)`
+- `resolveRequestQueryBaseKey(sourceQueryKey = null)`
+- `resolveRequestFieldsets(requestFieldsets = null, context = {})`
+- `appendRequestQueryValue(target = {}, key = "", values = [])`
 
 ### `src/client/composables/support/resourceLoadStateHelpers.js`
 Exports
@@ -501,6 +503,8 @@ Local functions
 - `resetFilterValue(values, filter = {})`
 - `applyPresetFilterValue(values, filter = {}, rawValue)`
 - `createQueryParams(values, filterEntries = [])`
+- `resolveFilterRouteValue(filter, routeValue, { initial = false } = {})`
+- `createRouteQueryValueResolvers(filterEntries = [])`
 - `resolveAtomicValueLabel(filter = {}, value = "", labelResolvers = {})`
 - `formatDefaultChipLabel(filter = {}, chipValue, labelResolvers = {})`
 
@@ -521,7 +525,7 @@ Local functions
 
 ### `src/client/composables/useCrudListScreen.js`
 Exports
-- `useCrudListScreen({ adapter = null, resource = null, resourceNamespace = "resource", apiSuffix = "", recordIdParam = "recordId", recordIdSelector = null, titleFallbackFieldKey = "", viewUrlTemplate = "", editUrlTemplate = "", newUrlTemplate = "", recordChangedEvents = [], listFilters = {}, listBulkActions = [], listRowActions = [], syntheticRows = null, routeQueryBlacklist = Object.freeze(["include", "cursor", "limit"]), requestQueryParams = null, readEnabled = true, requestRecoveryLabel = "Records", fallbackLoadError = "Unable to load records." } = {})`
+- `useCrudListScreen({ adapter = null, resource = null, resourceNamespace = "resource", apiSuffix = "", recordIdParam = "recordId", recordIdSelector = null, titleFallbackFieldKey = "", viewUrlTemplate = "", editUrlTemplate = "", newUrlTemplate = "", recordChangedEvents = [], listFilters = {}, listBulkActions = [], listRowActions = [], syntheticRows = null, routeQueryBlacklist = Object.freeze(["include", "cursor", "limit"]), requestQueryParams = null, requestFieldsets = null, readEnabled = true, requestRecoveryLabel = "Records", fallbackLoadError = "Unable to load records." } = {})`
 Local functions
 - `formatCrudListCardValue(value)`
 - `asList(value = [])`
@@ -533,7 +537,7 @@ Local functions
 
 ### `src/client/composables/useCrudViewScreen.js`
 Exports
-- `useCrudViewScreen({ adapter = null, resource = null, resourceNamespace = "resource", apiUrlTemplate = "", recordIdParam = "recordId", titleFallbackFieldKey = "", listUrlTemplate = "", editUrlTemplate = "", recordChangedEvent = "", requestQueryParams = null, readEnabled = true, queryKeyFactory = null, requestRecoveryLabel = "Record", fallbackLoadError = "Unable to load record.", notFoundMessage = "Record not found." } = {})`
+- `useCrudViewScreen({ adapter = null, resource = null, resourceNamespace = "resource", apiUrlTemplate = "", recordIdParam = "recordId", titleFallbackFieldKey = "", listUrlTemplate = "", editUrlTemplate = "", recordChangedEvent = "", requestQueryParams = null, requestFieldsets = null, readEnabled = true, queryKeyFactory = null, requestRecoveryLabel = "Record", fallbackLoadError = "Unable to load record.", notFoundMessage = "Record not found." } = {})`
 
 ### `src/client/composables/usePagedCollection.js`
 Exports

package/reference/autogen/tooling/jskit-cli.md

@@ -777,6 +777,19 @@ Local functions
 Exports
 - `runPackageCreateCommand(ctx = {}, { positional, options, cwd, io })`
 
+### `src/server/commandHandlers/packageCommands/createMigration.js`
+Exports
+- `addInstallMigrationMutationToDescriptor(source = "", mutation = {})`
+- `createMigrationTemplate({ packageId, migrationId } = {})`
+- `runMigrationCreateCommand(ctx = {}, { options, cwd, io })`
+Local functions
+- `maskNonCode(source = "")`
+- `findMatchingDelimiter(source, openIndex, openCharacter, closeCharacter)`
+- `findMutationsFilesArray(source = "")`
+- `lineIndentAt(source = "", index = 0)`
+- `renderInstallMigrationMutation({ from, id, indent } = {})`
+- `writeMigrationSourceAndDescriptor({ descriptorPath, descriptorSource, migrationPath, migrationSource, mkdir, rename, rm, writeFile, path } = {})`
+
 ### `src/server/commandHandlers/packageCommands/discoverabilityHelp.js`
 Exports
 - `isHelpToken(value = "")`