@jskit-ai/agent-docs 0.1.14 → 0.1.16

package/guide/agent/app-setup/a-more-interesting-shell.md

@@ -181,6 +181,16 @@ In JSKIT's file-based routing, a page file can act as a layout if it renders a `
 - `src/pages/home/settings/general/index.vue` is the first real child page created by the starter shell.
 - `src/pages/home/settings/profile/index.vue` becomes `/home/settings/profile` and still renders inside the layout from `settings.vue`.
 
+JSKIT uses a small helper for that redirect instead of hand-building the child path:
+
+```js
+import { redirectToChild } from "@jskit-ai/kernel/client/pageRedirects";
+
+definePage({
+  redirect: redirectToChild("general")
+});
+```
+
 This is why the `home-settings:primary-menu` outlet from `list-placements` is such a useful clue: it tells you which page is acting as the host.
 
 Even an `index.vue` page can have children. If you want an index page to stay visible while child routes render underneath it, put those children under an `index/` directory such as `src/pages/home/settings/profile/index/details.vue`.
@@ -623,6 +633,16 @@ The starter shell now uses a real child-page structure right away:
 - `src/pages/home/settings/general/index.vue` is the first real settings page
 - `src/placement.js` already seeds a `General` link into `home-settings:primary-menu`
 
+When you need that landing redirect yourself, use the same helper pattern:
+
+```js
+import { redirectToChild } from "@jskit-ai/kernel/client/pageRedirects";
+
+definePage({
+  redirect: redirectToChild("general")
+});
+```
+
 That is what makes the page-generation examples in this chapter important. They are not inventing a new pattern. They are extending the exact same host-and-child-page structure that `shell-web` already uses for its own starter `General` page.
 
 ### What did not change

package/guide/agent/app-setup/multi-homing.md

