@jskit-ai/agent-docs 0.1.278 → 0.1.280

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

@@ -92,6 +92,9 @@ Exports
 ### `src/server/jsonApiModule/repository.js`
 Exports
 - `createCrudJsonApiRepository({ api, resource, resourceScopeName })`
+- `type WriteReturning`
+Local functions
+- `writeReturning(options, fallback = "full")`
 
 ### `src/server/jsonApiModule/routes.js`
 Exports

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

@@ -43,10 +43,6 @@ Local functions
 - `isActionExecuting(action)`
 - `actionLabel(action = {})`
 
-### `src/client/components/CrudListCreateAction.vue`
-Exports
-- None
-
 ### `src/client/components/CrudListDateFilterControl.vue`
 Exports
 - None
@@ -724,8 +720,6 @@ Exports
 ### `fixtures/crud-screens/main.js`
 Exports
 - None
-Local functions
-- `destination(order, label, suffix, icon)`
 
 ### `fixtures/crud-screens/vite.config.mjs`
 Exports

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

@@ -19,16 +19,16 @@ Exports
 - `addResourceIfMissing(api, scopeName, resourceConfig)`
 - `buildJsonRestQueryParams(resourceType = "", query = {}, { include = undefined } = {})`
 - `createJsonRestResourceScopeOptions(resource = {}, { writeSerializers = {}, normalizeId, rowPolicy, searchSchema, queryFields } = {})`
-- `createJsonRestContext(context = null)`
-- `extractJsonRestCollectionRows(payload)`
-- `queryAllJsonRestCollectionRows(resource, { queryParams, ...params }, context)`
+- `createJsonRestContext`
+- `extractJsonRestCollectionRows`
+- `queryAllJsonRestCollectionDocument`
+- `queryAllJsonRestCollectionRows`
 - `returnNullWhenJsonRestResourceMissing(run)`
 - `returnBadRequestWhenJsonRestFieldsetInvalid(run)`
 - `resolveWorkspaceScopeValue(context = null)`
 - `resolveUserScopeValue(context = null)`
 - `createJsonRestApiHost({ knex, logger })`
 Local functions
-- `isPlainJsonRestObject(value)`
 - `cloneJsonRestResourceValue(value, { writeSerializers = {} } = {})`
 - `normalizeScopeValue(value)`
 - `normalizeJsonRestFilterValue(value)`
@@ -47,6 +47,19 @@ Local functions
 Exports
 - `JsonRestApiProvider`
 
+### `src/server/jsonRestCollectionReads.js`
+Exports
+- `createJsonRestContext(context = null)`
+- `extractJsonRestCollectionRows(payload)`
+- `queryAllJsonRestCollectionDocument(resource, params, context)`
+- `queryAllJsonRestCollectionRows(resource, params, context)`
+Local functions
+- `readEveryJsonRestCollectionPage(resource, { queryParams, ...params }, context, { caller, onPage })`
+
+### `src/server/jsonRestValues.js`
+Exports
+- `isPlainJsonRestObject(value)`
+
 ### `src/server/types.js`
 Exports
 - `type RuntimeJsonRestApi`

package/reference/autogen/packages/kernel.md

@@ -536,6 +536,8 @@ Local functions
 - `ignoreBootstrapStep()`
 - `installAppPlugins(app, appPlugins = [])`
 - `isSurfaceRootRecord(record)`
+- `hostsChildViews(record)`
+- `hashScrollMargin(hash)`
 
 ### `client/shellRouting.js`
 Exports
@@ -579,6 +581,9 @@ Exports
 Exports
 - `installedClientModules`
 - `bootInstalledClientModules(context = {})`
+- `VUETIFY_LAYER_ORDER`
+- `namedCascadeLayers(css)`
+- `checkVuetifyLayerOrder(stylesheets = [])`
 - `CLIENT_BOOTSTRAP_VIRTUAL_ID`
 - `CLIENT_BOOTSTRAP_RESOLVED_ID`
 - `createVirtualModuleSource(clientModules, localePackageIds)`
