@terreno/mcp 0.29.0 → 0.31.0

package/src/docs/versioned/next/tasks/public-roadmap-github.md

@@ -13,19 +13,19 @@ See: [`docs/implementationPlans/public-roadmap-github.md`](../implementationPlan
 
 ## Phase 1: Discussions
 
-- [ ] **Task 1.1**: Document Discussion category setup
+- [x] **Task 1.1**: Document Discussion category setup
   - Description: Create `docs/explanation/roadmap-process.md`. Start with a "Maintainer setup" section listing the seven Discussion categories from the IP with their exact names, formats (Announcement / Question-Answer / Open-ended), descriptions, and display order. For each, include the description text to paste into the GitHub UI (one to two sentences, written for outside users). Note that Discussions must first be enabled in Settings → General → Features.
   - Files: `docs/explanation/roadmap-process.md` (new)
   - Depends on: none
   - Acceptance: all seven categories are listed with name, format, description, and order; the Announcements category is marked maintainers-only.
 
-- [ ] **Task 1.2**: Write the pinned intro posts
+- [x] **Task 1.2**: Write the pinned intro posts
   - Description: In `docs/explanation/roadmap-process.md`, add a "Pinned posts" section containing the full markdown body for one pinned post per category. Each should say what belongs there, what does not, and where to go instead. The Ideas post must explain that ideas are the intake funnel and that maintainers promote them to issues. The Agents & AI post must point at the MCP setup docs and the skills directory. The Q&A post must link `docs/how-to/` and note that recurring questions become how-to guides.
   - Files: `docs/explanation/roadmap-process.md`
   - Depends on: Task 1.1
   - Acceptance: seven post bodies exist, each under 200 words, each naming an alternative destination for off-topic content.
 
-- [ ] **Task 1.3**: Add Discussion templates
+- [x] **Task 1.3**: Add Discussion templates
   - Description: Create `.github/DISCUSSION_TEMPLATE/rfc.yml` with fields: title guidance, Summary (required), Motivation (required), Detailed design (required), Alternatives considered (required), Drawbacks, Unresolved questions, and a checkbox acknowledging that accepted RFCs become IPs in `docs/implementationPlans/`. Create `.github/DISCUSSION_TEMPLATE/ideas.yml` with: Problem you are hitting (required), What you tried, Rough idea for a solution, and Would you be willing to help implement. Both must set the correct `labels:` and target the right category via the filename convention.
   - Files: `.github/DISCUSSION_TEMPLATE/rfc.yml` (new), `.github/DISCUSSION_TEMPLATE/ideas.yml` (new)
   - Depends on: Task 1.1
@@ -33,13 +33,13 @@ See: [`docs/implementationPlans/public-roadmap-github.md`](../implementationPlan
 
 ## Phase 2: Project board
 
-- [ ] **Task 2.1**: Document Project board setup
+- [x] **Task 2.1**: Document Project board setup
   - Description: Add a "Project board" section to `docs/explanation/roadmap-process.md` specifying: the Project name (`Terreno Roadmap`), whether it is repo- or org-level, the six fields with their exact types and option values from the IP, and the four views with their layout, grouping, and filters. Include the `gh project` commands a maintainer can run for the parts the CLI supports, and mark the rest as UI-only.
   - Files: `docs/explanation/roadmap-process.md`
   - Depends on: Task 1.1
   - Acceptance: all six fields and four views are specified precisely enough to recreate without further decisions; option values match the IP tables exactly.
 
-- [ ] **Task 2.2**: Write the tracking-issue bodies for this program's IPs
+- [x] **Task 2.2**: Write the tracking-issue bodies for this program's IPs
   - Description: Create `docs/explanation/roadmap-seed-issues.md` containing one ready-to-paste issue body per IP listed in `docs/implementationPlans/oss-launch-program.md`. Each body must include: a one-paragraph summary written for an outside reader (not internal shorthand), a link to the IP file, a link to the task file, the RTK deprecation flag, the dependencies, and the labels and Project field values to set (`Area`, `Target`, `Impact`, `IP`). Read each IP file to write its summary — do not paraphrase from the program index alone.
   - Files: `docs/explanation/roadmap-seed-issues.md` (new)
   - Depends on: Task 2.1
@@ -47,19 +47,19 @@ See: [`docs/implementationPlans/public-roadmap-github.md`](../implementationPlan
 
 ## Phase 3: Labels and triage
 
-- [ ] **Task 3.1**: Define the label set as data
+- [x] **Task 3.1**: Define the label set as data
   - Description: Create `.github/labels.yml` listing every label from the IP taxonomy with `name`, `color`, and `description`. Use a consistent color family per prefix (for example one hue for `area:`, another for `type:`, another for `status:`, and distinct colors for the bare labels). Add a "Labels" section to `docs/explanation/roadmap-process.md` explaining that `.github/labels.yml` is the source of truth and how to apply it (`gh label create` loop or a label-sync action), plus which GitHub default labels to delete.
   - Files: `.github/labels.yml` (new), `docs/explanation/roadmap-process.md`
   - Depends on: Task 1.1
   - Acceptance: `.github/labels.yml` parses as valid YAML and contains every label in the IP taxonomy table with no duplicates; colors are valid six-digit hex without `#`.
 
-- [ ] **Task 3.2**: Add the triage workflow
+- [x] **Task 3.2**: Add the triage workflow
   - Description: Create `.github/workflows/triage.yml`. On `issues: [opened]`, add the `status:needs-triage` label. Then read the issue body for the package dropdown value rendered by the issue forms and map it to the matching `area:*` label (for example `@terreno/api` → `area:api`, `docs` → `area:docs`). Implement the mapping in an inline `actions/github-script` step with an explicit lookup object; if no match is found, add no area label and leave a comment asking the reporter to specify. Validate required inputs before use per the repo convention.
   - Files: `.github/workflows/triage.yml` (new)
   - Depends on: Task 3.1
   - Acceptance: workflow parses as valid YAML; the mapping object covers every option in `bug_report.yml`'s package dropdown; the no-match path does not throw.
 
-- [ ] **Task 3.3**: Document the backfill triage pass
+- [x] **Task 3.3**: Document the backfill triage pass
   - Description: Add a "One-time backfill" section to `docs/explanation/roadmap-process.md` describing how to triage existing open issues and PRs onto the new taxonomy: run `gh issue list --state open --limit 200 --json number,title,labels`, assign one `area:` and one `type:` label each, add anything still relevant to the board with `Status = Inbox`, and close or label `status:wontfix` anything stale beyond six months. Include the read-only `gh` commands for producing the working list.
   - Files: `docs/explanation/roadmap-process.md`
   - Depends on: Task 3.1
@@ -67,25 +67,25 @@ See: [`docs/implementationPlans/public-roadmap-github.md`](../implementationPlan
 
 ## Phase 4: Roadmap generation
 
-- [ ] **Task 4.1**: Write the roadmap generator
+- [x] **Task 4.1**: Write the roadmap generator
   - Description: Create `scripts/generate-roadmap.ts` (Bun, TypeScript, `const` arrow functions with explicit return types, no new dependencies). It queries the GitHub GraphQL API for the `Terreno Roadmap` ProjectV2 items and their field values, then writes `ROADMAP.md`: a header explaining that the board is the source of truth and that no dates are promised, then sections grouped by `Target` (current release first, then `Next`, then `Future`), and within each, subsections by `Area`. Each item renders as a bullet with its title, issue link, `Impact`, and an IP link when the `IP` field is set. Exclude items with `Status` of `Declined`. Read the token from `GITHUB_TOKEN` and the project number from `TERRENO_PROJECT_NUMBER`; fail with a clear message listing missing variables when either is absent. Use Luxon for the generated-at timestamp.
   - Files: `scripts/generate-roadmap.ts` (new), `package.json` (add a `roadmap:generate` script)
   - Depends on: Task 2.1
   - Acceptance: running with both env vars unset prints an error naming both and exits non-zero; with a valid token it writes a `ROADMAP.md` matching the described structure; `bun run lint` passes.
 
-- [ ] **Task 4.2**: Add the roadmap workflow
+- [x] **Task 4.2**: Add the roadmap workflow
   - Description: Create `.github/workflows/roadmap-generate.yml` running on `schedule` (daily) and `workflow_dispatch`. Validate `GITHUB_TOKEN`/PAT and `TERRENO_PROJECT_NUMBER` at job start with the repo's fail-fast pattern. Run `bun run roadmap:generate`, then commit and push `ROADMAP.md` only if `git diff --quiet` reports changes. Use a bot identity for the commit.
   - Files: `.github/workflows/roadmap-generate.yml` (new)
   - Depends on: Task 4.1
   - Acceptance: workflow parses as valid YAML; the secret-validation step lists every required variable; the commit step is conditional on a real diff.
 
-- [ ] **Task 4.3**: Seed `ROADMAP.md` and link it
+- [x] **Task 4.3**: Seed `ROADMAP.md` and link it
   - Description: Commit an initial hand-written `ROADMAP.md` (the generator will overwrite it later) built from the IPs in `docs/implementationPlans/oss-launch-program.md` plus the active plans in `PLAN_INDEX.md`. Add a note at the top that it is generated from the Project board. Link it from `README.md` and add it to the docs site sidebar in `website/docusaurus.config.ts` (or the sidebars file if navigation is defined there — check both).
   - Files: `ROADMAP.md` (new), `README.md`, `website/docusaurus.config.ts` or `website/sidebars.ts`
   - Depends on: Task 4.1
   - Acceptance: `ROADMAP.md` lists every IP in the program with a `Target`; the docs site builds (`bun run website:build`) with the new nav entry; the README links it.
 
-- [ ] **Task 4.4**: Add the docs feedback footer link
+- [x] **Task 4.4**: Add the docs feedback footer link
   - Description: In `website/docusaurus.config.ts`, add a footer link (or theme config item) pointing at the Docs feedback Discussions category. If Docusaurus's `editUrl` mechanism is the better fit for per-page feedback, add the discussion link alongside the existing `editUrl` rather than replacing it.
   - Files: `website/docusaurus.config.ts`
   - Depends on: Task 1.1
@@ -93,19 +93,19 @@ See: [`docs/implementationPlans/public-roadmap-github.md`](../implementationPlan
 
 ## Phase 5: Linear bridge
 
-- [ ] **Task 5.1**: Document the Linear bridge rules
+- [x] **Task 5.1**: Document the Linear bridge rules
   - Description: Add a "Linear bridge" section to `docs/explanation/roadmap-process.md` covering: which artifacts live where (GitHub = public discussion, issues, roadmap state; Linear = sprint execution; `docs/implementationPlans/` = design), the one-way GitHub → Linear intake triggered by the `tracked` label, the rule that Linear status is not synced back and that GitHub state changes via `Fixes #NNN` on merge, how internally-originated public work gets a manual GitHub issue, and an explicit statement that internal-only Linear work is never mirrored. Explain *why* status is not two-way synced.
   - Files: `docs/explanation/roadmap-process.md`
   - Depends on: Task 3.1
   - Acceptance: the section states the direction of every sync, names the trigger label, and gives the reason two-way status sync was rejected.
 
-- [ ] **Task 5.2**: Document the intake flow in `CONTRIBUTING.md`
+- [x] **Task 5.2**: Document the intake flow in `CONTRIBUTING.md`
   - Description: Add a "How work gets planned" section to `CONTRIBUTING.md`, under 30 lines: file an Ideas discussion → maintainer promotes to an issue → issue is triaged onto the roadmap board → substantial work gets an IP → implementation. Add the RFC path for public API changes and new packages. Link `ROADMAP.md`, the Discussions categories, and `docs/implementationPlans/README.md`.
   - Files: `CONTRIBUTING.md`
   - Depends on: Task 5.1
   - Acceptance: the section is under 30 lines, links all three destinations, and matches the flow diagram in the IP.
 
-- [ ] **Task 5.3**: Add the release announcement step
+- [x] **Task 5.3**: Add the release announcement step
   - Description: Edit `.rulesync/skills/release/SKILL.md` to add a step: after publishing a release that includes breaking changes or deprecations, post a discussion in the Announcements category summarizing the change, linking the changelog section and the relevant upgrade note in `mcp-server/src/docs/upgrades/`. Regenerate mirrors with `bun run rules`.
   - Files: `.rulesync/skills/release/SKILL.md` plus generated mirrors
   - Depends on: Task 1.1

package/src/docs/versioned/next/tasks/rtk-to-syncdb-migration-docs.md

@@ -2,7 +2,9 @@
 
 See: [`docs/implementationPlans/rtk-to-syncdb-migration-docs.md`](../implementationPlans/rtk-to-syncdb-migration-docs.md)
 
-**RTK deprecation flag:** **Blocked.** Do not start any task in this file until PR [#869](https://github.com/flourishhealth/terreno/pull/869) is merged into `master`. Verify with `git log --oneline master | rg -i syncdb` before beginning.
+**RTK deprecation flag:** **Blocked.** Do not start any task in this file until a `@terreno/syncdb` package is merged into `master`. PR [#869](https://github.com/flourishhealth/terreno/pull/869) was the delivery vehicle but is **closed, not merged** (checked 2026-08-09) and no `syncdb/` package exists on `master`. Verify with `git log --oneline master | rg -i syncdb` before beginning.
+
+**Migration strategy (decision M6, reaffirmed 2026-08-09):** this IP ships *context for an AI agent to perform the migration*, not a migration script or codemod. The deliverables are the syncdb reference, a guide built from verified before/after pairs, and the `upgrading-terreno` skill that drives an agent through a per-screen `USE_SYNCDB` rollout. See the "Migration strategy: AI-context-first" section in the IP. Do not author a codemod as the primary path.
 
 ## Instructions for the implementing agent
 

package/dist/docs/versioned/0.25.0/explanation/README.md

@@ -1,13 +0,0 @@
-# Explanation
-
-Understanding-oriented documentation: concepts, architecture, and context.
-
-## Contents
-
-- [AI-powered workflows](ai-workflows.md) — Autonomous documentation, testing, and maintenance workflows
-- [Authentication architecture](authentication.md) — How JWT, OAuth, and token refresh work
-- [Configuration system](configuration-system.md) — Runtime configuration with database persistence
-- [Dependency management](dependency-management.md) — Dependabot, auto-merge, and security practices
-- [GCP hosting architecture](gcp-hosting-architecture.md) — Static site hosting with GCS and Cloud CDN
-- [Modular API design](modular-api-design.md) — 🚧 Why TerrenoApp replaces setupServer
-- [modelRouter actions](model-router-actions.md) — Named collection and instance operations on modelRouter

package/dist/docs/versioned/0.25.0/implementationPlans/PLAN_INDEX.md

@@ -1,21 +0,0 @@
-# Implementation plan index
-
-Tracks active and completed implementation plans (IP) for Terreno. File paths are relative to `docs/implementationPlans/`.
-
-## Active
-
-| Plan | Status | Created | Tasks |
-|------|--------|---------|-------|
-| [Admin UI v2 — Django-parity admin](admin-ui-v2-django-parity.md) | Approved | 2026-06-15 | [tasks](../tasks/admin-ui-v2-django-parity.md) |
-
-## Completed
-
-*(Move rows here from Active when the IP status becomes Complete.)*
-
-## Deferred / Closed
-
-*(Plans parked or superseded.)*
-
-## Backlog
-
-*(Links to ideas not yet promoted to a full IP.)*

package/dist/docs/versioned/0.25.0/reference/components/README.mdx

@@ -1,65 +0,0 @@
----
-title: UI components
-description: Generated reference pages for @terreno/ui components with live demo embeds.
-slug: /reference/components
----
-
-# UI components
-
-These pages are generated from `demo/ui-types-documentation.json` and `demo/story-config/*.config.tsx` at site build time. Each page embeds the live component demo.
-
-- [Accordion](./accordion)
-- [AddressField](./addressfield)
-- [AI Suggestion Box](./ai-suggestion-box)
-- [Avatar](./avatar)
-- [Badge](./badge)
-- [Banner](./banner)
-- [Boolean field](./boolean-field)
-- [Box](./box)
-- [Button](./button)
-- [Card](./card)
-- [CheckBox](./checkbox)
-- [ConsentFormScreen](./consentformscreen)
-- [Custom Select Field](./custom-select-field)
-- [DataTable](./datatable)
-- [Date & Time field](./date-time-field)
-- [Email field](./email-field)
-- [Emoji selector](./emoji-selector)
-- [Field](./field)
-- [Height field](./height-field)
-- [Icon](./icon)
-- [IconButton](./iconbutton)
-- [Inner modal content](./inner-modal-content)
-- [Markdown editor field](./markdown-editor-field)
-- [MarkdownView](./markdownview)
-- [Multiselect Field](./multiselect-field)
-- [Number field](./number-field)
-- [Page](./page)
-- [Pagination](./pagination)
-- [Password field](./password-field)
-- [Phone number field](./phone-number-field)
-- [Radio field](./radio-field)
-- [SectionDivider](./sectiondivider)
-- [Segmented control](./segmented-control)
-- [Select field](./select-field)
-- [SelectBadge](./selectbadge)
-- [Side drawer](./side-drawer)
-- [Sidebar navigation (non-expo)](./sidebar-navigation-non-expo)
-- [Signature field](./signature-field)
-- [Slider](./slider)
-- [Spinner](./spinner)
-- [Table](./table)
-- [Table badge](./table-badge)
-- [Table boolean](./table-boolean)
-- [Table date](./table-date)
-- [Table icon button](./table-icon-button)
-- [Table number](./table-number)
-- [Table Text](./table-text)
-- [Table title](./table-title)
-- [Tap to edit](./tap-to-edit)
-- [Text area](./text-area)
-- [Text field](./text-field)
-- [Theme](./theme)
-- [Toast](./toast)
-- [Tooltip](./tooltip)
-- [UserInactivity](./userinactivity)

package/dist/docs/versioned/0.25.0/reference/components/custom-select-field.mdx

@@ -1,37 +0,0 @@
----
-title: "Custom Select Field"
-description: "Displays a list of options using the browser’s native select and includes a custom option that renders a text field when selected and allows user to input value not included in predefined options."
-sidebar_label: "Custom Select Field"
-slug: /reference/components/custom-select-field
----
-
-import ComponentDemo from '@site/src/components/ComponentDemo';
-
-# Custom Select Field
-
-Displays a list of options using the browser’s native select and includes a custom option that renders a text field when selected and allows user to input value not included in predefined options.
-
-**Package:** `@terreno/ui`  
-**Categories:** Component  
-**Props interface:** `CustomSelectFieldProps`  
-**Story source:** [`demo/stories/CustomSelectField.stories.tsx`](https://github.com/flourishhealth/terreno/blob/master/demo/stories/CustomSelectField.stories.tsx)
-
-## Live demo
-
-<ComponentDemo name="Custom Select Field" />
-
-## Props
-
-| Prop | Type | Required | Description |
-| --- | --- | --- | --- |
-| `onChange` | `reflection` | Yes | The function to call when the custom select field value changes. |
-| `options` | `array` | Yes | The options available for selection in the select field. Each option should have a label and a value. |
-| `value` | `union` | Yes | The current value of the custom select field. |
-| `disabled` | `boolean` |  | If true, the select field will be disabled. |
-| `errorText` | `string` |  | The error text to display if there is an error. |
-| `helperText` | `string` |  | The helper text to display below the select field. |
-| `placeholder` | `string` |  | The placeholder text to display when no option is selected. |
-| `searchable` | `boolean` |  | When true, options can be filtered as the user types. See  |
-| `testID` | `string` |  | Root test id for the primary interactive element or container. |
-| `testIDs` | `FieldTestIDs` |  |  |
-| `title` | `string` |  | The title of the custom select field. |

package/dist/docs/versioned/0.25.0/reference/components/iconbutton.mdx

@@ -1,43 +0,0 @@
----
-title: "IconButton"
-description: "Icon buttons allow users to take actions and make choices with a single tap."
-sidebar_label: "IconButton"
-slug: /reference/components/iconbutton
----
-
-import ComponentDemo from '@site/src/components/ComponentDemo';
-
-# IconButton
-
-Icon buttons allow users to take actions and make choices with a single tap.
-
-**Package:** `@terreno/ui`  
-**Categories:** Component  
-**Props interface:** `IconButtonProps`  
-**Story source:** [`demo/stories/IconButton.stories.tsx`](https://github.com/flourishhealth/terreno/blob/master/demo/stories/IconButton.stories.tsx)
-
-## Live demo
-
-<ComponentDemo name="IconButton" />
-
-## Props
-
-| Prop | Type | Required | Description |
-| --- | --- | --- | --- |
-| `accessibilityLabel` | `string` | Yes | The accessibility label attribute identifies the user interface element. It should be a very brief description of the element, such as "Add", "Play", "Deleted", etc. |
-| `iconName` | `IconName` | Yes | The name of the icon to display in the button. |
-| `onClick` | `reflection` | Yes | The function to call when the button is clicked. |
-| `accessibilityHint` | `string` |  | The accessibility hint describes the results of performing an action on a control or view. It should be a very brief description of the result of interacting with the button. |
-| `confirmationHeading` | `string` |  | The heading of the confirmation modal. |
-| `confirmationText` | `string` |  | The text content of the confirmation modal. |
-| `disabled` | `boolean` |  | If true, the button will be disabled. |
-| `indicator` | `union` |  | Show a small indicator icon in the lower right corner of the button. |
-| `indicatorText` | `union` |  | The text or number to display in the indicator. If not provided, the indicator will be a solid circle. |
-| `loading` | `boolean` |  | If true, a loading spinner will be shown in the button. |
-| `size` | `union` |  | The size of the button. |
-| `testID` | `string` |  | Root test id for the primary interactive element or container. |
-| `tooltipIdealPosition` | `TooltipPosition` |  | The ideal position of the tooltip. |
-| `tooltipIncludeArrow` | `boolean` |  | Include an arrow in the tooltip. Pointing to the button. |
-| `tooltipText` | `string` |  | The text content of the tooltip. |
-| `variant` | `union` |  | The variant of the button, which determines its style. |
-| `withConfirmation` | `boolean` |  | If true, a confirmation modal will be shown before the onClick action. |

package/dist/docs/versioned/0.25.0/reference/generated/api/README.md

@@ -1,294 +0,0 @@
-## Classes
-
-- [APIError](classes/APIError.md)
-- [BetterAuthApp](classes/BetterAuthApp.md)
-- [CachingSecretProvider](classes/CachingSecretProvider.md)
-- [CompositeSecretProvider](classes/CompositeSecretProvider.md)
-- [ConfigurationApp](classes/ConfigurationApp.md)
-- [ConsentApp](classes/ConsentApp.md)
-- [DateOnly](classes/DateOnly.md)
-- [EnvSecretProvider](classes/EnvSecretProvider.md)
-- [GcpSecretProvider](classes/GcpSecretProvider.md)
-- [OpenApiMiddlewareBuilder](classes/OpenApiMiddlewareBuilder.md)
-- [RealtimeApp](classes/RealtimeApp.md)
-- [TaskCancelledError](classes/TaskCancelledError.md)
-- [TerrenoApp](classes/TerrenoApp.md)
-- [VersionCheckPlugin](classes/VersionCheckPlugin.md)
-
-## Interfaces
-
-- [ActionContext](interfaces/ActionContext.md)
-- [APIErrorConstructor](interfaces/APIErrorConstructor.md)
-- [AsyncHandlerOptions](interfaces/AsyncHandlerOptions.md)
-- [AuthenticatedClient](interfaces/AuthenticatedClient.md)
-- [AuthOptions](interfaces/AuthOptions.md)
-- [BackgroundTaskDocument](interfaces/BackgroundTaskDocument.md)
-- [BackgroundTaskMethods](interfaces/BackgroundTaskMethods.md)
-- [BackgroundTaskModel](interfaces/BackgroundTaskModel.md)
-- [BackgroundTaskStatics](interfaces/BackgroundTaskStatics.md)
-- [BaseUser](interfaces/BaseUser.md)
-- [BetterAuthAppOptions](interfaces/BetterAuthAppOptions.md)
-- [BetterAuthConfig](interfaces/BetterAuthConfig.md)
-- [BetterAuthOAuthProvider](interfaces/BetterAuthOAuthProvider.md)
-- [BetterAuthSession](interfaces/BetterAuthSession.md)
-- [BetterAuthSessionData](interfaces/BetterAuthSessionData.md)
-- [BetterAuthUser](interfaces/BetterAuthUser.md)
-- [CachingSecretProviderOptions](interfaces/CachingSecretProviderOptions.md)
-- [ChangeStreamConfig](interfaces/ChangeStreamConfig.md)
-- [CollectionActionConfig](interfaces/CollectionActionConfig.md)
-- [ConfigRegistration](interfaces/ConfigRegistration.md)
-- [ConfigurationAppOptions](interfaces/ConfigurationAppOptions.md)
-- [ConfigurationMetaResponse](interfaces/ConfigurationMetaResponse.md)
-- [ConfigurationModel](interfaces/ConfigurationModel.md)
-- [ConfigurationPermissions](interfaces/ConfigurationPermissions.md)
-- [ConfigurationPluginOptions](interfaces/ConfigurationPluginOptions.md)
-- [ConfigurationStatics](interfaces/ConfigurationStatics.md)
-- [ConsentAppOptions](interfaces/ConsentAppOptions.md)
-- [ConsentFormCheckbox](interfaces/ConsentFormCheckbox.md)
-- [ConsentFormDefinition](interfaces/ConsentFormDefinition.md)
-- [ConsentFormDocument](interfaces/ConsentFormDocument.md)
-- [ConsentFormModel](interfaces/ConsentFormModel.md)
-- [ConsentFormStatics](interfaces/ConsentFormStatics.md)
-- [ConsentResponseDocument](interfaces/ConsentResponseDocument.md)
-- [ConsentResponseMethods](interfaces/ConsentResponseMethods.md)
-- [ConsentResponseModel](interfaces/ConsentResponseModel.md)
-- [ConsentResponseStatics](interfaces/ConsentResponseStatics.md)
-- [CreateAuthenticatedClientOptions](interfaces/CreateAuthenticatedClientOptions.md)
-- [CreateBetterAuthOptions](interfaces/CreateBetterAuthOptions.md)
-- [CreatedDeleted](interfaces/CreatedDeleted.md)
-- [CreateFeatureFlaggedLoggerOptions](interfaces/CreateFeatureFlaggedLoggerOptions.md)
-- [CreateScopedLoggerOptions](interfaces/CreateScopedLoggerOptions.md)
-- [CreateValidatorOptions](interfaces/CreateValidatorOptions.md)
-- [DocumentSubscription](interfaces/DocumentSubscription.md)
-- [FindExactlyOnePlugin](interfaces/FindExactlyOnePlugin.md)
-- [FindOneOrNonePlugin](interfaces/FindOneOrNonePlugin.md)
-- [GcpSecretProviderOptions](interfaces/GcpSecretProviderOptions.md)
-- [GenerateTokensOptions](interfaces/GenerateTokensOptions.md)
-- [GitHubAuthOptions](interfaces/GitHubAuthOptions.md)
-- [GitHubUserFields](interfaces/GitHubUserFields.md)
-- [HasUpsert](interfaces/HasUpsert.md)
-- [HttpClientLogger](interfaces/HttpClientLogger.md)
-- [InstanceActionConfig](interfaces/InstanceActionConfig.md)
-- [IsDeleted](interfaces/IsDeleted.md)
-- [JSONArray](interfaces/JSONArray.md)
-- [JSONObject](interfaces/JSONObject.md)
-- [JwtSessionPayload](interfaces/JwtSessionPayload.md)
-- [LogContextFields](interfaces/LogContextFields.md)
-- [LoggingOptions](interfaces/LoggingOptions.md)
-- [ModelRouterOptions](interfaces/ModelRouterOptions.md)
-- [ModelRouterRegistration](interfaces/ModelRouterRegistration.md)
-- [ModelRouterValidationOptions](interfaces/ModelRouterValidationOptions.md)
-- [MongoClientLike](interfaces/MongoClientLike.md)
-- [NormalizedApiError](interfaces/NormalizedApiError.md)
-- [OpenApiBuildResult](interfaces/OpenApiBuildResult.md)
-- [OpenApiMiddleware](interfaces/OpenApiMiddleware.md)
-- [OpenApiParameter](interfaces/OpenApiParameter.md)
-- [OpenApiResponse](interfaces/OpenApiResponse.md)
-- [OpenApiSchema](interfaces/OpenApiSchema.md)
-- [OpenApiSchemaProperty](interfaces/OpenApiSchemaProperty.md)
-- [OpenApiValidatorConfig](interfaces/OpenApiValidatorConfig.md)
-- [PopulatePath](interfaces/PopulatePath.md)
-- [QuerySubscription](interfaces/QuerySubscription.md)
-- [QueryValidatorOptions](interfaces/QueryValidatorOptions.md)
-- [RealtimeAppOptions](interfaces/RealtimeAppOptions.md)
-- [RealtimeConfig](interfaces/RealtimeConfig.md)
-- [RealtimeEvent](interfaces/RealtimeEvent.md)
-- [RealtimeRegistryEntry](interfaces/RealtimeRegistryEntry.md)
-- [RealtimeSocketLike](interfaces/RealtimeSocketLike.md)
-- [RequestBodyValidatorOptions](interfaces/RequestBodyValidatorOptions.md)
-- [RequestContext](interfaces/RequestContext.md)
-- [RESTPermissions](interfaces/RESTPermissions.md)
-- [RetryPolicy](interfaces/RetryPolicy.md)
-- [ScopedLogger](interfaces/ScopedLogger.md)
-- [ScriptArgDef](interfaces/ScriptArgDef.md)
-- [ScriptArgs](interfaces/ScriptArgs.md)
-- [ScriptContext](interfaces/ScriptContext.md)
-- [ScriptResult](interfaces/ScriptResult.md)
-- [SecretFieldMeta](interfaces/SecretFieldMeta.md)
-- [SecretProvider](interfaces/SecretProvider.md)
-- [SyncConsentsOptions](interfaces/SyncConsentsOptions.md)
-- [SyncConsentsResult](interfaces/SyncConsentsResult.md)
-- [TerrenoAppOptions](interfaces/TerrenoAppOptions.md)
-- [TerrenoPlugin](interfaces/TerrenoPlugin.md)
-- [TerrenoRequestLogEntry](interfaces/TerrenoRequestLogEntry.md)
-- [TerrenoTransformer](interfaces/TerrenoTransformer.md)
-- [User](interfaces/User.md)
-- [UserModel](interfaces/UserModel.md)
-- [VersionCheckResponse](interfaces/VersionCheckResponse.md)
-- [VersionConfigDocument](interfaces/VersionConfigDocument.md)
-- [VersionConfigModel](interfaces/VersionConfigModel.md)
-- [WithApiErrorHandlingOptions](interfaces/WithApiErrorHandlingOptions.md)
-- [WrapScriptOptions](interfaces/WrapScriptOptions.md)
-
-## Type Aliases
-
-- [AddRoutes](type-aliases/AddRoutes.md)
-- [ApiErrorClassification](type-aliases/ApiErrorClassification.md)
-- [AuthProvider](type-aliases/AuthProvider.md)
-- [AuthStrategy](type-aliases/AuthStrategy.md)
-- [BetterAuthInstance](type-aliases/BetterAuthInstance.md)
-- [ConfigType](type-aliases/ConfigType.md)
-- [ConfigurationPostUpdateHook](type-aliases/ConfigurationPostUpdateHook.md)
-- [ConfigurationPreUpdateHook](type-aliases/ConfigurationPreUpdateHook.md)
-- [ConsentFormMethods](type-aliases/ConsentFormMethods.md)
-- [ConsentFormType](type-aliases/ConsentFormType.md)
-- [DeepPartial](type-aliases/DeepPartial.md)
-- [GooseRESTOptions](type-aliases/GooseRESTOptions.md)
-- [JSONPrimitive](type-aliases/JSONPrimitive.md)
-- [JSONValue](type-aliases/JSONValue.md)
-- [Paths](type-aliases/Paths.md)
-- [PathValue](type-aliases/PathValue.md)
-- [PermissionMethod](type-aliases/PermissionMethod.md)
-- [RequestContextAttributes](type-aliases/RequestContextAttributes.md)
-- [RESTMethod](type-aliases/RESTMethod.md)
-- [ScriptArgValue](type-aliases/ScriptArgValue.md)
-- [ScriptRunner](type-aliases/ScriptRunner.md)
-- [VersionCheckStatus](type-aliases/VersionCheckStatus.md)
-
-## Variables
-
-- [ACTION\_NAME\_PATTERN](variables/ACTION_NAME_PATTERN.md)
-- [BackgroundTask](variables/BackgroundTask.md)
-- [Config](variables/Config.md)
-- [ConsentForm](variables/ConsentForm.md)
-- [ConsentResponse](variables/ConsentResponse.md)
-- [consentResponsePopulatePaths](variables/consentResponsePopulatePaths.md)
-- [gooseRestRouter](variables/gooseRestRouter.md)
-- [logger](variables/logger.md)
-- [MAX\_DOCUMENT\_SUBSCRIPTIONS](variables/MAX_DOCUMENT_SUBSCRIPTIONS.md)
-- [MAX\_MODEL\_SUBSCRIPTIONS](variables/MAX_MODEL_SUBSCRIPTIONS.md)
-- [MAX\_QUERY\_SUBSCRIPTIONS](variables/MAX_QUERY_SUBSCRIPTIONS.md)
-- [Permissions](variables/Permissions.md)
-- [REQUEST\_CONTEXT\_ATTRIBUTE\_NAMES](variables/REQUEST_CONTEXT_ATTRIBUTE_NAMES.md)
-- [VersionConfig](variables/VersionConfig.md)
-- [winstonLogger](variables/winstonLogger.md)
-
-## Functions
-
-- [addAuthRoutes](functions/addAuthRoutes.md)
-- [addGitHubAuthRoutes](functions/addGitHubAuthRoutes.md)
-- [addMeRoutes](functions/addMeRoutes.md)
-- [addPopulateToQuery](functions/addPopulateToQuery.md)
-- [addQuerySubscription](functions/addQuerySubscription.md)
-- [AdminOwnerTransformer](functions/AdminOwnerTransformer.md)
-- [apiErrorMiddleware](functions/apiErrorMiddleware.md)
-- [apiFallthroughErrorMiddleware](functions/apiFallthroughErrorMiddleware.md)
-- [apiUnauthorizedMiddleware](functions/apiUnauthorizedMiddleware.md)
-- [applyRequestContextToSentry](functions/applyRequestContextToSentry.md)
-- [assertNoActionCollisions](functions/assertNoActionCollisions.md)
-- [asyncHandler](functions/asyncHandler.md)
-- [authenticateMiddleware](functions/authenticateMiddleware.md)
-- [baseUserPlugin](functions/baseUserPlugin.md)
-- [buildQuerySchemaFromFields](functions/buildQuerySchemaFromFields.md)
-- [checkModelsStrict](functions/checkModelsStrict.md)
-- [checkPermissions](functions/checkPermissions.md)
-- [clearQueryStore](functions/clearQueryStore.md)
-- [clearRealtimeRegistry](functions/clearRealtimeRegistry.md)
-- [computeQueryId](functions/computeQueryId.md)
-- [configurationPlugin](functions/configurationPlugin.md)
-- [configureOpenApiValidator](functions/configureOpenApiValidator.md)
-- [createActionOpenApiMiddleware](functions/createActionOpenApiMiddleware.md)
-- [createAuthenticatedClient](functions/createAuthenticatedClient.md)
-- [createBetterAuth](functions/createBetterAuth.md)
-- [createBetterAuthSessionMiddleware](functions/createBetterAuthSessionMiddleware.md)
-- [createdUpdatedPlugin](functions/createdUpdatedPlugin.md)
-- [createFeatureFlaggedLogger](functions/createFeatureFlaggedLogger.md)
-- [createModelValidators](functions/createModelValidators.md)
-- [createOpenApiBuilder](functions/createOpenApiBuilder.md)
-- [createRouter](functions/createRouter.md)
-- [createRouterWithAuth](functions/createRouterWithAuth.md)
-- [createScopedLogger](functions/createScopedLogger.md)
-- [createScriptArgs](functions/createScriptArgs.md)
-- [createValidator](functions/createValidator.md)
-- [cronjob](functions/cronjob.md)
-- [defaultResponseHandler](functions/defaultResponseHandler.md)
-- [defineCollectionAction](functions/defineCollectionAction.md)
-- [defineInstanceAction](functions/defineInstanceAction.md)
-- [envConfigurationPlugin](functions/envConfigurationPlugin.md)
-- [errorMessage](functions/errorMessage.md)
-- [errorsPlugin](functions/errorsPlugin.md)
-- [errorStack](functions/errorStack.md)
-- [findExactlyOne](functions/findExactlyOne.md)
-- [findOneOrNone](functions/findOneOrNone.md)
-- [findOneOrNoneFor](functions/findOneOrNoneFor.md)
-- [findRegistryEntryByCollection](functions/findRegistryEntryByCollection.md)
-- [findRegistryEntryByRoutePath](functions/findRegistryEntryByRoutePath.md)
-- [firebaseJWTPlugin](functions/firebaseJWTPlugin.md)
-- [fixMixedFields](functions/fixMixedFields.md)
-- [flattenToDotPaths](functions/flattenToDotPaths.md)
-- [formatLogContextSuffix](functions/formatLogContextSuffix.md)
-- [generateTokens](functions/generateTokens.md)
-- [getAPIErrorBody](functions/getAPIErrorBody.md)
-- [getBetterAuthSession](functions/getBetterAuthSession.md)
-- [getCurrentLogContext](functions/getCurrentLogContext.md)
-- [getCurrentRequestContext](functions/getCurrentRequestContext.md)
-- [getCurrentRequestContextAttributes](functions/getCurrentRequestContextAttributes.md)
-- [getDisableExternalErrorTracking](functions/getDisableExternalErrorTracking.md)
-- [getMongoClientFromMongoose](functions/getMongoClientFromMongoose.md)
-- [getOpenApiSpecForModel](functions/getOpenApiSpecForModel.md)
-- [getOpenApiValidatorConfig](functions/getOpenApiValidatorConfig.md)
-- [getQuerySubscriptionsForCollection](functions/getQuerySubscriptionsForCollection.md)
-- [getRealtimeRegistry](functions/getRealtimeRegistry.md)
-- [getRequestContextFromAttributes](functions/getRequestContextFromAttributes.md)
-- [getSchemaFromModel](functions/getSchemaFromModel.md)
-- [getSessionIdFromJwtPayload](functions/getSessionIdFromJwtPayload.md)
-- [githubUserPlugin](functions/githubUserPlugin.md)
-- [hasBetterAuthSession](functions/hasBetterAuthSession.md)
-- [installRealtimeSocketHandlers](functions/installRealtimeSocketHandlers.md)
-- [isAPIError](functions/isAPIError.md)
-- [isDeletedPlugin](functions/isDeletedPlugin.md)
-- [isDisabledPlugin](functions/isDisabledPlugin.md)
-- [isOpenApiValidatorConfigured](functions/isOpenApiValidatorConfigured.md)
-- [isValidObjectId](functions/isValidObjectId.md)
-- [jsonResponseRequestIdMiddleware](functions/jsonResponseRequestIdMiddleware.md)
-- [logRequests](functions/logRequests.md)
-- [markRetryUnsafe](functions/markRetryUnsafe.md)
-- [matchesQuery](functions/matchesQuery.md)
-- [modelRouter](functions/modelRouter.md)
-- [mongooseErrorToAPIError](functions/mongooseErrorToAPIError.md)
-- [mountBetterAuthRoutes](functions/mountBetterAuthRoutes.md)
-- [normalizeApiError](functions/normalizeApiError.md)
-- [openApiCompatMiddleware](functions/openApiCompatMiddleware.md)
-- [openApiEtagMiddleware](functions/openApiEtagMiddleware.md)
-- [OwnerQueryFilter](functions/OwnerQueryFilter.md)
-- [parseScriptArgs](functions/parseScriptArgs.md)
-- [patchAppUse](functions/patchAppUse.md)
-- [permissionMiddleware](functions/permissionMiddleware.md)
-- [registerActionRoutes](functions/registerActionRoutes.md)
-- [registerRealtime](functions/registerRealtime.md)
-- [removeAllSocketQueries](functions/removeAllSocketQueries.md)
-- [removeQuerySubscription](functions/removeQuerySubscription.md)
-- [requestContextMiddleware](functions/requestContextMiddleware.md)
-- [resetOpenApiValidatorConfig](functions/resetOpenApiValidatorConfig.md)
-- [runActionPermissions](functions/runActionPermissions.md)
-- [runWithRequestContext](functions/runWithRequestContext.md)
-- [runWithRequestContextAttributes](functions/runWithRequestContextAttributes.md)
-- [sendToGoogleChat](functions/sendToGoogleChat.md)
-- [sendToSlack](functions/sendToSlack.md)
-- [sendToZoom](functions/sendToZoom.md)
-- [sentryAppVersionMiddleware](functions/sentryAppVersionMiddleware.md)
-- [serialize](functions/serialize.md)
-- [setRequestContext](functions/setRequestContext.md)
-- [setupAuth](functions/setupAuth.md)
-- [setupBetterAuthUserSync](functions/setupBetterAuthUserSync.md)
-- [setupEnvironment](functions/setupEnvironment.md)
-- [setupGitHubAuth](functions/setupGitHubAuth.md)
-- [setupLogging](functions/setupLogging.md)
-- [signupUser](functions/signupUser.md)
-- [startChangeStreamWatcher](functions/startChangeStreamWatcher.md)
-- [stopChangeStreamWatcher](functions/stopChangeStreamWatcher.md)
-- [syncBetterAuthUser](functions/syncBetterAuthUser.md)
-- [syncConsents](functions/syncConsents.md)
-- [timeout](functions/timeout.md)
-- [transform](functions/transform.md)
-- [unpopulate](functions/unpopulate.md)
-- [updateRequestContextFromRequest](functions/updateRequestContextFromRequest.md)
-- [upsertPlugin](functions/upsertPlugin.md)
-- [validateActionRequest](functions/validateActionRequest.md)
-- [validateModelRequestBody](functions/validateModelRequestBody.md)
-- [validateQueryParams](functions/validateQueryParams.md)
-- [validateRequestBody](functions/validateRequestBody.md)
-- [validateResponseData](functions/validateResponseData.md)
-- [withApiErrorHandling](functions/withApiErrorHandling.md)
-- [wrapActionResponse](functions/wrapActionResponse.md)
-- [wrapScript](functions/wrapScript.md)