@jskit-ai/agent-docs 0.1.3 → 0.1.5

package/DISTR_AGENT.md

@@ -14,7 +14,7 @@ Use these references on demand:
 - `reference/autogen/KERNEL_MAP.md`
 - `reference/autogen/README.md`
 - `guide/agent/index.md`
-- `guide/human/index.md` when compressed guidance is ambiguous or missing nuance
+- `site/guide/index.md` when compressed guidance is ambiguous or missing nuance
 - `templates/APP_BLUEPRINT.md`
 - `templates/WORKBOARD.md`
 - `skills/jskit-review/SKILL.md` for review passes when your Codex environment supports packaged skills
@@ -22,10 +22,20 @@ Use these references on demand:
 Core rules:
 
 - Inspect the workspace before assuming a JSKIT app exists.
+- Before non-trivial edits, print a short visible checkpoint using this format:
+  - `Problem: ...`
+  - `Fix: ...`
+  - `Why this sticks: ...`
+  - `Not doing: ...`
+- Keep that checkpoint compact. Do not expand it into a long preamble unless the developer asks for detail.
 - Reuse existing JSKIT helpers and runtime seams before adding new local helpers.
 - A freshly scaffolded JSKIT app can still be in Stage 1. If platform decisions are not settled yet, continue with the initialize workflow before adding runtime packages.
 - Do not treat a missing `config.tenancyMode` line or an untouched minimal scaffold as a final tenancy decision.
 - Do not install tenancy-sensitive packages until Stage 1 decisions are complete and the chosen tenancy is written into `config/public.js`.
+- Treat standard JSKIT package-owned workflows as the default baseline once the relevant package stack is chosen. Do not ask the developer to redesign those flows unless they want overrides, restrictions, or custom additions.
+- Example: if the app is workspace-capable and uses `workspaces-core` plus `workspaces-web`, assume the standard workspace invite flow is part of the baseline package behavior.
+- For baseline package setup, ask plainly for the exact local development values needed for the next install step, but only for the modules or packages that are actually selected.
+- Use the real env var names or option names instead of vague requests for "credentials". Values such as `DB_NAME`, `DB_USER`, `DB_PASSWORD`, `AUTH_SUPABASE_URL`, `AUTH_SUPABASE_PUBLISHABLE_KEY`, and `APP_PUBLIC_URL` are routine setup inputs when the relevant package stack needs them.
 - Do not implement app features before the blueprint has the database, surfaces, ownership model, and route/screen plan written down.
 - For substantial or multi-chunk work, create or update `.jskit/WORKBOARD.md` as the per-request execution tracker.
 - Use the compressed guide first for speed; fall back to the human guide when a workflow trap, migration caveat, or architectural boundary needs exact wording.

package/guide/agent/app-extras/assistant.md

@@ -1,4 +1,4 @@
-<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/guide/human/app-extras/assistant.md`. Do not edit manually. -->
+<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/site/guide/app-extras/assistant.md`. Do not edit manually. -->
 
 # Assistant
 

package/guide/agent/app-extras/realtime.md

@@ -1,4 +1,4 @@
-<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/guide/human/app-extras/realtime.md`. Do not edit manually. -->
+<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/site/guide/app-extras/realtime.md`. Do not edit manually. -->
 
 # Realtime
 

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

@@ -1,4 +1,4 @@
-<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/guide/human/app-setup/a-more-interesting-shell.md`. Do not edit manually. -->
+<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/site/guide/app-setup/a-more-interesting-shell.md`. Do not edit manually. -->
 
 # A more interesting shell
 

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

@@ -1,4 +1,4 @@
-<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/guide/human/app-setup/authentication.md`. Do not edit manually. -->
+<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/site/guide/app-setup/authentication.md`. Do not edit manually. -->
 
 # Authentication
 