@@ -593,6 +598,7 @@ Exports
 - `resolveInstalledViteProxyEntries(installedPackages = [], { proxyTarget = "" } = {})`
 - `createJskitClientBootstrapPlugin({ proxyTarget = "" } = {})`
 Local functions
+- `builtPageStylesheets(bundle)`
 - `isLocalScopePackageId(value)`
 - `readJsonFile(filePath, fallback)`
 - `hasClientExport(packageJson)`
@@ -637,7 +643,10 @@ Exports
 Local functions
 - `normalizeActionDomain(value, { context = "domain" } = {})`
 - `normalizeStringArray(value, fieldName)`
-- `normalizeActionSchema(value, fieldName, { required = false, defaultMode = "" } = {})`
+- `schemaFieldDefinitions(value)`
+- `refuseOneOfFields(fields, fieldName, parentPath = "")`
+- `refuseOneOfField(definition, fieldName, path)`
+- `normalizeActionSchema(value, fieldName, { required = false, defaultMode = "", refuseOneOf = false } = {})`
 - `normalizeActionPermission(permission, actionId)`
 - `normalizeActionExtensions(value)`
 - `normalizeActionEvents(value, actionId)`

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

@@ -33,8 +33,9 @@ Exports
 ### `src/client/index.js`
 Exports
 - `materialThemes`
-- `createMaterialVuetifyOptions({ seed = DEFAULT_SEED, colors = {}, icons = {} } = {})`
+- `createMaterialVuetifyOptions({ seed = DEFAULT_SEED, colors = {}, icons = {}, typography = {} } = {})`
 Local functions
+- `typefaceVariables({ brand = ROBOTO_FLEX, plain = ROBOTO_FLEX } = {})`
 - `appIconAliases(icons)`
 
 ### `src/client/symbols.js`

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

@@ -125,15 +125,25 @@ Exports
 ### `src/client/components/ShellPageActionsTarget.vue`
 Exports
 - None
+Local functions
+- `itemProps(entry)`
 
 ### `src/client/components/ShellPageTitle.vue`
 Exports
 - None
 
+### `src/client/components/ShellPrimaryAction.vue`
+Exports
+- None
+
 ### `src/client/components/ShellRouteTransition.vue`
 Exports
 - None
 
+### `src/client/components/ShellSectionTabLinkItem.vue`
+Exports
+- None
+
 ### `src/client/components/ShellSurfaceAwareMenuLinkItem.vue`
 Exports
 - None
@@ -182,6 +192,14 @@ Exports
 - `shellNavigationLinkProps`
 - `useShellNavigationLink(props)`
 
+### `src/client/composables/useShellOutletPlacements.js`
+Exports
+- `useShellOutletPlacements(target, context = {})`
+
+### `src/client/composables/useShellPageClose.js`
+Exports
+- `useShellPageClose({ label, close })`
+
 ### `src/client/composables/useShellPageTitle.js`
 Exports
 - `useShellPageTitle(title)`
@@ -292,8 +310,10 @@ Exports
 - `ShellMenuLinkItem`
 - `ShellSurfaceAwareMenuLinkItem`
 - `ShellTabLinkItem`
+- `ShellSectionTabLinkItem`
 - `ShellPageActions`
 - `ShellPageAction`
+- `ShellPrimaryAction`
 - `ShellListDetail`
 - `ShellUpButton`
 - `ShellPageTitle`
@@ -301,6 +321,7 @@ Exports
 - `useShellAppBar`
 - `useShellLayoutState`
 - `useShellPageTitle`
+- `useShellPageClose`
 - `useShellWindowSizeClass`
 - `useShellNavigation`
 - `leaveApp`
@@ -327,7 +348,7 @@ Local functions
 
 ### `src/client/navigation/documentNavigation.js`
 Exports
-- `leaveApp(url)`
+- `leaveApp(url, { replace = false } = {})`
 - `reloadAppPage(target)`
 
 ### `src/client/navigation/linkResolver.js`
