@jskit-ai/agent-docs 0.1.122 → 0.1.123

package/guide/agent/app-extras/mobile-capacitor.md

@@ -230,8 +230,8 @@ It also means:
 - the backend must be running on your laptop
 - the app needs an `adb reverse` tunnel
 
-If `apiBaseUrl` later points to a real remote `https://...` backend, the tunnel
-is no longer required.
+An `apiBaseUrl` that points to a remote `https://...` backend uses the device's
+normal network connection and does not need the tunnel.
 
 ## A good day-to-day loop
 

package/guide/agent/app-setup/authentication.md

@@ -523,7 +523,7 @@ To use it, install a JSKIT database runtime and driver, install `auth-provider-l
 
 There are two database-backed paths, and they solve different problems.
 
-For normal app users and account settings, install the database runtime, install `users-web`, then run the migrations. That gives the app the `users` and `user_settings` tables through `users-core`, plus the `auth.profile.projector` bridge that projects a provider identity into a persistent JSKIT user profile.
+For normal app users and account settings, install the database runtime, install `users-web`, then run the migrations. That gives the app the `users` and `user_settings` tables through `users-core`, plus the `auth.profile.projector` service that projects a provider identity into a persistent JSKIT user profile.
 
 For local auth credentials and sessions in SQL, keep `AUTH_PROVIDER=local`, install `auth-provider-local-db-core`, set `AUTH_LOCAL_BACKEND=db`, and run migrations. That package owns `auth_local_users`, `auth_local_sessions`, and `auth_local_recovery`, and registers the transactional `auth.local.backend` implementation.
 
@@ -560,7 +560,7 @@ registerAuthServiceDecorator(app, "app.auth.local.permissions", (scope) => {
 
 The hook must declare `blocking: true` or `blocking: false`. A blocking hook is awaited and its failure rejects the register call, which fits permission provisioning or other work the app needs before treating registration as complete. A non-blocking hook is scheduled after registration and logs failures, which fits audit logging or metrics. This helper runs after local auth registration and profile projection have succeeded; it does not share the local auth backend transaction. If the extension must be transaction-coupled with credential storage, wrap or replace `auth.local.backend` instead.
 
-The local provider also has a separate password strategy seam. Use `auth.local.backend` to change where local auth records are stored. Use `auth.local.passwordStrategy` only when the app needs to change how passwords are hashed or verified, such as during a migration from an existing user table with existing password hashes.
+The local provider also has a separate password strategy seam. Use `auth.local.backend` to change where local auth records are stored. Use `auth.local.passwordStrategy` only when the app owns a different password-record format or verification algorithm.
 
 Register `auth.local.passwordStrategy` before `AuthLocalServiceProvider` starts:
 
@@ -579,7 +579,7 @@ app.singleton("auth.local.passwordStrategy", () => ({
 }));
 ```
 
-The strategy object can provide `hashPassword(password)`, `verifyPassword(password, storedPasswordRecord)`, or both. Missing methods fall back to the local provider's default scrypt implementation, so a migration verifier can accept old hashes while new registrations, resets, and password changes continue to write default JSKIT password records. JSKIT validates provided methods as functions and calls them with `this` bound to the strategy object.
+The strategy object can provide `hashPassword(password)`, `verifyPassword(password, storedPasswordRecord)`, or both. Missing methods use the local provider's default scrypt implementation. JSKIT validates provided methods as functions and calls them with `this` bound to the strategy object.
 
 Custom service callers can pass the same object directly:
 
@@ -591,7 +591,7 @@ createLocalAuthService({
 });
 ```
 
-JSKIT core does not install bcrypt or any legacy password dependency. If an app needs a legacy verifier, the app owns that dependency and keeps the backend as storage only.
+JSKIT core does not install bcrypt. An app that selects bcrypt owns that dependency and keeps the backend focused on storage.
 
 If you later configure local SMTP password recovery, also set `APP_PUBLIC_URL` so reset links point back to the browser URL for this app.
 

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

@@ -449,7 +449,7 @@ That is exactly the kind of page `useWorkspaceRouteContext()` is for:
 ```vue
 <script setup>
 import { computed } from "vue";