@@ -44,6 +44,14 @@ JSKIT uses the project URL as `AUTH_SUPABASE_URL`, the publishable key as `AUTH_
 
 Use the **publishable** key here, not the secret key and not a service-role key. If you later run the app on a different host or port, update both Supabase's URL settings and `APP_PUBLIC_URL` to match the real browser URL exactly.
 
+If you are guiding someone interactively, ask plainly for these exact values:
+
+- `AUTH_SUPABASE_URL`
+- `AUTH_SUPABASE_PUBLISHABLE_KEY`
+- whether `APP_PUBLIC_URL` should stay `http://localhost:5173`
+
+Do not hide behind vague language like "send the auth credentials later." In this local guide flow, those are routine setup values for the Supabase auth install step.
+
 ## Installing the auth layer
 
 From inside `exampleapp`, run:

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

@@ -1,4 +1,4 @@
-<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/guide/human/app-setup/console.md`. Do not edit manually. -->
+<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/site/guide/app-setup/console.md`. Do not edit manually. -->
 
 # Console
 

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

@@ -1,4 +1,4 @@
-<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/guide/human/app-setup/database-layer.md`. Do not edit manually. -->
+<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/site/guide/app-setup/database-layer.md`. Do not edit manually. -->
 
 # Database layer
 

package/guide/agent/app-setup/initial-scaffolding.md

@@ -1,4 +1,4 @@
-<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/guide/human/app-setup/initial-scaffolding.md`. Do not edit manually. -->
+<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/site/guide/app-setup/initial-scaffolding.md`. Do not edit manually. -->
 
 # Initial scaffolding
 

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

@@ -1,4 +1,4 @@
-<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/guide/human/app-setup/multi-homing.md`. Do not edit manually. -->
+<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/site/guide/app-setup/multi-homing.md`. Do not edit manually. -->
 
 # Multi-homing
 
@@ -33,6 +33,8 @@ This chapter teaches `personal`, not `workspaces`.
 
 That is deliberate. `personal` gives the guide a much better first-run experience because the first workspace is auto-provisioned for the user. The app still becomes multi-homing-capable, because invitations and memberships can still put one user in several workspaces at once. The `personal` part only changes how the first workspace is provisioned and how its slug policy works.
 
+Once `workspaces-core` and `workspaces-web` are installed, the baseline workspace invitation flow is already part of the package stack. Treat that as the default behavior unless the app explicitly needs custom invite rules or custom UI beyond what the packages already provide.
+
 ## Installing the workspace packages
 
 If your app is already on `tenancyMode = "personal"`, run:

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

@@ -1,4 +1,4 @@
-<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/guide/human/app-setup/users.md`. Do not edit manually. -->
+<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/site/guide/app-setup/users.md`. Do not edit manually. -->
 
 # Users
 

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

@@ -1,4 +1,4 @@
-<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/guide/human/app-setup/working-with-the-jskit-cli.md`. Do not edit manually. -->
+<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/site/guide/app-setup/working-with-the-jskit-cli.md`. Do not edit manually. -->
 
 # Working with the JSKIT CLI
 

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

@@ -1,4 +1,4 @@
-<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/guide/human/generators/advanced-cruds.md`. Do not edit manually. -->
+<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/site/guide/generators/advanced-cruds.md`. Do not edit manually. -->
 
 # Advanced CRUDs
 
@@ -451,6 +451,168 @@ They usually:
 
 These files are mostly containers. That is deliberate.
 