@@ -335,7 +356,7 @@ Exports
 - `resolveShellLinkPath({ context = null, surface = "", explicitTo = "", relativePath = "/", surfaceRelativePath = "", params = {}, strictParams = true } = {})`
 - `useShellLinkResolver({ surface = "" } = {})`
 Local functions
-- `materializeSurfaceRouteBase(routeBaseTemplate = "/", { params = {}, strictParams = true, surface = "" } = {})`
+- `fillPathParams(pathTemplate = "/", { params = {}, strictParams = true, label = "route params" } = {})`
 - `resolveSurfaceBasePath(context = null, surface = "", { params = {}, strictParams = true } = {})`
 
 ### `src/client/navigation/shellNavigationRuntime.js`
@@ -346,9 +367,11 @@ Exports
 - `createShellNavigationRuntime({ router })`
 - `resolvePageParent(matched)`
 - `resolvePageTitle(matched)`
+- `type ShellPageClose`
 Local functions
 - `normalizeTrail(value)`
 - `cssAttributeValue(value)`
+- `createClaimStack()`
 
 ### `src/client/navigation/usePaths.js`
 Exports
@@ -547,6 +570,8 @@ Exports
 - `normalizeDesktopDrawerClosedMode(value = "rail")`
 - `resolveShellDrawerPresentation({ modal = false, open = false, desktopClosedMode = "rail" } = {})`
 - `resolveShellDrawerToggleLabel({ modal = false, open = false } = {})`
+- `shellLayoutHasDrawer({ menuSlot = false, menuCount = 0, identityCount = 0, bottomNavigationCount = 0 } = {})`
+- `shellLayoutHasNavigationBar({ bottomNavigationCount = 0, menuCount = 0 } = {})`
 
 ### `src/client/support/drawerWidth.js`
 Exports
@@ -597,6 +622,18 @@ Exports
 - `VUETIFY_ICONS_KEY`
 - `filledIconAlias(icon, aliases)`
 
+### `src/client/support/pageActions.js`
+Exports
+- `NO_SHELL_PAGE_ACTIONS_REGISTRY`
+- `SHELL_PAGE_ACTIONS_REGISTRY_KEY`
+- `createShellPageActionsRegistry({ isCompact })`
+- `overflowEntries(entries, compact)`
+- `type ShellPageActionState`
+- `type ShellPageActionEntry`
+- `type ShellPageActionsRegistry`
+Local functions
+- `documentOrder(left, right)`
+
 ### `src/client/support/primaryNavigation.js`
 Exports
 - `normalizeComparablePathname(value = "")`
@@ -649,16 +686,42 @@ Exports
 
 ### fixtures
 
+### `fixtures/adaptive-shell/src/ActionsFormPage.vue`
+Exports
+- None
+
+### `fixtures/adaptive-shell/src/ActionsPage.vue`
+Exports
+- None
+
 ### `fixtures/adaptive-shell/src/App.vue`
 Exports
 - None
 
+### `fixtures/adaptive-shell/src/ButtonsPage.vue`
+Exports
+- None
+
+### `fixtures/adaptive-shell/src/ButtonStatesPage.vue`
+Exports
+- None
+
+### `fixtures/adaptive-shell/src/ComponentsPage.vue`
+Exports
+- None
+Local functions
+- `jumpToLastBooking()`
+
+### `fixtures/adaptive-shell/src/FeedbackPage.vue`
+Exports
+- None
+Local functions
+- `press(name)`
+
 ### `fixtures/adaptive-shell/src/main.js`
 Exports
 - None
 Local functions
-- `createSurfacePlacement(surface, order, label, suffix)`
-- `createSurfacePlacements(surface)`
 - `refuseBlockedRecord(to)`
 
 ### `fixtures/adaptive-shell/src/OwnBarLayout.vue`
@@ -677,6 +740,10 @@ Exports
 Exports
 - `records`
 
+### `fixtures/adaptive-shell/src/ReportsPage.vue`
+Exports
+- None
+
 ### `fixtures/adaptive-shell/src/ScreenPage.vue`
 Exports
 - None