-import { usePaths } from "@jskit-ai/users-web/client/composables/usePaths";
+import { usePaths } from "@jskit-ai/shell-web/client/navigation/usePaths";
 import { useWorkspaceRouteContext } from "@jskit-ai/workspaces-web/client/composables/useWorkspaceRouteContext";
 
 const { workspaceSlugFromRoute, currentSurfaceId } = useWorkspaceRouteContext();

package/guide/agent/app-setup/upgrade-beta-1-to-final.md

@@ -105,6 +105,11 @@ npx jskit migrations sync
 
 Review the migration diff. Existing Knex migration files and migration-table history remain intact.
 
+Runtime-package migration mutations must be deterministic without install
+options. Convert an option-parameterized runtime migration into a generator
+mutation, or materialize it as a fixed app-local package migration before the
+upgrade.
+
 Generate the JSKIT CI workflow:
 
 ```bash
@@ -132,3 +137,13 @@ npm run db:migrate
 ```
 
 Commit package manifests, `package-lock.json`, synchronized migrations, generated CI, and required application changes together.
+
+## 9. Update strict resource boundaries
+
+Applications that pass JavaScript `Date` objects into resource validation must convert them to strings. `date` uses `YYYY-MM-DD`; `time` uses offset-free `HH:MM[:SS[.fraction]]`; and `dateTime` uses RFC 3339 with seconds and a `Z` or numeric offset. Select `epochMilliseconds` or `epochSeconds` explicitly for numeric epochs and preserve `temporalPrecision`.
+
+Generated generic CRUD repositories serialize supported database temporal output. Custom repositories must return strict temporal strings and write ISO/RFC 3339 strings themselves.
+
+For a generated view that needs delete confirmation, rerun its `crud-ui-generator crud` command with `--delete-confirmation`. Use `--force` only when replacing generated page output deliberately. For a customized view, preserve the customization and add the public `CrudViewScreen` `actions` slot, `CrudDeleteAction`, and `useCrudDeleteAction()` integration.
+
+Review the complete application diff and run its full verification suite before applying database migrations.

package/guide/agent/app-setup/users.md

@@ -132,7 +132,7 @@ That one binding explains the deepest change in the chapter.
 
 Before this chapter, auth could authenticate a user without creating a persistent app-owned user row. After this chapter, auth providers can call `auth.profile.projector.syncIdentityProfile(...)` and get back a persistent users-backed profile.
 
-`users-core` also writes this server-only config line for Supabase compatibility:
+`users-core` also selects users-backed Supabase profile projection:
 
 ```js
 config.auth ||= {};

package/guide/agent/app-setup/working-with-the-jskit-cli.md

@@ -196,6 +196,10 @@ npx jskit migrations sync --check
 
 Migration ids are immutable. The same package and migration id must always produce the same content. A conflict fails instead of overwriting migration history.
 
+Runtime-package migrations are deterministic projections and cannot reference
+install options. Use a generator when a migration must be parameterized for a
+specific generated feature.
+
 Synchronization changes files only. Apply database migrations separately:
 
 ```bash

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