+### CRUD link resolution
+
+This deserves an explicit warning, because it was implemented incorrectly in a real app.
+
+When you customize generated CRUD pages, use the CRUD runtime that owns the current route scope to resolve CRUD-bound links.
+
+Use `paths.page()` for **surface-aware** navigation:
+
+- `/account`
+- `/assistant`
+- `/lists`
+- other links that only need normal surface params such as `workspaceSlug`
+
+Do **not** use `paths.page()` with CRUD record placeholders inside the relative path or URL template, such as:
+
+- `:contactId`
+- `:addressId`
+- `:todoListId`
+- `:todoItemId`
+
+For CRUD-bound links, use the runtime-provided resolvers instead:
+
+- list pages:
+  - `records.resolveViewUrl(record)`
+  - `records.resolveEditUrl(record)`
+  - `records.resolveParams(template, extraParams)`
+- view pages:
+  - `view.listUrl`
+  - `view.editUrl`
+  - `view.resolveParams(template, extraParams)`
+- add/edit pages:
+  - `formRuntime.addEdit.resolveParams(template, extraParams)`
+
+Why this matters:
+
+- `paths.page()` only knows about the current surface route params
+- CRUD runtimes also know about the current CRUD route shape, current record id, parent record ids, and nested child route context
+- once a page is CRUD-bound, those runtime resolvers are the safe way to build record-scoped links
+
+Scope rule:
+
+- use the runtime anchored to the record that owns the action
+- on a parent record view page with nested child routes, parent actions should still resolve from the parent `view` runtime even while a child route like `/items/new` is active
+- child-item actions should resolve from the child/item runtime only when the current route is actually child-scoped
+
+Examples:
+
+- good: `view.resolveParams("./items/new")`
+- good: `view.resolveParams("./items/:todoItemId/edit", { todoItemId: item.id })`
+- good: `formRuntime.addEdit.resolveParams("../../..")`
+- bad: `paths.page("/lists/:todoListId/items/new")`
+- bad: `paths.page("/lists/:todoListId/edit")`
+
+The safe mental model is:
+
+- use `paths.page()` to get to the right surface
+- use CRUD runtime resolvers to move around inside the CRUD
+
+### Live actions and `useCommand()`
+
+There is one more client-side pattern worth naming explicitly:
+
+Use `useCommand()` for live actions such as:
+
+- checkboxes that toggle a record field
+- archive / publish / reopen buttons
+- delete buttons
+- small one-click PATCH / POST / DELETE actions that are not full forms
+
+This is the pattern the `todo` app uses for "mark item done".
+
+The page renders a checkbox like this:
+
+```vue
+<v-checkbox-btn
+  :model-value="item.done"
+  :disabled="!canUpdateItem || isItemBusy(item.id)"
+  @update:model-value="toggleItem(item, $event)"
+/>
+```
+
+Then the page wires a command:
+
+```js
+const itemPatchModel = reactive({
+  id: "",
+  patch: {}
+});
+
+const updateItemCommand = useCommand({
+  model: itemPatchModel,
+  apiSuffix: ({ model }) => `/todo-items/${model?.id || ""}`,
+  writeMethod: "PATCH",
+  runPermissions: ["crud.todo_items.update"],
+  suppressSuccessMessage: true,
+  fallbackRunError: "Unable to update item.",
+  buildRawPayload(model) {
+    return model.patch;
+  },
+  async onRunSuccess(_payload, context = {}) {
+    if (context.queryClient) {
+      await context.queryClient.invalidateQueries({
+        queryKey: ["ui-generator", "todo_items"]
+      });
+    }
+  }
+});
+
+async function toggleItem(item = {}, nextValue = false) {
+  itemPatchModel.id = String(item.id || "");
+  itemPatchModel.patch = {
+    done: Boolean(nextValue)
+  };
+
+  await updateItemCommand.run();
+}
+```
+
+That gives you a clean action pipeline:
+
+1. the UI captures the click
+2. the page writes a tiny action model
+3. `useCommand()` resolves the correct scoped API path for the current route/surface
+4. it sends the request through the standard HTTP runtime
+5. on success, it invalidates the relevant query keys so the list/view refreshes
+
+So yes: for this class of interaction, `useCommand()` is the right helper.
+
+Use this rule of thumb:
+
+- `useCommand()`
+  - for live actions
+  - button clicks
+  - toggles
+  - small PATCH/POST/DELETE interactions
+- `useAddEdit()` / `useCrudAddEdit()`
+  - for real forms
+  - create/edit screens
+  - save/cancel flows
+- `useCrudList()` / `useCrudView()`
+  - for routed list/view loading and CRUD URL resolution
+
+Best practices for live CRUD actions:
+
+- keep the payload narrow
+  - send the field change you mean, not a whole copied record
+- disable the control while the command for that record is running
+  - `todo` does this with `isItemBusy(item.id)`
+- invalidate the relevant list/view query keys on success
+  - do not hand-maintain parallel local record copies unless you really need optimistic UI
+- suppress success toasts for high-frequency actions when they would become noisy
+  - a checkbox toggle usually does not need "Saved." every time
+- keep business rules on the server
+  - in `todo`, the client sends `{ done: true|false }`
+  - the server service decides how `completedAt` should be set or cleared
+
+The safe mental model is:
+
+- use form runtimes for forms
+- use command runtimes for actions
+- keep the server as the source of truth for derived state
+
 ### `_components/CrudAddEditForm.vue`
 
 This is the shared rendering shell for the add/edit form.

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