@@ -685,6 +752,10 @@ Exports
 Exports
 - None
 
+### `fixtures/adaptive-shell/src/StatusButton.vue`
+Exports
+- None
+
 ### `fixtures/adaptive-shell/src/StudioPage.vue`
 Exports
 - None
@@ -694,10 +765,26 @@ Exports
 - `theme`
 - `adminTheme`
 
+### `fixtures/adaptive-shell/src/TitleClaim.vue`
+Exports
+- None
+
 ### `fixtures/adaptive-shell/vite.config.mjs`
 Exports
 - None
 
+### `fixtures/production-build/src/App.vue`
+Exports
+- None
+
+### `fixtures/production-build/src/main.js`
+Exports
+- None
+
+### `fixtures/production-build/vite.config.mjs`
+Exports
+- None
+
 ### patterns
 
 ### `patterns/application-shell/example/expected-existing/src/App.vue`
@@ -724,6 +811,10 @@ Exports
 Exports
 - None
 
+### `patterns/application-shell/example/src/components/menus/SectionTabLinkItem.vue`
+Exports
+- None
+
 ### `patterns/application-shell/example/src/components/menus/SurfaceAwareMenuLinkItem.vue`
 Exports
 - None

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

@@ -34,8 +34,7 @@ Exports
 Exports
 - None
 Local functions
-- `normalizeSection(value)`
-- `readRouteSection()`
+- `sectionTarget(value)`
 
 ### `src/client/components/ProfileClientElement.vue`
 Exports
@@ -209,6 +208,14 @@ Exports
 Exports
 - None
 
+### `patterns/account-settings/example/src/pages/account.vue`
+Exports
+- None
+
+### `patterns/account-settings/example/src/pages/account/[section].vue`
+Exports
+- None
+
 ### `patterns/account-settings/example/src/pages/account/index.vue`
 Exports
 - None

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

@@ -47,6 +47,8 @@ Exports
 - `createRepository({ api })`
 - `normalizeMembershipRecord(payload)`
 - `normalizeMemberSummaryRow(row)`
+Local functions
+- `memberSummaryFromMembership(row)`
 
 ### `src/server/common/repositories/workspacesRepository.js`
 Exports

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

@@ -74,12 +74,20 @@ Local functions
 
 ### `scripts/material3-source.mjs`
 Exports
+- `DEFAULT_IMPORT`
+- `TEMPLATE_TAG`
+- `VOID_TAGS`
 - `HEX_COLOUR`
+- `balancedFrom(text, start, open = "{", close = "}")`
 - `blankCssComments(source)`
 - `blankHtmlComments(source)`
 - `blankJsComments(source)`
+- `enclosingObject(text, offset)`
+- `exclusiveBranches(left, right)`
 - `kebab(name)`
 - `lineIndex(text)`
+- `localComponent(file, specifier, known)`
+- `readConditionalBranches(template)`
 - `readDeclarations(css, offset)`
 - `readExceptions(source)`
 - `readInlineDeclarations(text, offset)`
@@ -99,11 +107,13 @@ Exports
 - `formatNavigationReport(result)`
 Local functions
 - `hexPattern()`
+- `channelColour()`
 - `quotedHex()`
 - `isNavigationRule(rule)`
 - `isSkippedDirectory(name)`
 - `isSourceFile(relativePath)`
-- `walk(projectRoot, directory, files)`
+- `isFrameworkPackage(projectRoot, directory)`
+- `walk(projectRoot, directory, files, wholeApp = false)`
 - `collectFiles(projectRoot, paths)`
 - `createReporter(file, source, { navigationOnly = false } = {})`
 - `checkCode(code, offset, { report, themed })`
@@ -131,6 +141,7 @@ Exports
 - `checkScriptBackNames(code, offset, report)`
 - `isInAppPath(value)`
 - `isPageFile(file)`
+- `readTitledFiles({ root, appFiles })`
 Local functions
 - `compact(text)`
 - `isPlacementLink(code, offset)`