@@ -738,6 +738,8 @@ const resource = useEndpointResource({
 If you need a custom scoped endpoint path outside the higher-level runtimes, prefer `usePaths().api(...)` rather than hand-building scoped URLs:
 
 ```js
+import { usePaths } from "@jskit-ai/shell-web/client/navigation/usePaths";
+
 const paths = usePaths();
 const reportsApiPath = computed(() => paths.api("/reports"));
 ```

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

@@ -69,31 +69,12 @@ The server generator resolves the complete package closure. `shell-web`
 establishes and owns `src/placement.js` before `realtime` contributes its
 placement, so do not pre-install the shell as a workaround.
 
-## Existing-app migration checklist
-
-Strict temporal resource values require one coordinated application migration.
-There is no compatibility alias or automatic coercion for JavaScript `Date`
-objects at resource boundaries:
-
-1. Commit the application's current work and update its direct `@jskit-ai/*`
-   dependencies to one coordinated, exact release set.
-2. If the application declares `json-rest-schema` directly, use
-   `json-rest-schema` 1.0.17 or newer and review its temporal validation before
-   installing dependencies.
-3. Replace resource-bound JavaScript `Date` values with strings. `date` is
-   `YYYY-MM-DD`; `time` is offset-free `HH:MM[:SS[.fraction]]`; and `dateTime`
-   is RFC 3339 with seconds and a `Z` or numeric offset. Use
-   `epochMilliseconds` or `epochSeconds` only after checking the existing
-   numeric unit. Preserve `temporalPrecision`.
-4. For a standard generated view delete action, rerun the original
-   `crud-ui-generator crud` command with `--delete-confirmation`. Add `--force`
-   only when you deliberately want to replace generated page output. For a
-   customized view, preserve the customization and add the public
-   `CrudViewScreen` `actions` slot, `CrudDeleteAction`, and
-   `useCrudDeleteAction()` integration described below.
-5. Review the generated diff, keep application-owned customizations and browser
-   tests, then run the application's full verification suite before applying
-   database migrations.
+## Temporal values
+
+Temporal resource values are strings. `date` is `YYYY-MM-DD`; `time` is
+offset-free `HH:MM[:SS[.fraction]]`; and `dateTime` is RFC 3339 with seconds
+and a `Z` or numeric offset. Numeric epochs use `epochMilliseconds` or
+`epochSeconds`. Preserve `temporalPrecision`.
 
 Generated generic CRUD repositories convert database temporal values at the
 resource boundary. Custom repositories still need to return strict temporal
@@ -946,7 +927,7 @@ Use this when:
 
 It is a maintenance tool, not the first step in the workflow.
 
-It patches the canonical `schema` inside the shared resource file. That matters because the standard CRUD validators are derived from that canonical schema; you are no longer maintaining separate authored `create` / `patch` / `view` validator blocks by hand.
+It patches the canonical `schema` inside the shared resource file. The standard CRUD validators are derived from that schema, so one authored field definition drives `create`, `patch`, and `view` validation.
 
 ## Summary
 

package/guide/agent/index.md

@@ -40,6 +40,3 @@ It starts with a fast reproducible Quickstart, then steps back to the scaffold-f
 - Use `App Extras` once the base app structure is in place and you want optional runtime packages such as the Android shell, realtime, or assistant.
 - Jump into `Generators` if you already understand the runtime packages and want app-owned scaffolding workflows.
 - Inside `Generators`, read `CRUD Generators` before `Advanced CRUDs`: the first chapter teaches the workflow, and the second explains the generated anatomy and customization points.
-- Updating an existing app for strict temporal values or generated record
-  deletion? Go straight to the
-  [Existing-app migration checklist](/guide/generators/crud-generators#existing-app-migration-checklist).

package/package.json

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

package/patterns/client-requests.md

@@ -13,7 +13,7 @@ Rules:
 - Prefer the highest-level JSKIT runtime that matches the UI interaction.
 - Do not hand-roll local AJAX helpers when an existing JSKIT runtime already fits.
 - Do not use raw `fetch(...)` for normal app work.
-- Use `usePaths().api(...)` for custom scoped API paths instead of concatenating route params into URLs by hand.
+- Use `usePaths().api(...)` from `@jskit-ai/shell-web/client/navigation/usePaths` for custom scoped API paths instead of concatenating route params into URLs by hand.
 - Drop to `usersWebHttpClient.request(...)` only for exceptional low-level cases.
 
 Choose the function like this:

package/patterns/crud-scaffolding.md

@@ -38,8 +38,8 @@ workaround.
 
 Before database, schema, CRUD, repository, or persistence work, read this
 pattern completely. Use the database selected for this app's development
-runtime; never alter a production, legacy, historical, or other valuable
-database to develop or verify schema changes. Prove the complete migration
+runtime; never alter a production or other valuable database to develop or
+verify schema changes. Prove the complete migration
 chain against a fresh disposable database before reporting completion.
 
 For normal app-owned CRUD tables:
@@ -103,8 +103,8 @@ Rules:
 
 ## Temporal values at resource boundaries
 
-`json-rest-schema` 1.0.17 accepts strict string temporal values. Resource
-validators no longer coerce JavaScript `Date` objects:
+Resource validators accept strict string temporal values and reject JavaScript
+`Date` objects:
 
 - `date` is `YYYY-MM-DD`
 - `time` is offset-free `HH:MM[:SS[.fraction]]`

package/reference/autogen/packages/agent-docs.md

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/agent-docs/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

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

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/assistant-core/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

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

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/assistant-runtime/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

package/reference/autogen/packages/assistant.md

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/assistant/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

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

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/auth-core/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 
@@ -45,7 +45,6 @@ Exports
 Exports
 - `createAuthIdentityId(provider, providerUserId)`
 - `normalizeAuthActor(value = {}, options = {})`
-- `buildLegacyProfileFromActor(actorLike)`
 - `normalizeAuthResult(value = {}, options = {})`
 Local functions
 - `normalizeDisplayName(value, email = "")`
@@ -126,7 +125,6 @@ Exports
 - `mergeAuthPolicy`
 - `createAuthIdentityId`
 - `normalizeAuthActor`
-- `buildLegacyProfileFromActor`
 - `normalizeAuthResult`
 - `AUTH_OPERATION_UNSUPPORTED_CODE`
 - `createUnsupportedAuthOperationError`

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

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/auth-provider-local-core/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

package/reference/autogen/packages/auth-provider-local-db-core.md

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/auth-provider-local-db-core/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

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

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/auth-provider-supabase-core/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

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

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/auth-web/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

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

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/console-core/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

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

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/console-web/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

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

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/crud-core/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

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

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/crud-server-generator/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

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

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/crud-ui-generator/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

package/reference/autogen/packages/database-runtime-mysql.md

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/database-runtime-mysql/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

package/reference/autogen/packages/database-runtime-postgres.md

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/database-runtime-postgres/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

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

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/database-runtime/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

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

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/feature-server-generator/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

package/reference/autogen/packages/google-rewarded-core.md

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/google-rewarded-core/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

package/reference/autogen/packages/google-rewarded-web.md

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/google-rewarded-web/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

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

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/http-runtime/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

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

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/json-rest-api-core/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

package/reference/autogen/packages/kernel.md

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/kernel/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 
@@ -1569,6 +1569,7 @@ Exports
 
 ### `internal/node/installedPackages.js`
 Exports
+- `JSKIT_PACKAGE_CONFIG_KEYS`
 - `ROOT_DEPENDENCY_SECTIONS`
 - `collectPackageDependencyIds(packageJson = {})`
 - `collectRootDependencySpecifiers(packageJson = {})`

package/reference/autogen/packages/mobile-capacitor.md

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/mobile-capacitor/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

package/reference/autogen/packages/realtime.md

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/realtime/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

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

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/resource-core/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

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

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/resource-crud-core/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

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

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/shell-web/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 
@@ -250,6 +250,20 @@ Local functions
 - `materializeSurfaceRouteBase(routeBaseTemplate = "/", { params = {}, strictParams = true, surface = "" } = {})`
 - `resolveSurfaceBasePath(context = null, surface = "", { params = {}, strictParams = true } = {})`
 
+### `src/client/navigation/usePaths.js`
+Exports
+- `usePaths({ routeContext: sourceRouteContext = null } = {})`
+Local functions
+- `normalizePathSuffix(value = "")`
+- `resolveSurfaceId(value, fallback = "")`
+- `resolveDefaultSurfaceIdFromPlacementContext(placementContext = null)`
+- `normalizeRouteParams(params = null)`
+- `resolveRouteParams(baseParams = {}, overrideParams = null)`
+
+### `src/client/navigation/useSurfaceRouteContext.js`
+Exports
+- `useSurfaceRouteContext()`
+
 ### `src/client/placement/debug.js`
 Exports
 - `DEFAULT_DEBUG_DEPTH`

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

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/storage-runtime/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

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

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/ui-generator/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

package/reference/autogen/packages/uploads-image-web.md

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/uploads-image-web/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

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

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/uploads-runtime/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

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

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/users-core/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

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

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/users-web/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 
@@ -435,9 +435,8 @@ Local functions
 - `normalizePlainObject(value = null)`
 - `normalizeRequestRecoveryInput(requestRecovery = null)`
 - `normalizeRequestRecoveryMethod(value = "")`
-- `isRequestRecoveryMetaDisabled(sourceJskitMeta = {}, sourceMeta = {})`
+- `isRequestRecoveryMetaDisabled(sourceJskitMeta = {})`
 - `hasUsableMetaValue(source = {}, key = "")`
-- `hasRequestRecoveryMetaValue(sourceJskitMeta = {}, sourceMeta = {}, key = "")`
 - `resolveRequestRecoveryDefaults(queryOptions = null, defaults = {})`
 
 ### `src/client/composables/support/routeTemplateHelpers.js`
@@ -575,16 +574,6 @@ Local functions
 - `defaultGetNextPageParam(lastPage)`
 - `normalizeQueryKeyValue(queryKey = null)`
 
-### `src/client/composables/usePaths.js`
-Exports
-- `usePaths({ routeContext: sourceRouteContext = null } = {})`
-Local functions
-- `normalizePathSuffix(value = "")`
-- `resolveSurfaceId(value, fallback = "")`
-- `resolveDefaultSurfaceIdFromPlacementContext(placementContext = null)`
-- `normalizeRouteParams(params = null)`
-- `resolveRouteParams(baseParams = {}, overrideParams = null)`
-
 ### `src/client/composables/useRealtimeQueryInvalidation.js`
 Exports
 - `resolveOperationRealtimeOptions({ realtime = undefined, fallbackRealtime = null } = {})`
@@ -602,10 +591,6 @@ Exports
 Local functions
 - `resolveScopedRouteParamNames(placementContext = null, surfaceId = "")`
 
-### `src/client/composables/useSurfaceRouteContext.js`
-Exports
-- `useSurfaceRouteContext()`
-
 ### `src/client/filters.js`
 Exports
 - `CRUD_LIST_FILTER_TYPE_FLAG`

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

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/workspaces-core/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

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

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `packages/workspaces-web/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

package/reference/autogen/tooling/config-eslint.md

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `tooling/config-eslint/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

package/reference/autogen/tooling/create-app.md

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `tooling/create-app/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

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

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `tooling/jskit-catalog/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

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

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `tooling/jskit-cli/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 
@@ -111,14 +111,12 @@ Local functions
 
 ### `src/server/cliRuntime/ci/managedWorkflow.js`
 Exports
-- `assertAppCiCanSynchronize({ appRoot })`
 - `composeInstalledPackageCi({ packageRegistry, installedPackageIds = null })`
 - `synchronizeAppCiWorkflow({ appRoot, dryRun = false })`
 - `synchronizeCiWorkflow({ appRoot, packageRegistry, installedPackageIds = null, touchedFiles = null, dryRun = false })`
 Local functions
 - `collectInstalledPackageEntries({ packageRegistry, installedPackageIds = null })`
 - `inspectCiFiles(appRoot)`
-- `assertCiCanSynchronize({ appRoot })`
 
 ### `src/server/cliRuntime/completion.js`
 Exports
@@ -362,12 +360,13 @@ Local functions
 ### `src/server/cliRuntime/packageMetadataValidation.js`
 Exports
 - `validatePackageMetadataShape(packageMetadata, metadataPath)`
-- `validateAppLocalPackageMetadataShape(packageMetadata, metadataPath, { expectedPackageId = "", fallbackVersion = "" } = {})`
+- `validateAppLocalPackageMetadataShape(packageMetadata, metadataPath, { expectedPackageId = "" } = {})`
 - `createPackageEntry({ packageId, version, packageMetadata, rootDir = "", relativeDir = "", manifestRelativePath = "", packageJson = {}, sourceType = "", source = {} })`
 - `isGeneratorPackageEntry(packageEntry)`
 Local functions
 - `normalizePackageKind(rawValue, metadataPath)`
-- `validateFileMutationShape(packageMetadata, metadataPath)`
+- `conditionUsesPackageOption(rawCondition)`
+- `validateFileMutationShape(packageMetadata, metadataPath, { packageKind = "" } = {})`
 - `validateSourceMutationShape(packageMetadata, metadataPath)`
 - `validateLifecycleHookSpec(spec = {}, metadataPath, label = "lifecycle hook")`
 - `validateLifecycleShape(packageMetadata, metadataPath)`
@@ -555,14 +554,6 @@ Local functions
 Exports
 - `createHealthCommands(ctx = {})`
 
-### `src/server/commandHandlers/helperMap.js`
-Exports
-- `createHelperMapCommands(ctx = {})`
-Local functions
-- `writeJson(stdout, payload)`
-- `writeErrors(stdout, payload)`
-- `writeHelperMapText(stdout, payload)`
-
 ### `src/server/commandHandlers/list.js`
 Exports
 - `createListCommands(ctx = {})`
@@ -840,7 +831,6 @@ Exports
 Exports
 - `COMMAND_IDS`
 - `OPTION_FLAG_LABELS`
-- `resolveCommandAlias(rawCommand)`
 - `resolveCommandDescriptor(rawCommand)`
 - `isKnownCommandName(rawCommand)`
 - `listOverviewCommandDescriptors()`
@@ -874,46 +864,6 @@ Local functions
 - `printTopLevelHelp(stream = process.stderr)`
 - `printCommandHelp(stream = process.stderr, command = "")`
 
-### `src/server/helperMap.js`
-Exports
-- `HELPER_MAP_JSON_RELATIVE_PATH`
-- `HELPER_MAP_MARKDOWN_RELATIVE_PATH`
-- `buildHelperMap({ targetRoot, previousMap = null })`
-- `readHelperMap({ targetRoot })`
-- `updateHelperMap({ targetRoot })`
-Local functions
-- `pathExists(filePath)`
-- `readJsonFile(filePath)`
-- `readFileHash(filePath)`
-- `normalizePackageDependencies(packageJson = {})`
-- `classifySymbol(name = "")`
-- `createExportAnalysisProject()`
-- `addSymbol(symbols, symbol)`
-- `compilerNodeHasModifier(node, modifierKind)`
-- `exportedDeclarationName(node)`
-- `addExportedDeclarationSymbol(symbols, node, kind = "export")`
-- `bindingNameTexts(bindingName, names = [])`
-- `addVariableStatementExports(symbols, statement)`
-- `addNamedExportSymbols(symbols, exportClause)`
-- `extractExportedSymbols(sourceFile)`
-- `extractVueScriptSource(source = "", filePath = "")`
-- `addCodeFileToProject(project, file)`
-- `walkCodeFiles(rootPath, relativeRoot = "")`
-- `collectAppExports(targetRoot)`
-- `flattenPackageExports(exportsField)`
-- `packageExportTargetRecords(packageRoot, exportTargets = [])`
-- `packageExportFingerprint({ installedPackageJson = {}, packageName = "", targetRecords = [] } = {})`
-- `cachedPackageExports(previousPackagesByName = new Map(), packageName = "", fingerprint = "")`
-- `previousPackageMap(previousMap = null)`
-- `collectJskitPackageExports(targetRoot, packageJson = {}, previousMap = null)`
-- `renderExportList(symbols = [])`
-- `renderHelperMapMarkdown(map)`
-
-### `src/server/helperMapPaths.js`
-Exports
-- `HELPER_MAP_JSON_RELATIVE_PATH`
-- `HELPER_MAP_MARKDOWN_RELATIVE_PATH`
-
 ### `src/server/index.js`
 Exports
 - `runCli`

package/reference/autogen/tooling/test-support.md

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `tooling/test-support/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

package/reference/autogen/tooling/testUtils.md

@@ -8,7 +8,7 @@ Use this on demand; do not load the full index at startup.
 
 ## Scope
 - Source: `tooling/testUtils/**/*{.js,.mjs,.cjs,.vue}`
-- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 
@@ -28,9 +28,9 @@ Exports
 
 ### `jskitPackage.mjs`
 Exports
-- `writeJskitPackageMetadata(packageRoot, metadataOrExpression)`
+- `writeJskitConfig(packageRoot, jskitOrSource)`
 Local functions
-- `resolveMetadata(metadataOrExpression)`
+- `resolveJskitConfig(jskitOrSource)`
 
 ### `runCli.js`
 Exports

package/skills/jskit/references/crud-operations.md

@@ -96,9 +96,9 @@ With `json-rest-schema` 1.0.17, temporal resource values are strings:
 - `dateTime`: RFC 3339 with seconds and `Z` or a numeric offset
 
 Do not pass JavaScript `Date` objects through resource validation; convert at
-the boundary (normally `toISOString()` for `dateTime`). `timestamp` is removed:
-after checking the existing unit, use `epochMilliseconds` or `epochSeconds`.
-Honor `temporalPrecision` without silently truncating fractions. Generated CRUD
+the boundary (normally `toISOString()` for `dateTime`). Numeric epochs use
+`epochMilliseconds` or `epochSeconds`. Honor `temporalPrecision` without
+silently truncating fractions. Generated CRUD
 serializes supported database temporal output; custom repositories must return
 strict strings and write ISO/RFC 3339 strings themselves.