@@ -535,7 +535,7 @@ addPlacement({
 
 addPlacement({
   id: "workspaces.workspace.menu.workspace-settings",
-  target: "workspace-tools:primary-menu",
+  target: "admin-cog:primary-menu",
   surfaces: ["admin"],
   order: 100,
   componentToken: "workspaces.web.workspace-settings.menu-item"
@@ -543,7 +543,7 @@ addPlacement({
 
 addPlacement({
   id: "workspaces.workspace.menu.members",
-  target: "workspace-tools:primary-menu",
+  target: "admin-cog:primary-menu",
   surfaces: ["admin"],
   order: 200,
   componentToken: "workspaces.web.workspace-members.menu-item"

package/guide/agent/generators/advanced-cruds.md

@@ -847,6 +847,8 @@ In JSKIT CRUD:
 Use these rules:
 
 - for explicit DB column overrides, use `repository.column`
+- standard writable `date-time` fields are serialized automatically during CRUD writes
+- use `repository.writeSerializer` only for non-default DB write serialization
 - for computed output fields, use `repository.storage: "virtual"`
 - do not put computed fields in create/patch write schemas
 
@@ -892,6 +894,8 @@ Once registered there:
 - generic CRUD `listByIds`
 - generic CRUD `listByForeignIds`
 
+and generic CRUD writes automatically serialize standard writable `date-time` fields during create/update payload mapping, so normal datetime DB formatting does not need per-field metadata or repository-specific `preparePayload` hooks. Keep `repository.writeSerializer` for non-default cases only.
+
 all pick up the projection automatically, so you should not hand-patch `clearSelect()` / re-select logic into each method.
 
 Important limits:

package/package.json

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

package/patterns/INDEX.md

@@ -18,6 +18,8 @@ How to use it:
   - `child-cruds.md`
 - CRUD links, record placeholders, `paths.page()`, `resolveViewUrl`, `resolveEditUrl`, `resolveParams`
   - `crud-links.md`
+- `definePage`, redirect, child redirect, settings landing, `redirectToChild`
+  - `page-redirects.md`
 - live actions, checkbox, toggle, patch button, inline action, `useCommand()`
   - `live-actions.md`
 - ajax, fetch, API call, request, endpoint, HTTP client, `useList()`, `useView()`, `useAddEdit()`, `useEndpointResource()`, `usersWebHttpClient`
@@ -26,7 +28,7 @@ How to use it:
   - `ui-testing.md`
 - filter, filters, search facets, chips, date range, enum filter, lookup filter, `useCrudListFilters`, `createCrudListFilters`
   - `filters.md`
-- fieldMeta, `repository.column`, computed field, virtual field, projection, `createCrudResourceRuntime`, `remainingBatchWeight`
+- fieldMeta, `repository.column`, `repository.writeSerializer`, computed field, virtual field, projection, `createCrudResourceRuntime`, `remainingBatchWeight`, datetime write serialization
   - `crud-repository-mapping.md`
 
 ## Current Patterns
@@ -35,6 +37,7 @@ How to use it:
 - [surfaces.md](./surfaces.md)
 - [child-cruds.md](./child-cruds.md)
 - [crud-links.md](./crud-links.md)
+- [page-redirects.md](./page-redirects.md)
 - [live-actions.md](./live-actions.md)
 - [client-requests.md](./client-requests.md)
 - [ui-testing.md](./ui-testing.md)

package/patterns/crud-repository-mapping.md

@@ -9,9 +9,11 @@ Default JSKIT pattern:
 1. Treat the schema as the API contract only.
 2. Put persistence mapping in `resource.fieldMeta`.
 3. Use `repository.column` for explicit DB column overrides.
-4. Use `repository.storage: "virtual"` for computed output fields.
-5. Register computed SQL projections once in the repository runtime with `virtualFields`.
-6. Let generic CRUD read paths apply those projections automatically.
+4. Let generic CRUD runtime handle standard writable `date-time` fields automatically at the DB write seam.
+5. Use `repository.writeSerializer` only for non-default write serialization.
+6. Use `repository.storage: "virtual"` for computed output fields.
+7. Register computed SQL projections once in the repository runtime with `virtualFields`.
+8. Let generic CRUD read paths apply those projections automatically.
 
 Field meta rules:
 - for a normal override, write:
@@ -36,14 +38,29 @@ RESOURCE_FIELD_META.push({
 });
 ```
 
+- for a non-default write serializer override, write:
+
+```js
+RESOURCE_FIELD_META.push({
+  key: "arrivalDatetime",
+  repository: {
+    writeSerializer: "datetime-utc"
+  }
+});
+```
+
 - omit `repository` entirely when the field is column-backed and the default snake_case mapping is correct
+- standard writable `format: "date-time"` fields do not need explicit `repository.writeSerializer`
+- use `repository.writeSerializer` only for non-default DB write behavior; keep `bodyValidator.normalize(...)` in API shape
 - `repository.storage: "virtual"` cannot also define `repository.column`
+- `repository.storage: "virtual"` cannot also define `repository.writeSerializer`
 - `repository.storage: "virtual"` fields must not appear in create/patch write schemas
 
 Repository pattern:
 - build the runtime with `createCrudResourceRuntime(resource, { ... })`
 - register computed projections in `virtualFields`
 - keep SQL in the repository, not in shared metadata
+- let generic CRUD runtime apply `repository.writeSerializer` during create/update writes
 
 Example:
 
@@ -64,6 +81,8 @@ const repositoryRuntime = createCrudResourceRuntime(resource, {
 
 What CRUD core now does for you:
 - default select columns include only column-backed output fields
+- create/update write payloads serialize standard writable `date-time` fields centrally
+- create/update write payloads also apply any explicit field write serializers centrally
 - `list`, `findById`, `listByIds`, and `listByForeignIds` apply registered virtual projections automatically
 - search and parent-filter fallback derivation only use column-backed fields
 - `listByIds(..., { valueKey })` requires that `valueKey` be column-backed
@@ -76,6 +95,8 @@ Avoid:
 Review checks:
 - schema defines contract, not storage
 - `fieldMeta.repository` owns mapping
+- standard datetime DB write serialization stays automatic and runtime-owned
+- any non-default DB write serialization lives in `repository.writeSerializer`, not in per-repository hooks
 - computed fields use `repository.storage: "virtual"`
 - repository runtime registers matching `virtualFields`
 - no per-method projection duplication when generic CRUD reads already cover the field

package/patterns/page-redirects.md

@@ -0,0 +1,41 @@
+# Page Redirect Patterns
+
+Use when:
+
+- redirecting a page index route to a child page
+- writing `definePage({ redirect: ... })`
+- seeding settings landing pages such as `/home/settings`
+- wiring a section shell that should land on a real child page first
+
+Check first:
+
+- whether the page is only a landing route for child pages
+- whether the destination child route is explicit and stable
+- whether the redirect should preserve incoming query and hash
+
+Rules:
+
+- For “index page lands on child page” redirects, use `redirectToChild()` from `@jskit-ai/kernel/client/pageRedirects`.
+- Do not hand-build child redirects with string surgery such as `` `${String(to.path || "").replace(/\\/$/, "")}/general` ``.
+- Keep the destination explicit. Do not infer it from placements, menu order, or “first child page wins” behavior.
+- If the redirect is just “go to this child page”, prefer:
+
+```js
+import { redirectToChild } from "@jskit-ai/kernel/client/pageRedirects";
+
+definePage({
+  redirect: redirectToChild("general")
+});
+```
+
+Why:
+
+- the helper centralizes slash handling
+- it preserves incoming query and hash unless the child target overrides them
+- templates, guides, and apps all stay on one obvious pattern
+
+Avoid:
+
+- copying redirect lambdas between apps and templates
+- building implicit redirect behavior from placements
+- inventing page-local helper utilities for the same pattern

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

@@ -35,6 +35,24 @@ Exports
 Exports
 - `runAuthSignOutFlow`
 
+### `src/server/authPolicyContextResolverRegistry.js`
+Exports
+- `AUTH_POLICY_CONTEXT_RESOLVER_TAG`
+- `registerAuthPolicyContextResolver(app, token, factory)`
+- `resolveAuthPolicyContextResolvers(scope)`
+- `mergeAuthPolicyContexts(contexts = [])`
+- `composeAuthPolicyContextResolvers(resolvers = [])`
+Local functions
+- `normalizeAuthPolicyContextResolver(entry)`
+
+### `src/server/authServiceDecoratorRegistry.js`
+Exports
+- `AUTH_SERVICE_DECORATOR_TAG`
+- `registerAuthServiceDecorator(app, token, factory)`
+- `resolveAuthServiceDecorators(scope)`
+Local functions
+- `normalizeAuthServiceDecorator(entry)`
+
 ### `src/server/inviteTokens.js`
 Exports
 - `OPAQUE_INVITE_TOKEN_HASH_PREFIX`

package/reference/autogen/packages/auth-provider-supabase-core.md

@@ -110,13 +110,13 @@ Exports
 
 ### `src/server/lib/devAuthBootstrap.js`
 Exports
-- `assertDevAuthBootstrapConfig(config, { usersRepository = null } = {})`
-- `authenticateDevAuthRequest({ request, accessToken = "", refreshToken = "" }, { config, usersRepository = null } = {})`
+- `assertDevAuthBootstrapConfig(config, { userProfilesRepository = null } = {})`
+- `authenticateDevAuthRequest({ request, accessToken = "", refreshToken = "" }, { config, userProfilesRepository = null } = {})`
 - `createDevAuthSession(profile, config)`
 - `ensureDevAuthBootstrapAvailable(config, request)`
 - `isDevAuthToken(token)`
 - `resolveDevAuthConfig({ enabled = false, secret = "", nodeEnv = "development", jwtAudience = "authenticated", accessTtlSeconds = DEFAULT_DEV_AUTH_ACCESS_TTL_SECONDS, refreshTtlSeconds = DEFAULT_DEV_AUTH_REFRESH_TTL_SECONDS } = {})`
-- `resolveDevAuthProfile(input = {}, { usersRepository = null, validationError } = {})`
+- `resolveDevAuthProfile(input = {}, { userProfilesRepository = null, validationError } = {})`
 Local functions
 - `parseBoolean(value, fallback = false)`
 - `normalizePositiveInteger(value, fallback)`
@@ -128,7 +128,7 @@ Local functions
 - `isLocalDevAuthRequest(request)`
 - `stripDevAuthTokenPrefix(token)`
 - `buildProfileFromTokenClaims(payload)`
-- `resolveProfileFromTokenClaims(payload, { usersRepository = null } = {})`
+- `resolveProfileFromTokenClaims(payload, { userProfilesRepository = null } = {})`
 - `signDevAuthToken(kind, profile, config)`
 - `verifyDevAuthToken(token, kind, config)`
 
@@ -247,6 +247,7 @@ Local functions
 - `resolveCommonDependencies(scope)`
 - `resolveRuntimeEnv(scope)`
 - `resolveOptionalRepositories(scope)`
+- `applyAuthServiceDecorators(scope, authService)`
 
 ### root
 

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

@@ -68,10 +68,6 @@ Exports
 - `createCrudClientSupport`
 - `useCrudRealtimeInvalidation`
 
-### `src/server/createCrudRepositoryFromResource.js`
-Exports
-- `createCrudRepositoryFromResource(resource = {}, { context = "crudRepository", list = {}, virtualFields = {} } = {})`
-
 ### `src/server/createCrudServiceFromResource.js`
 Exports
 - `createCrudServiceFromResource(resource = {}, { context = "crudService" } = {})`
@@ -205,19 +201,35 @@ Exports
 Local functions
 - `normalizeLookupOwnershipFilter(value, { context = "crudLookup ownershipFilter" } = {})`
 
-### `src/server/repositoryMethods.js`
+### `src/server/repositorySupport.js`
 Exports
-- `createCrudResourceRuntime(resource = {}, { context = "crudRepository", list = {}, virtualFields = {} } = {})`
-- `crudRepositoryList(runtime, knex, query = {}, repositoryOptions = {}, callOptions = {}, hooks = null)`
-- `crudRepositoryFindById(runtime, knex, recordId, repositoryOptions = {}, callOptions = {}, hooks = null)`
-- `crudRepositoryListByIds(runtime, knex, ids = [], repositoryOptions = {}, callOptions = {}, hooks = null)`
-- `crudRepositoryListByForeignIds(runtime, knex, ids = [], foreignKey = "", repositoryOptions = {}, callOptions = {}, hooks = null)`
-- `crudRepositoryCreate(runtime, knex, payload = {}, repositoryOptions = {}, callOptions = {}, hooks = null)`
-- `crudRepositoryUpdateById(runtime, knex, recordId, patch = {}, repositoryOptions = {}, callOptions = {}, hooks = null)`
-- `crudRepositoryDeleteById(runtime, knex, recordId, repositoryOptions = {}, callOptions = {}, hooks = null)`
+- `DEFAULT_LIST_LIMIT`
+- `MAX_LIST_LIMIT`
+- `normalizeCrudListLimit(value, { fallback = DEFAULT_LIST_LIMIT, max = MAX_LIST_LIMIT } = {})`
+- `normalizeCrudListCursor(cursor = null, { allowEmpty = true } = {})`
+- `requireCrudTableName(tableName, { context = "crudRepository" } = {})`
+- `deriveRepositoryMappingFromResource(resource = {}, { context = "crudRepository" } = {})`
+- `applyCrudListQueryFilters(query, { idColumn = "id", cursor = "", applyCursor = true, q = "", searchColumns = [], parentFilters = {}, parentFilterColumns = {} } = {})`
+- `mapRecordRow(row, fieldKeys = [], overrides = {}, { recordIdKeys = [] } = {})`
+- `buildWritePayload(sourcePayload = {}, fieldKeys = [], overrides = {}, { serializerByKey = {} } = {})`
+- `resolveColumnName(fieldKey, overrides = {})`
+- `resolveCrudIdColumn(idColumn, { fallback = "id" } = {})`
+- `buildRepositoryColumnMetadata({ outputKeys = [], writeKeys = [], columnOverrides = {}, fieldStorageByKey = {} } = {})`
+Local functions
+- `resolveOptionalObjectSchemaProperties(schema, options = {})`
+- `requireObjectSchemaProperties(schema, { context = "crudRepository", schemaLabel = "schema" } = {})`
+- `normalizeResourceFieldMetaEntries(fieldMeta = [])`
+- `schemaIncludesStringType(schema = {})`
+- `schemaIncludesDateTimeFormat(schema = {})`
+- `schemaIncludesRecordIdType(schema = {})`
+
+### `src/server/resourceRuntime/index.js`
+Exports
+- `createCrudResourceRuntime(resource = {}, knex, repositoryOptions = {})`
 Local functions
 - `requireCrudRecordId(value, { context = "crudRepository" } = {})`
-- `resolveRepositoryDefaults(resource = {}, repositoryMapping = {})`
+- `requireCrudRepositoryOptions(value = {}, { context = "crudRepository" } = {})`
+- `resolveRepositoryDefaults(resource = {}, repositoryMapping = {}, { context = "crudRepository" } = {})`
 - `normalizeCrudVirtualFieldHandlers(virtualFields = {}, repositoryMapping = {}, { context = "crudRepository" } = {})`
 - `applyCrudRepositoryVirtualProjections(dbQuery, runtime = {}, { knex, tableName } = {})`
 - `normalizeSearchColumns(searchColumns = [], fallbackColumns = [])`
@@ -225,6 +237,12 @@ Local functions
 - `normalizeListOrderNulls(value = LIST_ORDER_NULLS_LAST)`
 - `normalizeListOrderBy(orderBy = [], { idColumn = "id" } = {})`
 - `resolveListRuntimeConfig(list = {}, fallbackSearchColumns = [], { idColumn = "id" } = {})`
+- `formatOutputValidationError(issue = {})`
+- `resolveRecordOutputValidator(resource = {}, { context = "crudRepository" } = {})`
+- `resolveOperationBodyValidator(resource = {}, operationKey = "", { context = "crudRepository" } = {})`
+- `extractExplicitFieldErrors(error)`
+- `normalizeRepositoryInputPayload(runtime = {}, payload = {}, { operationKey = "create", phase = "crudCreate", action = "create", recordId = null, existingRecord = null, actionContextBase = {} } = {})`
+- `normalizeRepositoryOutputRecord(runtime = {}, record = {}, { operation = "list" } = {})`
 - `encodeOrderedListCursorValue(value = null)`
 - `decodeOrderedListCursorValue(value = null)`
 - `encodeOrderedListCursor(row = null, orderBy = [])`
@@ -234,43 +252,51 @@ Local functions
 - `canApplyOrderedListCursorAfterBranch(descriptor = {}, value = null)`
 - `appendOrderedListCursorBranches(query, orderBy = [], cursorValues = [], index = 0, { useOr = false } = {})`
 - `applyOrderedListCursorFilter(query, { orderBy = [], cursor = "" } = {})`
-- `resolveRecordOutputValidator(resource = {}, { context = "crudRepository" } = {})`
-- `formatOutputValidationError(error = {})`
-- `normalizeRepositoryOutputRecord(runtime, record = {}, { operation = "read" } = {})`
-- `resolveCrudRepositoryCall(runtime, knex, repositoryOptions = {}, callOptions = {})`
-- `normalizeCrudRepositoryHooks(hooks = null, allowedHookKeys = [], { context = "crudRepository" } = {})`
-- `resolveOptionalCrudRepositoryHook(hooks = {}, hookKey = "", { context = "crudRepository" } = {})`
-- `applyCrudRepositoryQueryHook(dbQuery, hook = null, hookContext = {}, { context = "crudRepository", hookKey = "modifyQuery" } = {})`
+- `normalizeCrudRepositoryOperationStage(stage = null, stageLabel = "", { context = "crudRepository" } = {})`
+- `normalizeCrudRepositoryOperationConfig(config = {}, operationKey = "", { context = "crudRepository" } = {})`
+- `normalizeCrudRepositoryOperations(sourceOperations = {}, { context = "crudRepository" } = {})`
+- `applyConfiguredQueryStage(dbQuery, stage = null, stageContext = {}, { context = "crudRepository", stageKey = "applyQuery" } = {})`
+- `isCrudRepositoryQueryBuilder(value)`
 - `normalizeCrudRepositoryObjectInput(value = {})`
-- `applyCrudRepositoryPayloadHook(payload = {}, hook = null, hookContext = {}, { context = "crudRepository", hookKey = "modifyPayload" } = {})`
-- `applyCrudRepositoryRecordsHook(items = [], hook = null, hookContext = {}, { context = "crudRepository", hookKey = "afterQuery" } = {})`
-- `applyCrudRepositoryRecordHook(record = null, hook = null, hookContext = {}, { context = "crudRepository", hookKey = "transformReturnedRecord" } = {})`
-- `applyCrudRepositoryOutputHook(output, hook = null, hookContext = {}, { context = "crudRepository", hookKey = "finalizeOutput", validateOutput = null } = {})`
-- `applyCrudRepositoryAfterWriteHook(meta = {}, hook = null, hookContext = {}, { context = "crudRepository", hookKey = "afterWrite" } = {})`
+- `applyConfiguredObjectStage(payload = {}, stage = null, stageContext = {}, { context = "crudRepository", stageKey = "preparePayload" } = {})`
 - `applyOrderedListControls(dbQuery, orderBy = [])`
 - `enforceCrudRepositoryListControls(dbQuery, { idColumn = "id", limit = DEFAULT_LIST_LIMIT + 1, orderBy = [] } = {})`
-- `createCrudRepositoryHookContextBase(runtime, repositoryOptions = {}, callOptions = {})`
+- `createCrudRepositoryActionContextBase(runtime, callOptions = {})`
+- `createCompiledCrudRepositoryRuntime(resource = {}, repositoryOptions = {})`
+- `resolveCrudRepositoryCall(runtime, knex, callOptions = {})`
+- `applyCrudRepositoryReadLock(dbQuery, callOptions = {})`
+- `listRecords(runtime, knex, query = {}, callOptions = {})`
+- `findRecordById(runtime, knex, recordId, callOptions = {})`
+- `listRecordsByIds(runtime, knex, ids = [], callOptions = {})`
+- `createRecord(runtime, knex, payload = {}, callOptions = {})`
+- `updateRecordById(runtime, knex, recordId, patch = {}, callOptions = {})`
+- `deleteRecordById(runtime, knex, recordId, callOptions = {})`
 
-### `src/server/repositorySupport.js`
+### `src/server/resourceRuntime/lookupHydration.js`
 Exports
-- `DEFAULT_LIST_LIMIT`
-- `MAX_LIST_LIMIT`
-- `normalizeCrudListLimit(value, { fallback = DEFAULT_LIST_LIMIT, max = MAX_LIST_LIMIT } = {})`
-- `normalizeCrudListCursor(cursor = null, { allowEmpty = true } = {})`
-- `requireCrudTableName(tableName, { context = "crudRepository" } = {})`
-- `deriveRepositoryMappingFromResource(resource = {}, { context = "crudRepository" } = {})`
-- `applyCrudListQueryFilters(query, { idColumn = "id", cursor = "", applyCursor = true, q = "", searchColumns = [], parentFilters = {}, parentFilterColumns = {} } = {})`
-- `mapRecordRow(row, fieldKeys = [], overrides = {}, { recordIdKeys = [] } = {})`
-- `buildWritePayload(sourcePayload = {}, fieldKeys = [], overrides = {})`
-- `resolveColumnName(fieldKey, overrides = {})`
-- `resolveCrudIdColumn(idColumn, { fallback = "id" } = {})`
-- `buildRepositoryColumnMetadata({ outputKeys = [], writeKeys = [], columnOverrides = {}, fieldStorageByKey = {} } = {})`
+- `createCrudLookupRuntime(resource = {}, { outputKeys = [] } = {})`
+- `hydrateCrudLookupRecords(records = [], runtime = {}, { include, mode = "list", repositoryOptions = {}, callOptions = {} } = {})`
 Local functions
-- `resolveOptionalObjectSchemaProperties(schema, options = {})`
-- `requireObjectSchemaProperties(schema, { context = "crudRepository", schemaLabel = "schema" } = {})`
-- `normalizeResourceFieldMetaEntries(fieldMeta = [])`
-- `schemaIncludesStringType(schema = {})`
-- `schemaIncludesRecordIdType(schema = {})`
+- `normalizeLookupRelationEntry(entry = {}, outputKeys = new Set())`
+- `normalizeLookupDefaultInclude(value)`
+- `normalizeLookupMaxDepth(value)`
+- `resolveLookupRuntimeDefaults(resource = {})`
+- `normalizeLookupIdentifier(value)`
+- `normalizeIncludePaths(include, { defaultInclude = DEFAULT_LOOKUP_INCLUDE } = {})`
+- `resolveChildIncludeFromPaths(paths = [])`
+- `shouldHydrateByMode(entry = {}, mode = "list")`
+- `buildLookupHydrationPlan(runtime = {}, include, { mode = "list", context = "crudRepository", includeWasExplicit = false, skippedNamespaces = new Set() } = {})`
+- `resolveLookupResolver(repositoryOptions = {}, callOptions = {}, { context = "crudRepository" } = {})`
+- `resolveLookupDepthRuntime(runtime = {}, repositoryOptions = {}, callOptions = {})`
+- `buildLookupGroupKey(relation = {})`
+- `normalizeLookupRelationValues(records = [], entries = [], childIncludeByKey = {})`
+- `resolveGroupChildInclude(group = {})`
+- `normalizeLookup(provider, relation = {}, { context = "crudRepository" } = {})`
+- `resolveLookupOwnershipFilter(provider = {}, { context = "crudRepository" } = {})`
+- `resolveLookupVisibilityContext(provider = {}, relation = {}, callOptions = {}, { context = "crudRepository" } = {})`
+- `buildLookupRecordMap(records = [], valueKey = "")`
+- `buildLookupCollectionMap(records = [], foreignKey = "")`
+- `resolveLookupVisitedNamespaces(runtime = {}, callOptions = {})`
 
 ### `src/server/serviceEvents.js`
 Exports
@@ -286,17 +312,20 @@ Exports
 - `crudServiceDeleteRecord(runtime, repository, fieldAccess = {}, recordId, options = {})`
 Local functions
 - `requireCrudServiceRepository(runtime = {}, repository = null)`
+- `splitCrudListRepositoryCall(query = {}, options = {})`
 
 ### `src/shared/crudFieldMetaSupport.js`
 Exports
 - `CRUD_FIELD_REPOSITORY_STORAGE_COLUMN`
 - `CRUD_FIELD_REPOSITORY_STORAGE_VIRTUAL`
+- `CRUD_FIELD_REPOSITORY_WRITE_SERIALIZER_DATETIME_UTC`
 - `CRUD_LOOKUP_FORM_CONTROL_AUTOCOMPLETE`
 - `CRUD_LOOKUP_FORM_CONTROL_SELECT`
 - `CRUD_RUNTIME_LOOKUPS_FIELD_KEY`
 - `checkCrudLookupFormControl(value, { context = "crud fieldMeta ui.formControl", defaultValue = CRUD_LOOKUP_FORM_CONTROL_AUTOCOMPLETE } = {})`
 - `isCrudRuntimeOutputOnlyFieldKey(value = "", { lookupContainerKey = CRUD_RUNTIME_LOOKUPS_FIELD_KEY } = {})`
 - `normalizeCrudFieldRepositoryConfig(fieldMetaEntry = {}, { context = "crud fieldMeta repository", fieldKey = "" } = {})`
+- `normalizeCrudFieldRepositoryWriteSerializer(value, { context = "crud fieldMeta repository", fieldKey = "" } = {})`
 
 ### `src/shared/crudNamespaceSupport.js`
 Exports

package/reference/autogen/packages/crud-server-generator.md

@@ -45,11 +45,19 @@ Local functions
 - `resolveKnexFactory(moduleNamespace)`
 - `resolveMysqlSnapshotFromDatabase({ appRoot, tableName, idColumn } = {})`
 - `resolveColumnKey(column, idColumn)`
+- `normalizeNumericBoundValue(value, scale = null)`
+- `resolveNumericExclusiveStep(column)`
+- `applyLowerBound(current = null, candidate = null)`
+- `applyUpperBound(current = null, candidate = null)`
+- `applyNumericConstraintBound(target = {}, column = null, operator = "", rawValue = null)`
+- `resolveColumnNumericBounds(snapshot = {})`
 - `isIdentifier(value)`
 - `renderObjectPropertyKey(value)`
 - `renderIntegerSchema(column)`
 - `renderStringSchema(column, { forOutput = false } = {})`
-- `renderResourceValidatorsImport({ needsHtmlTimeSchemas = false, needsRecordIdSchemas = false } = {})`
+- `renderResourceValidatorsImport({ htmlTimeSchemaImports = [], recordIdValidatorImports = [] } = {})`
+- `resolveHtmlTimeSchemaImports(columns = [])`
+- `resolveRecordIdValidatorImports(...sources)`
 - `renderResourceSchemaPropertyLines(columns, { forOutput = false } = {})`
 - `renderResourceInputNormalizationLines(columns)`
 - `renderResourceOutputNormalizationLines(columns)`
@@ -207,6 +215,39 @@ Exports
 Exports
 - None
 
+### .tmp-crud-server-template-fixture-FNbPfi
+
+### `.tmp-crud-server-template-fixture-FNbPfi/src/server/actionIds.js`
+Exports
+- `actionIds`
+
+### `.tmp-crud-server-template-fixture-FNbPfi/src/server/actions.js`
+Exports
+- `createActions({ surface = "" } = {})`
+Local functions
+- `requireActionSurface(surface = "")`
+
+### `.tmp-crud-server-template-fixture-FNbPfi/src/server/listConfig.js`
+Exports
+- `LIST_CONFIG`
+
+### `.tmp-crud-server-template-fixture-FNbPfi/src/server/registerRoutes.js`
+Exports
+- `registerRoutes(app, { routeOwnershipFilter = "public", routeSurface = "", routeRelativePath = "" } = {})`
+
+### `.tmp-crud-server-template-fixture-FNbPfi/src/server/repository.js`
+Exports
+- `createRepository(knex, options = {})`
+
+### `.tmp-crud-server-template-fixture-FNbPfi/src/server/service.js`
+Exports
+- `createService({ customersRepository, fieldAccess = DEFAULT_FIELD_ACCESS } = {})`
+- `serviceEvents`
+
+### `.tmp-crud-server-template-fixture-FNbPfi/src/shared/customerResource.js`
+Exports
+- `resource`
+
 ### test-support
 
 ### `test-support/templateServerFixture.js`

package/reference/autogen/packages/crud-ui-generator.md

@@ -32,6 +32,12 @@ Local functions
 - `parseDisplayFieldsOption(options)`
 - `validateDisplayFieldsForOperation(selectedFieldKeys, fields, operationName)`
 - `filterDisplayFields(selectedFieldKeys, fields)`
+- `rewriteGeneratedBlockIndent(source = "", { trimPrefix = "", addPrefix = "" } = {})`
+- `hasLookupFormFields(fields = [])`
+- `buildLookupImportLine(fields = [])`
+- `buildLookupRuntimeSetup(fields = [], { formFieldsVariable = "", resourceNamespace = "", mode = "" } = {})`
+- `buildLookupFormProps(fields = [])`
+- `buildLookupFormPropDefinitions({ createFields = [], editFields = [] } = {})`
 - `filterDefaultHiddenListFields(selectedFieldKeys, fields, { recordIdFieldKey = "" } = {})`
 - `ensureFields(fields, fallbackFields = createFieldDefinitions({}))`
 - `resolveViewTitleFallbackFieldKey(fields = [])`
@@ -88,6 +94,7 @@ Local functions
 - `toOptionalAccessorExpression(baseName, fieldKey)`
 - `escapeHtml(value)`
 - `serializeTemplateBindingValue(value)`
+- `renderTemplateJsStringLiteral(value)`
 - `isLookupField(field = {})`
 - `toLookupDisplayFieldDescriptor(field = {})`
 - `toLookupDisplayFieldExpression(field = {})`
@@ -117,6 +124,7 @@ Local functions
 Exports
 - None
 Local functions
+- `resolveFieldErrors(fieldKey)`
 - `resolveCancelTo(target)`
 
 ### `templates/src/pages/admin/ui-generator/AddEditFormFields.js`
@@ -127,6 +135,8 @@ Exports
 ### `templates/src/pages/admin/ui-generator/EditElement.vue`
 Exports
 - None
+Local functions
+- `resolveFieldErrors(fieldKey)`
 
 ### `templates/src/pages/admin/ui-generator/EditWrapperElement.vue`
 Exports
@@ -139,6 +149,8 @@ Exports
 ### `templates/src/pages/admin/ui-generator/NewElement.vue`
 Exports
 - None
+Local functions
+- `resolveFieldErrors(fieldKey)`
 
 ### `templates/src/pages/admin/ui-generator/NewWrapperElement.vue`
 Exports

package/reference/autogen/packages/kernel.md

@@ -600,6 +600,12 @@ Local functions
 - `normalizeClientModuleEntries(clientModules)`
 - `createClientRuntimeApp({ profile = "client", app, pinia = null, router, env, logger, surfaceRuntime, surfaceMode } = {})`
 
+### `client/pageRedirects.js`
+Exports
+- `redirectToChild(childTarget = "")`
+Local functions
+- `queryStringToObject(queryString = "")`
+
 ### `client/shellBootstrap.js`
 Exports
 - `resolveClientBootstrapDebugEnabled({ env = {}, debugEnabled = undefined, debugEnvKey = "VITE_JSKIT_CLIENT_DEBUG" } = {})`

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

@@ -20,7 +20,7 @@ Exports
 
 ### `src/server/accountNotifications/accountNotificationsService.js`
 Exports
-- `createService({ userSettingsRepository, usersRepository, authService } = {})`
+- `createService({ userSettingsRepository, userProfilesRepository, authService } = {})`
 
 ### `src/server/accountNotifications/bootAccountNotificationsRoutes.js`
 Exports
@@ -36,7 +36,7 @@ Exports
 
 ### `src/server/accountPreferences/accountPreferencesService.js`
 Exports
-- `createService({ userSettingsRepository, usersRepository, authService } = {})`
+- `createService({ userSettingsRepository, userProfilesRepository, authService } = {})`
 
 ### `src/server/accountPreferences/bootAccountPreferencesRoutes.js`
 Exports
@@ -52,11 +52,11 @@ Exports
 
 ### `src/server/accountProfile/accountProfileService.js`
 Exports
-- `createService({ userSettingsRepository, usersRepository, authService, avatarService } = {})`
+- `createService({ userSettingsRepository, userProfilesRepository, authService, avatarService } = {})`
 
 ### `src/server/accountProfile/avatarService.js`
 Exports
-- `createService({ usersRepository, avatarStorageService, avatarPolicy } = {})`
+- `createService({ userProfilesRepository, avatarStorageService, avatarPolicy } = {})`
 - `__testables`
 Local functions
 - `resolveAvatarPolicy(policy = {})`
@@ -83,7 +83,7 @@ Exports
 
 ### `src/server/accountSecurity/accountSecurityService.js`
 Exports
-- `createService({ userSettingsRepository, usersRepository, authService } = {})`
+- `createService({ userSettingsRepository, userProfilesRepository, authService } = {})`
 
 ### `src/server/accountSecurity/bootAccountSecurityRoutes.js`
 Exports
@@ -138,6 +138,20 @@ Exports
 - `toDbJson(value, fallback = {})`
 - `createWithTransaction`
 
+### `src/server/common/repositories/userProfilesRepository.js`
+Exports
+- `createRepository(knex)`
+Local functions
+- `normalizeProfileRecord(payload)`
+- `normalizeCreatePayload(payload = {})`
+- `normalizeUsername(value)`
+- `usernameBaseFromEmail(email)`
+- `buildUsernameCandidate(baseUsername, suffix)`
+- `duplicateTargetsEmail(error)`
+- `duplicateTargetsUsername(error)`
+- `createDuplicateEmailConflictError()`
+- `resolveUniqueUsername(client, baseUsername, { excludeUserId = null } = {})`
+
 ### `src/server/common/repositories/userSettingsRepository.js`
 Exports
 - `createRepository(knex)`
@@ -146,28 +160,24 @@ Local functions
 - `normalizeBoolean(value, fallback = false)`
 - `createInsertPayload(userId)`
 
-### `src/server/common/repositories/usersRepository.js`
+### `src/server/common/resources/userProfilesResource.js`
 Exports
-- `createRepository(knex)`
-- `mapProfileRow(row)`
-- `normalizeIdentity(identityLike)`
+- `resource`
 Local functions
 - `normalizeUsername(value)`
-- `usernameBaseFromEmail(email)`
-- `buildUsernameCandidate(baseUsername, suffix)`
-- `duplicateTargetsEmail(error)`
-- `duplicateTargetsUsername(error)`
-- `createDuplicateEmailConflictError()`
-- `resolveUniqueUsername(client, baseUsername, { excludeUserId = null } = {})`
+- `normalizeNullableString(value)`
+- `normalizeNullableVersion(value)`
+- `normalizeProfileRecord(payload = {})`
+- `normalizeCreatePayload(payload = {})`
 
 ### `src/server/common/services/accountContextService.js`
 Exports
-- `resolveUserProfile(usersRepository, user)`
+- `resolveUserProfile(userProfilesRepository, user)`
 - `resolveSecurityStatus(authService, request)`
 
 ### `src/server/common/services/authProfileSyncService.js`
 Exports
-- `createService({ usersRepository, lifecycleContributors = [], userSettingsRepository = null } = {})`
+- `createService({ userProfilesRepository, lifecycleContributors = [], userSettingsRepository = null } = {})`
 Local functions
 - `buildNormalizedIdentityKey(identityLike)`
 - `buildNormalizedIdentityProfile(profileLike)`
@@ -179,6 +189,10 @@ Local functions
 Exports
 - `deepFreeze`
 
+### `src/server/common/support/identity.js`
+Exports
+- `normalizeIdentity(identityLike)`
+
 ### `src/server/common/support/realtimeServiceEvents.js`
 Exports
 - `ACCOUNT_SETTINGS_AND_BOOTSTRAP_EVENTS`
@@ -213,7 +227,7 @@ Exports
 
 ### `src/server/usersBootstrapContributor.js`
 Exports
-- `createUsersBootstrapContributor({ usersRepository, userSettingsRepository, appConfig = {}, authService } = {})`
+- `createUsersBootstrapContributor({ userProfilesRepository, userSettingsRepository, appConfig = {}, authService } = {})`
 Local functions
 - `getOAuthProviderCatalogPayload(authService)`
 - `normalizeBoolean(value, fallback)`
@@ -294,6 +308,71 @@ Exports
 Local functions
 - `normalizePositiveInteger(value, fallback)`
 
+### `templates/packages/users-workspace/package.descriptor.mjs`
+Exports
+- None
+
+### `templates/packages/users-workspace/src/server/actions.js`
+Exports
+- `createActions({ surface = "" } = {})`
+Local functions
+- `requireActionSurface(surface = "")`
+
+### `templates/packages/users-workspace/src/server/registerRoutes.js`
+Exports
+- `registerRoutes(app, { routeOwnershipFilter = "public", routeSurface = "", routeSurfaceRequiresWorkspace = false, routeRelativePath = "" } = {})`
+
+### `templates/packages/users-workspace/src/server/UsersProvider.js`
+Exports
+- `UsersProvider`
+Local functions
+- `resolveCrudPolicyFromApp(app)`
+
+### `templates/packages/users/package.descriptor.mjs`
+Exports
+- None
+
+### `templates/packages/users/src/server/actionIds.js`
+Exports
+- `actionIds`
+
+### `templates/packages/users/src/server/actions.js`
+Exports
+- `createActions({ surface = "" } = {})`
+Local functions
+- `requireActionSurface(surface = "")`
+
+### `templates/packages/users/src/server/listConfig.js`
+Exports
+- `LIST_CONFIG`
+
+### `templates/packages/users/src/server/registerRoutes.js`
+Exports
+- `registerRoutes(app, { routeOwnershipFilter = "public", routeSurface = "", routeRelativePath = "" } = {})`
+
+### `templates/packages/users/src/server/repository.js`
+Exports
+- `createRepository(knex, options = {})`
+
+### `templates/packages/users/src/server/service.js`
+Exports
+- `createService({ usersRepository } = {})`
+- `serviceEvents`
+
+### `templates/packages/users/src/server/UsersProvider.js`
+Exports
+- `UsersProvider`
+Local functions
+- `resolveCrudPolicyFromApp(app)`
+
+### `templates/packages/users/src/shared/index.js`
+Exports
+- `resource`
+
+### `templates/packages/users/src/shared/userResource.js`
+Exports
+- `resource`
+
 ### root
 
 ### `package.descriptor.mjs`

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

@@ -16,8 +16,7 @@ Use this on demand; do not load the full index at startup.
 
 ### `src/client/account-settings/sections.js`
 Exports
-- `ACCOUNT_SETTINGS_SECTIONS_INJECTION_KEY`
-- `ACCOUNT_SETTINGS_SECTION_REGISTRY_TAG`
+- `ACCOUNT_SETTINGS_SECTION_TARGET`
 - `EMPTY_ACCOUNT_SETTINGS_SECTIONS`
 - `RESERVED_ACCOUNT_SETTINGS_SECTION_VALUES`
 - `normalizeAccountSettingsSectionEntry(entry = null)`
@@ -171,7 +170,7 @@ Exports
 
 ### `src/client/composables/records/useView.js`
 Exports
-- `useView({ ownershipFilter = ROUTE_VISIBILITY_WORKSPACE, surfaceId = "", access = "auto", apiSuffix = "", queryKeyFactory = null, viewPermissions = [], readMethod = "GET", readEnabled = true, placementSource = "users-web.view", fallbackLoadError = "Unable to load resource.", notFoundStatuses = [404], notFoundMessage = "Record not found.", model, mapLoadedToModel, recordIdParam = "recordId", routeParams = null, routeRecordId = null, apiUrlTemplate = "", listUrlTemplate = "", editUrlTemplate = "", includeRecordIdInQueryKey = false, realtime = null, adapter = null } = {})`
+- `useView({ ownershipFilter = ROUTE_VISIBILITY_WORKSPACE, surfaceId = "", access = "auto", apiSuffix = "", queryKeyFactory = null, viewPermissions = [], readMethod = "GET", readEnabled = true, 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 = null, adapter = null } = {})`
 
 ### `src/client/composables/runtime/addEditUiRuntime.js`
 Exports
@@ -298,6 +297,10 @@ Exports
 - `resolveEnabledRef(value)`
 - `resolveTextRef(value)`
 
+### `src/client/composables/support/requestQueryPathSupport.js`
+Exports
+- `appendRequestQueryEntriesToPath(path = "", entries = [])`
+
 ### `src/client/composables/support/resourceLoadStateHelpers.js`
 Exports
 - `hasResolvedQueryData({ query = null, data = null } = {})`
@@ -457,10 +460,6 @@ Local functions
 - `resolveSystemThemeName({ prefersDark } = {})`
 - `resolveThemePreferenceStorage(options = {})`
 
-### `src/client/providers/bootUsersWebClientProvider.js`
-Exports
-- `bootUsersWebClientProvider(app)`
-
 ### `src/client/providers/UsersWebClientProvider.js`
 Exports
 - `UsersWebClientProvider`
@@ -473,8 +472,8 @@ Exports
 
 ### `src/shared/toolsOutletContracts.js`
 Exports
-- `DEFAULT_TOOLS_LINK_COMPONENT_TOKEN`
-- `HOME_TOOLS_OUTLET`
+- `DEFAULT_COG_LINK_COMPONENT_TOKEN`
+- `HOME_COG_OUTLET`
 
 ### templates
 

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

@@ -55,19 +55,47 @@ Exports
 ### `src/server/common/repositories/workspaceInvitesRepository.js`
 Exports
 - `createRepository(knex)`
-- `mapRow(row)`
+- `normalizeInviteRecord(payload)`
+- `normalizeInviteWithWorkspace(payload = {})`
+Local functions
+- `normalizeInvitePatchPayload(payload = {})`
 
 ### `src/server/common/repositories/workspaceMembershipsRepository.js`
 Exports
 - `createRepository(knex)`
-- `mapRow(row)`
-- `mapMemberSummaryRow(row)`
+- `normalizeMembershipRecord(payload)`
+- `normalizeMemberSummaryRow(row)`
+Local functions
+- `normalizeMembershipPatchPayload(payload = {})`
 
 ### `src/server/common/repositories/workspacesRepository.js`
 Exports
 - `createRepository(knex)`
-- `mapRow(row)`
-- `mapMembershipWorkspaceRow(row)`
+- `normalizeWorkspaceRecord(payload)`
+- `normalizeMembershipWorkspaceRow(row)`
+Local functions
+- `normalizeCreatePayload(payload = {})`
+
+### `src/server/common/resources/workspaceInvitesResource.js`
+Exports
+- `workspaceInvitesResource`
+Local functions
+- `normalizeInviteRecord(payload = {})`
+- `normalizeInviteInput(payload = {})`
+
+### `src/server/common/resources/workspaceMembershipsResource.js`
+Exports
+- `workspaceMembershipsResource`
+Local functions
+- `normalizeMembershipRecord(payload = {})`
+- `normalizeMembershipInput(payload = {})`
+
+### `src/server/common/resources/workspacesResource.js`
+Exports
+- `workspacesResource`
+Local functions
+- `normalizeWorkspaceRecord(payload = {})`
+- `normalizeWorkspaceInput(payload = {})`
 
 ### `src/server/common/services/workspaceContextService.js`
 Exports
@@ -160,7 +188,7 @@ Exports
 
 ### `src/server/workspaceBootstrapContributor.js`
 Exports
-- `createWorkspaceBootstrapContributor({ workspaceService, workspacePendingInvitationsService, usersRepository, workspaceInvitationsEnabled = false, appConfig = {}, tenancyProfile = null } = {})`
+- `createWorkspaceBootstrapContributor({ workspaceService, workspacePendingInvitationsService, userProfilesRepository, workspaceInvitationsEnabled = false, appConfig = {}, tenancyProfile = null } = {})`
 Local functions
 - `normalizePendingInvites(invites)`
 - `normalizeQueryPayload(value = {})`

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

@@ -323,8 +323,8 @@ Local functions
 
 ### `src/shared/toolsOutletContracts.js`
 Exports
-- `DEFAULT_TOOLS_LINK_COMPONENT_TOKEN`
-- `WORKSPACE_TOOLS_OUTLET`
+- `DEFAULT_COG_LINK_COMPONENT_TOKEN`
+- `ADMIN_COG_OUTLET`
 
 ### templates
 
@@ -337,6 +337,10 @@ Local functions
 - `resolveReturnToHref()`
 - `countPendingInvites(entries = [])`
 
+### `templates/packages/main/src/client/components/AccountSettingsInvitesSection.vue`
+Exports
+- None
+
 ### `templates/src/components/WorkspaceNotFoundCard.vue`
 Exports
 - None