@@ -140,12 +151,11 @@ Local functions
 - `navigatesFromControl(tag, script)`
 - `attribute(tag, name)`
 - `visibleText(inner)`
-- `isBackTag(tag)`
+- `isBackComponentName(name)`
 - `looksLikeBack(tag)`
-- `balancedFrom(text, start, open = "{", close = "}")`
-- `enclosingObject(text, offset)`
 - `stringValue(text, key)`
 - `readMainNavigation(sources)`
+- `computedPlacementPart(placement)`
 - `normalisePath(value)`
 - `routeOf(file)`
 - `routePattern(route)`
@@ -153,10 +163,20 @@ Local functions
 - `surfaceOf(route, surfaces)`
 - `routeDeclarations(source)`
 - `readPage(file, source)`
-- `createShellBarReader(appFiles, read)`
-- `localComponent(file, specifier, known)`
+- `createShellBarReader(appFiles, read, tag = SHELL_UP_TAG)`
+- `shellPlacement(file, source, drawsShellBar, known, barTag = SHELL_UP_TAG)`
+- `rendersOutsideLayouts(code, name)`
+- `judgePackageRoute(route, { surfaces, appShell, drawsShellBar, isDestination, isAddress, readable, report })`
 - `pageKey(file)`
 
+### `scripts/package-routes.mjs`
+Exports
+- `readPackageRoutes(root, known)`
+Local functions
+- `isRecord(value)`
+- `clientEntryOf(manifest, directory)`
+- `readRouteComponents(entry, code, known)`
+
 ### `scripts/pattern-assets.mjs`
 Exports
 - `PATTERN_DOCUMENT_NAME`
@@ -216,6 +236,34 @@ Local functions
 - `alignLockManifestRecord(lockRecord, manifest, localPackageNames)`
 - `preparePackageLockForInstall(projectRoot, manifests, packageLockPath)`
 
+### `scripts/test-budget.mjs`
+Exports
+- `BUDGET_VARIABLE`
+- `testConcurrency({ env = process.env, parallelism = os.availableParallelism() } = {})`
+
+### `scripts/test-command.mjs`
+Exports
+- `planTestRuns(args, { cwd = process.cwd(), concurrency = testConcurrency() } = {})`
+- `runTests(args)`
+Local functions
+- `findTestFiles(patterns, cwd)`
+- `readAloneFiles(files, cwd)`
+- `runNode(args)`
+
+### `scripts/test-runs.mjs`
+Exports
+- `checkTestRuns({ projectRoot, manifests })`
+- `formatTestRunsReport(result)`
+Local functions
+- `commandsOf(script)`
+- `isProgram(token, name)`
+- `runsNodeTest(tokens)`
+- `runnerArguments(tokens, runner)`
+- `configOption(args)`
+- `lineOf(contents, needle, after = "")`
+- `findConfig(directory, explicit, names)`
+- `checkRunnerConfig({ root, configPath, directory, runner, report })`
+
 ### `scripts/verify-packages.mjs`
 Exports
 - `main()`
@@ -232,3 +280,4 @@ Local functions
 - `validateMigrationsAfter(packageJson)`
 - `validateMigrationDirectory(packageName, absoluteDirectory, relativeDirectory, migrationOwners)`
 - `validatePackage(packageRecord, localVersions, migrationOwners)`
+- `verifyTestRuns()`

package/reference/autogen/tooling/testUtils.md

@@ -14,13 +14,22 @@ Use this on demand; do not load the full index at startup.
 
 ### root
 
+### `browserExpect.mjs`
+Exports
+- `expect`
+
 ### `browserFixture.mjs`
 Exports
 - `createChromiumLaunchOptions({ env = process.env } = {})`
 - `reservePort()`
+- `sharedBrowserFixture(viteOptions)`
 - `startCapturedProcess(command, args, { cwd, env = {} } = {})`
-- `startViteFixture({ fixtureRoot, configFile = "vite.config.mjs", env = {}, port: requestedPort } = {})`
+- `startViteFixture({ fixtureRoot, configFile = "vite.config.mjs", env = {}, port: requestedPort, cacheDir: requestedCacheDir } = {})`
 - `stopProcess(runtime)`