@@ -1,4 +1,4 @@
-<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/guide/human/generators/crud-generators.md`. Do not edit manually. -->
+<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/site/guide/generators/crud-generators.md`. Do not edit manually. -->
 
 # CRUD Generators
 
@@ -238,6 +238,7 @@ The exact fields will vary by app. What matters for the generator is:
 - the table already exists
 - the ownership columns match the ownership filter you are going to choose
 - the column names are stable enough to become part of your app's resource contract
+- if you are using `crud-server-generator`, do **not** hand-write a separate CRUD migration for this table; the server generator installs the CRUD migration scaffold itself
 
 In this table, `workspace_id` is the important ownership clue. That is why the next step uses:
 
@@ -261,6 +262,13 @@ npx jskit generate crud-server-generator scaffold \
 
 This creates an app-local package under `packages/contacts/`.
 
+Before generating anything, decide these with the developer:
+
+- which operations are allowed for this CRUD
+- which fields belong in the list view if a list exists
+- what the view form should look like
+- what the edit/new form should look like
+
 The most important file from the UI point of view is:
 
 ```text
@@ -505,6 +513,27 @@ The host page then renders the comment list directly, usually with lower-level C
 - `useCrudAddEdit()`
 - `useCrudView()` when needed
 
+There is one more runtime worth knowing about early:
+
+- `useCommand()`
+
+Use it for live actions that are **not** full forms, such as:
+
+- checkbox toggles
+- archive / reopen buttons
+- quick PATCH / POST / DELETE actions on one record
+
+So the practical split is:
+
+- `useCrudList()` / `useCrudView()`
+  - routed list/view loading
+- `useCrudAddEdit()`
+  - real create/edit forms
+- `useCommand()`
+  - live actions inside the page
+
+The `todo` app uses that last pattern for "mark item done" checkboxes. The deeper best-practices explanation is in [Advanced CRUDs](/guide/generators/advanced-cruds).
+
 That is the same general pattern already used in the real app for embedded child records like pet notes: the record list lives inside the main view page, while routed child pages handle the operations that still deserve their own URLs.
 
 This pattern is useful when the child records are supporting detail rather than a destination in their own right.

package/guide/agent/generators/intro.md

@@ -1,4 +1,4 @@
-<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/guide/human/generators/intro.md`. Do not edit manually. -->
+<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/site/guide/generators/intro.md`. Do not edit manually. -->
 
 # Generators
 

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

@@ -1,4 +1,4 @@
-<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/guide/human/generators/ui-generators.md`. Do not edit manually. -->
+<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/site/guide/generators/ui-generators.md`. Do not edit manually. -->
 
 # UI Generators
 

package/guide/agent/index.md

@@ -1,4 +1,4 @@
-<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/guide/human/index.md`. Do not edit manually. -->
+<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/site/guide/index.md`. Do not edit manually. -->
 
 # Guide
 

package/package.json

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

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

@@ -8,6 +8,24 @@ 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/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
+
+### site
+
+### `site/.vitepress/config.mjs`
+Exports
+- None
+
+### `site/.vitepress/theme/components/DocsInDepth.vue`
+Exports
+- None
+
+### `site/.vitepress/theme/components/DocsTerminalTip.vue`
+Exports
+- None
+
+### `site/.vitepress/theme/index.js`
+Exports
+- `default`

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/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.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/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.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/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.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/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.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/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.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/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.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/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.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/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.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/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.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/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.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/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.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/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.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/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.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/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.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/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.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/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.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/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.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/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections
 

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/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.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/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.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/`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`, `.vitepress/cache/`, `.vitepress/dist/`
 
 ## Sections