+Local functions
+- `stopChild(child)`
+- `takeCacheDir(configPath)`
+- `returnCacheDir(configPath, cacheDir)`
 
 ### `fakeFastify.mjs`
 Exports
@@ -34,3 +43,8 @@ Exports
 - `readMaterialStyles(page, probes)`
 Local functions
 - `comparePixels(page, actual, expected)`
+- `waitForStillPage(page)`
+
+### `viteFixtureServer.mjs`
+Exports
+- None

package/skills/jskit/SKILL.md

@@ -58,6 +58,8 @@ manifests, migrations, tests, and runtime behaviour are the evidence.
      also read [Material 3](references/material-3.md) completely before acting.
    - For a UI pass (the changes, a section, or the whole app), also read
      [UI pass](references/ui-pass.md) completely.
+   - Before writing a list, save, batch or test, a refactor, or calling work
+     done, read [sanity checks](references/sanity-checks.md).
 
 These are complete operational references required by this skill. Do not load
 irrelevant references or other docs.
@@ -122,8 +124,16 @@ whole changeset. Use the current-state owners in application operations and
 Playwright for affected UI. There is no current JSKIT Doctor command; ignore
 old CLI authoring-history diagnoses. Never expose environment values.
 
-Tests and requests take the time their work needs, no more: a list reads each
-table once, a row policy is bounded by the rows it reads, list and batch paths
-have a query budget tested at realistic row counts, and test databases restore
-a stored snapshot instead of replaying migrations. Find why a check is slow;
-never raise its time limit. Typed features' repository and Tests rules say how.
+Tests and requests take the time their work needs, no more: count a list's or
+save's queries at a few rows and at a realistic number and
+judge whether they grow with the rows, and read the suite's time and its
+slowest files. Find why a check is slow; never raise its time limit. Typed
+features' repository and Tests rules say how.
+
+Test files run in parallel by default, bounded by the machine: a script runs
+`jskit test`, never `node --test` or a fixed `--test-concurrency`, and
+Playwright's `workers` and Vitest's `maxWorkers` are `testConcurrency()` from
+`@jskit-ai/jskit-catalog/test-budget`; plain `jskit check` fails anything else.
+Files that collide when run together get isolated (their own port, temporary
+directory and database), never serialised. A file that truly must run alone
+says why on its first line, `// jskit-test: alone - <reason>`.

package/skills/jskit/references/heuristics/INDEX.md

@@ -44,7 +44,9 @@ How to use it:
   - [crud-repository-mapping.md](./crud-repository-mapping.md)
 - row policy, permission filtering, visibility before pagination, recursive CTE, descendants, package cycle, `RowPolicyPlugin`, row policy cost, slow writes through a policy, access check per history item
   - [row-policies.md](./row-policies.md)
-- typed features, server feature, provider, service, repository, collaborator, `typeof`, `= null`, `setProvider`, `register`, `input || {}`, `payload = {}`, `async execute`, `Object.freeze`, `requires`, `optional`, `types.js`, `RuntimeKnex`, `silentLogger`, `create<Name>Actions`, `ActionSpecifications`, request context, `api.resources.x.query`, every row, list stops at 20 rows, `queryAllJsonRestCollectionRows`, `jskit/*` lint findings, `readable-check: allow`, `optional operation:`, `process.env`, `AppError` code, `Object.assign(new Error`, `idempotency`, `…ForTests` export, file or function size, read per row, N+1 queries, slow endpoint, query budget, realistic row counts, slow tests, raised timeout, `migrate.latest()` in tests, test database snapshot
+- typed features, server feature, provider, service, repository, collaborator, `typeof`, `= null`, `setProvider`, `register`, `input || {}`, `payload = {}`, `async execute`, `Object.freeze`, `requires`, `optional`, `types.js`, `RuntimeKnex`, `silentLogger`, `create<Name>Actions`, `ActionSpecifications`, request context, `api.resources.x.query`, every row, list stops at 20 rows, `queryAllJsonRestCollectionRows`, `jskit/*` lint findings, `readable-check: allow`, `optional operation:`, `process.env`, `AppError` code, `Object.assign(new Error`, `idempotency`, `…ForTests` export, file or function size, read per row, N+1 queries, slow endpoint, query budget, realistic row counts, slow tests, raised timeout, `migrate.latest()` in tests, test database snapshot, `--test-concurrency=1`, `node --test`, `jskit test`, `testConcurrency()`, `V64_TEST_CONCURRENCY`, Playwright `workers`, Vitest `maxWorkers`, tests one file at a time, test files colliding in parallel, `jskit-test: alone`, `test/*` findings of `jskit check`
   - [typed-features.md](./typed-features.md)
 - client features, composable, `use<Name>`, Vue component, client provider, props, emits, `inject`, `provide`, `ref`, `reactive`, `watch`, `addEventListener`, `setInterval`, module state, `Object.freeze` on a composable, `?.()` in a template, `jskit/typed-inject`, `jskit/collaborator-props`, `jskit/fixed-result-shape`, `jskit/released-listeners`, `jskit/no-module-state`, `jskit/no-frozen-vue-state`, `clientFeaturesConfig`, `shared resource:`
   - [client-features.md](./client-features.md)
+- sanity checks, is this sane, query count that grows with the rows, a list that stops at 20 or 100 rows, `createDocument()` per row of a batch, `jskit test`, one file at a time, test database preparation, `TEST_DB_NAME`, `mode: "patch"`, a route `rateLimit` nothing tests, `input.workspaceId`, a refactor or consolidation that drops behaviour, a JSKIT update, a changed theme or Vuetify default, `jskit.surface` with a parent, an assistant tool's output contract, a screen that renders everything, feedback covering an action, `NODE_ENV=production`, a production start
+  - [Sanity checks](../sanity-checks.md)

package/skills/jskit/references/heuristics/row-policies.md

@@ -39,9 +39,9 @@ Package composition:
 
 Cost:
 
-- a policy's cost follows the rows its query reads: add a join, `EXISTS` or subquery correlated with the row through `column()` and `value()`, on indexed columns
+- a policy's cost follows the rows its query reads: add a join, `EXISTS` or subquery correlated with the row through `column()` and `value()`, on indexed columns; look at its SQL too, since a statement that runs to kilobytes is planned again on every read that carries it
 - never load the subject's whole history (every source, notice or grant they were ever linked to) to build an `IN` list, and never call another owner's access check per item of it; another package's grant is a predicate contribution
-- the policy runs on every single-record read, including the read-back after `createDocument()` and `patchDocumentById()` (`returning: "full"`) and the lookup before `patch` and `delete`, so a write pays it once per row it writes
+- the policy runs on every single-record read, including the read-back after `createDocument()` and `patchDocumentById()` (`returning: "full"`, their default) and the lookup before `patch` and `delete`, so a write pays it once per row it writes
 - a write decides access once, inside its transaction; a batch write that would pay an expensive read-back per row follows the typed features guide's [Bounded access checks](../typed-features.md#bounded-access-checks)
 
 Child-resource rules:
@@ -58,7 +58,7 @@ Testing:
 - assert hidden direct records behave as not found
 - assert children and includes do not leak records
 - assert package and provider dependencies stay one-way
-- run one read and one write for a subject with a short history and with a realistic long one (hundreds of linked rows), and assert the same query count
+- count the queries of one read and one write for a subject with a short history and with a realistic long one (hundreds of linked rows), and fail when the count grows with the history
 
 AnyAPI boundary:
 

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

@@ -63,10 +63,10 @@ ends with the same link.
   - [One helper per package](../typed-features.md#one-helper-per-package)
 - `options?.trx || options?.transaction`, a hand-read actor, cursor or created id
   - [One reader per fact](../typed-features.md#one-reader-per-fact)
-- `api.resources.x.query(…)` with no `page` for a list, `queryDocuments(query)` with no `limit` in a service, a list that stops at 20 rows
+- `api.resources.x.query(…)` with no `page` for a list, `queryDocuments(query)` with no `limit` in a service, a list that stops at 20 rows, `page: { size: 500 }` or `limit: 500` that returns 100 rows
   - [Every row](../typed-features.md#every-row)
-- `await getDocumentById(…)`, `queryDocuments(…)` or a service `get` inside a loop or a `Promise.all` over a list, a single-record helper reused for a list, N+1 queries, a slow list endpoint
-  - [One read per table](../typed-features.md#one-read-per-table)
+- `await getDocumentById(…)`, `queryDocuments(…)` or a service `get` inside a loop or a `Promise.all` over a list, a single-record helper reused for a list, N+1 queries, a list whose query count grows with its rows, a slow list endpoint
+  - [Lists read related rows in batches](../typed-features.md#lists-read-related-rows-in-batches)
 - a `rowPolicy` that loads a person's whole history or calls an access check per item, `createDocument` per row of a batch, a write that gets slower as history grows
   - [Bounded access checks](../typed-features.md#bounded-access-checks)
 - a route that queries storage, `boot*.js` holding routes
@@ -85,10 +85,10 @@ ends with the same link.
   - [Tests are not callers](../typed-features.md#tests-are-not-callers)
 - `…ForTests`, `__reset…`, `testOnly…` exports (`jskit/no-test-only-export`)
   - [No test-only exports](../typed-features.md#no-test-only-exports)
-- a list, batch or write test with one to three rows, no query count, a slow endpoint first seen with real data
-  - [Budgets at realistic counts](../typed-features.md#budgets-at-realistic-counts)
-- a raised `{ timeout }`, `test.setTimeout()`, `--test-timeout` or Playwright `timeout`, retries or a request loop that absorbs slowness, a slow suite
-  - [Time limits are not fixes](../typed-features.md#time-limits-are-not-fixes)
+- a list, batch or write test with one to three rows, no query count, a fixed query ceiling tuned to pass, a slow endpoint first seen with real data
+  - [Query counts at realistic sizes](../typed-features.md#query-counts-at-realistic-sizes)
+- `node --test --test-concurrency=1`, `workers: 1`, `fileParallelism: false`, a suite that runs one file at a time, test files that collide when run together, `test/*` findings of `jskit check`
+  - [Test files run in parallel](../typed-features.md#test-files-run-in-parallel)
 - `knex.migrate.latest()` in each test file, a template database rebuilt by migrating, test preparation slower than its tests
   - [Test databases are prepared once](../typed-features.md#test-databases-are-prepared-once)
 - a file over 750 lines, a function over 600 (`max-lines`, `max-lines-per-function`), a data module

package/skills/jskit/references/heuristics/ui-testing.md

@@ -64,16 +64,17 @@ collision before connecting. Include disposable cleanup between browser starts
 in the regression: one test's teardown must not erase another test's migrations.
 
 Do not drop/recreate the database, replay completed migrations, build every
-module fixture, or run a production frontend build for each focused check.
-Choose small fixture sets for the selected suite; realistic row counts belong
-in the database tests that hold each endpoint's query budget. Fresh-schema
+module fixture, or run a production frontend build for each focused check. A
+build made once for a whole run is different: it is the fix when a development
+server makes every page load slow. Choose small fixture sets for the selected
+suite; realistic row counts belong in the database tests that compare each
+endpoint's query counts. Fresh-schema
 migration tests and production-artifact tests are separate operations. Measure
 migration, fixture, and server startup time and fix the slow phase; never retry
 a slow launch, or raise its deadline or a spec's timeout, to absorb it. A page
-that needs a longer timeout to load is a slow endpoint to fix (typed features'
-Time limits are not fixes). When a host supplies a managed target, use its
-scoped suite command so one startup serves the whole batch and cleanup
-restores normal Preview.
+that needs a longer timeout to load is a slow endpoint to fix. When a host
+supplies a managed target, use its scoped suite command so one startup serves
+the whole batch and cleanup restores normal Preview.
 
 ## Keep browser evidence focused