@terreno/mcp 57.4.0 → 57.6.1

package/README.md

@@ -32,6 +32,17 @@ Code generation tools:
 - `terreno_validate_model_schema` - Validate a Mongoose schema follows conventions
 - `terreno_install_admin` - Generate admin panel integration files and instructions
 
+Local runtime tools (`terreno-mcp-local`):
+
+- `get_syncdb_state` - Inspect live SyncDB entities, outbox, conflicts, cursors,
+  streams, repair markers, status, and debugger events
+- `syncdb_snapshot` - Capture, list, read, compare, and delete SyncDB snapshots
+- `syncdb_action` - Mutate/edit local state, flush, reconcile/resync,
+  resolve/retry, toggle offline mode, clear events, and merge snapshots
+
+Create the SyncDB client with `debug: true`. State changes require
+`TERRENO_MCP_EVAL=1`; reads and snapshots do not.
+
 ### Prompts
 
 Code generation prompts:
@@ -278,8 +289,8 @@ This will generate a comprehensive prompt with instructions for creating:
 
 ## Documentation
 
-Full API reference: [docs/reference/mcp-server.md](https://github.com/flourishhealth/terreno/blob/master/docs/reference/mcp-server.md)
+Full API reference: [docs/reference/mcp-server.md](https://github.com/TerrenoLabs/terreno/blob/master/docs/reference/mcp-server.md)
 
 ## License and Contributing
 
-Licensed under the [MIT License](https://github.com/flourishhealth/terreno/blob/master/LICENSE). See [CONTRIBUTING.md](https://github.com/flourishhealth/terreno/blob/master/CONTRIBUTING.md) for contribution guidelines.
+Licensed under the [MIT License](https://github.com/TerrenoLabs/terreno/blob/master/LICENSE). See [CONTRIBUTING.md](https://github.com/TerrenoLabs/terreno/blob/master/CONTRIBUTING.md) for contribution guidelines.

package/dist/bootstrap.d.ts

@@ -1,5 +1,19 @@
 import type { Tool } from "@modelcontextprotocol/server";
+interface BootstrapArgs {
+    appName: string;
+    appDisplayName: string;
+    description?: string;
+}
 export declare const bootstrapTools: Tool[];
+export interface BootstrapAiRulesArgs extends BootstrapArgs {
+    /** Optional `@terreno/*` package ids to include (e.g. `["api","ui"]`). Omits others from merged guidelines. */
+    packages?: string[];
+}
+interface AiRulesFile {
+    path: string;
+    content: string;
+}
+export declare const generateAiRulesFiles: (args: BootstrapAiRulesArgs) => AiRulesFile[];
 export declare const handleBootstrapToolCall: (name: string, args: Record<string, unknown>) => {
     content: Array<{
         type: "text";

package/dist/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,8BAA8B,CAAC;AAgBvD,eAAO,MAAM,cAAc,EAAE,IAAI,EA+BhC,CAAC;AAwcF,eAAO,MAAM,uBAAuB,GAClC,MAAM,MAAM,EACZ,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B;IAAC,OAAO,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,CAAC,CAAA;CAQ/C,CAAC;AAGF,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;CACJ;AAED,eAAO,MAAM,gBAAgB,EAAE,eAAe,EAkB7C,CAAC;AAEF,eAAO,MAAM,4BAA4B,GACvC,MAAM,MAAM,EACZ,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC3B;IAAC,QAAQ,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAC,CAAA;KAAC,CAAC,CAAA;CA8DzE,CAAC"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,8BAA8B,CAAC;AAUvD,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,cAAc,EAAE,IAAI,EA+BhC,CAAC;AAEF,MAAM,WAAW,oBAAqB,SAAQ,aAAa;IACzD,+GAA+G;IAC/G,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAgVD,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,oBAAoB,GAAI,MAAM,oBAAoB,KAAG,WAAW,EA6B5E,CAAC;AAiFF,eAAO,MAAM,uBAAuB,GAClC,MAAM,MAAM,EACZ,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B;IAAC,OAAO,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,CAAC,CAAA;CAQ/C,CAAC;AAGF,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;CACJ;AAED,eAAO,MAAM,gBAAgB,EAAE,eAAe,EAkB7C,CAAC;AAEF,eAAO,MAAM,4BAA4B,GACvC,MAAM,MAAM,EACZ,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC3B;IAAC,QAAQ,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAC,CAAA;KAAC,CAAC,CAAA;CA8DzE,CAAC"}

package/dist/bootstrap.js

@@ -17,7 +17,7 @@ export const bootstrapTools = [
                     type: "string",
                 },
                 packages: {
-                    description: 'Optional list of Terreno packages to include in merged guidelines (e.g. ["api","ui","rtk"]). Use names like `api`, `ui`, `rtk`, `admin-backend`, `admin-frontend`, or `@terreno/api`. Omit admin packages if the app does not use the admin panel.',
+                    description: 'Optional list of Terreno packages to include in merged guidelines (e.g. ["api","ui","rtk","syncdb"]). Use names like `api`, `ui`, `rtk`, `syncdb`, `admin-backend`, `admin-frontend`, or `@terreno/api`. Omit admin packages if the app does not use the admin panel.',
                     items: { type: "string" },
                     type: "array",
                 },
@@ -329,7 +329,7 @@ bun run lint     # Lint code
 4. Use SDK hooks for non-synced routes; use syncdb hooks for synced collections
 `;
 };
-const generateAiRulesFiles = (args) => {
+export const generateAiRulesFiles = (args) => {
     const packageIds = resolveBootstrapGuidelinePackages(args.packages);
     // Strip frontmatter for direct output files
     const stripFrontmatter = (content) => {

package/dist/bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"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"}

package/dist/docs/guidelines/syncdb/guidelines/core.md

@@ -0,0 +1,22 @@
+### @terreno/syncdb
+
+Use SyncDB for collection CRUD. Reads come from the local TinyBase store; writes
+use `useMutate` or `client.mutate` and enter the durable outbox.
+
+When debugging a running app, invoke the `debug-syncdb-with-mcp` skill and use
+the local Terreno MCP before arbitrary runtime evaluation:
+
+1. Create the client with `debug: true` in development.
+2. Call `get_syncdb_state` for entities, tombstones, pending mutations, outbox,
+   conflicts, cursors, streams, repair markers, status, and debug events.
+3. Use `syncdb_snapshot` before and after reproduction, then compare the captures.
+4. Set `TERRENO_MCP_EVAL=1` only when state changes are required; use
+   `syncdb_action` for mutations, local-only edits, outbox flush, reconcile,
+   resync, conflict resolution, retries, offline simulation, and snapshot merge.
+
+Sensitive fields are redacted from MCP responses. Direct local edits and snapshot
+merges bypass normal mutation/outbox semantics; use them only to reproduce or
+repair local-state problems.
+
+Full workflow: `docs/how-to/debug-with-mcp.md`. API details:
+`docs/reference/syncdb.md` and `docs/reference/mcp-server.md`.

package/dist/docs/guidelines/syncdb/skills/debug-syncdb-with-mcp/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: debug-syncdb-with-mcp
+description: >-
+  Invoke when debugging SyncDB local state, stale data, outbox stalls,
+  conflicts, cursor/stream drift, reconciliation, or offline behavior in a
+  running Terreno app. Uses terreno-mcp-local to inspect, snapshot, compare,
+  mutate, flush, merge, and repair SyncDB state.
+---
+# Debug SyncDB with MCP
+
+Use the fixed SyncDB MCP tools instead of arbitrary `evaluate` snippets.
+
+## 1. Establish the live client
+
+1. Confirm the app creates its SyncDB client with `debug: true` in development.
+2. Start the app and authenticate the affected user.
+3. Call `get_syncdb_state` without filters.
+
+Continue only when the response names a registered client and includes `status`,
+`collections`, `outbox`, `conflicts`, `cursors`, `knownStreams`, `needsRepair`,
+and `debug`.
+
+## 2. Capture the baseline
+
+Call `syncdb_snapshot` with `action: "capture"`. Keep the returned snapshot id.
+Use `collection`, `entityId`, or `limit` only when the full state is too large.
+
+The capture retains mergeable TinyBase content inside the local MCP process.
+Returned JSON redacts sensitive fields and does not expose that merge payload.
+
+## 3. Reproduce and inspect
+
+Reproduce the issue once, then call:
+
+- `get_syncdb_state` for the current state and debugger event stream
+- `syncdb_snapshot` with `action: "capture"` for the post-reproduction state
+- `syncdb_snapshot` with `action: "compare"` and both snapshot ids
+
+Use the diff plus debug events to identify whether divergence begins at the
+local mutation, outbox send, ack/nack, delta, cursor, or reconcile phase.
+
+## 4. Change state only when required
+
+Restart `terreno-mcp-local` with `TERRENO_MCP_EVAL=1`, then use
+`syncdb_action`:
+
+| Action | Purpose |
+| --- | --- |
+| `mutate` | Normal optimistic create/update/delete through the outbox |
+| `setLocalEntity` / `deleteLocalEntity` | Direct local-only fault injection or repair |
+| `flush` | Drain the durable outbox now |
+| `reconcile` / `forceResync` | Catch up or purge and rebuild from server snapshots |
+| `resolveConflict` / `retryFailed` | Unblock conflicted or terminally failed entities |
+| `goOffline` / `goOnline` | Exercise queueing and reconnect behavior |
+| `mergeSnapshot` | CRDT-merge a prior capture into the current TinyBase store; later HLCs win, including deletes |
+| `clearDebug` | Reset retained debugger events and counters |
+
+Prefer `mutate` over direct local edits. Capture another snapshot before
+`setLocalEntity`, `deleteLocalEntity`, or `mergeSnapshot`; those actions bypass
+normal server validation and outbox semantics.
+
+## 5. Prove the diagnosis
+
+Capture and compare a final snapshot, then verify:
+
+- the expected entity payload, tombstone, seq, and stream
+- no unintended pending mutation remains
+- queued/conflict/failed counts match the expected outcome
+- cursors and known streams are coherent
+- debugger events show the expected send/ack/delta/reconcile sequence
+
+The workflow is complete when the state diff and event sequence explain the
+failure or prove the repair. See `docs/how-to/debug-with-mcp.md` for setup and
+examples.

package/dist/docs/resources/overview.md

@@ -37,6 +37,14 @@ request to a mergeable pull request.
 
 New apps: **syncdb + Better Auth** for data and auth; **rtk** for generated SDK hooks on non-synced routes only.
 
+## MCP development tools
+
+Use the hosted Terreno MCP for documentation and generators, and `terreno-mcp-local` for package
+versions, read-only Mongo inspection, merged logs, client state, and Metro/CDP runtime tools.
+Configure both with `docs/how-to/set-up-terreno-mcp.md`; follow
+`docs/how-to/debug-with-mcp.md` for the diagnostic workflow. The `terreno` CLI exposes the same
+local tools for terminal use.
+
 ## Development
 
 Uses [Bun](https://bun.sh/) as the package manager. Use `bun` commands, not `npm`.

package/dist/docs/resources/rtk.md

@@ -1,6 +1,6 @@
 # @terreno/rtk Documentation (legacy)
 
-> **Deprecated for data synchronization** as of `56.0.0`. Use `@terreno/syncdb` for collection CRUD. This resource documents RTK for OpenAPI SDK codegen, Better Auth session Redux, feature flags, and sockets during the support window. See [migrate-rtk-to-syncdb.md](https://github.com/FlourishHealth/terreno/blob/master/docs/how-to/migrate-rtk-to-syncdb.md).
+> **Deprecated for data synchronization** as of `56.0.0`. Use `@terreno/syncdb` for collection CRUD. This resource documents RTK for OpenAPI SDK codegen, Better Auth session Redux, feature flags, and sockets during the support window. See [migrate-rtk-to-syncdb.md](https://github.com/TerrenoLabs/terreno/blob/master/docs/how-to/migrate-rtk-to-syncdb.md).
 
 Redux Toolkit Query utilities for frontends connecting to @terreno/api backends.
 

package/dist/docs/resources/syncdb.md

@@ -41,6 +41,15 @@ collections. Keep `bun run sdk` for non-synced routes such as auth/me and AI.
 Built-in admin String-`_id` CRUD uses windowed syncdb; admin RPC uses its
 host-bound fetch client; ObjectId compatibility CRUD remains RTK in Terreno 57.
 
-Full reference: [docs/reference/syncdb.md](https://github.com/FlourishHealth/terreno/blob/master/docs/reference/syncdb.md)
+## Local MCP debugging
 
-Migration: [docs/how-to/migrate-rtk-to-syncdb.md](https://github.com/FlourishHealth/terreno/blob/master/docs/how-to/migrate-rtk-to-syncdb.md)
+Create the client with `debug: true`, then use `get_syncdb_state` for debugger
+events, status, entities, outbox, conflicts, cursors, streams, and repair
+markers. Use `syncdb_snapshot` to capture and compare local state.
+`syncdb_action` can mutate/edit, flush, reconcile/resync, resolve/retry, toggle
+offline mode, clear events, and merge snapshots when the local MCP starts with
+`TERRENO_MCP_EVAL=1`.
+
+Full reference: [docs/reference/syncdb.md](https://github.com/TerrenoLabs/terreno/blob/master/docs/reference/syncdb.md)
+
+Migration: [docs/how-to/migrate-rtk-to-syncdb.md](https://github.com/TerrenoLabs/terreno/blob/master/docs/how-to/migrate-rtk-to-syncdb.md)

package/dist/docs/templates/bootstrap/frontend/app/_layout.template.tsx

@@ -5,13 +5,15 @@ import {Stack} from "expo-router";
 import * as SplashScreen from "expo-splash-screen";
 import {useEffect} from "react";
 import "react-native-reanimated";
-import {baseUrl, useSelectCurrentUserId} from "@terreno/rtk";
+import {baseUrl, installTerrenoDevConsoleLogger, selectBetterAuthUserId} from "@terreno/rtk";
 import {TerrenoProvider} from "@terreno/ui";
-import {Provider} from "react-redux";
+import {Provider, useSelector} from "react-redux";
 import {PersistGate} from "redux-persist/integration/react";
 import {useColorScheme} from "@/components/useColorScheme";
 import store, {persistor} from "@/store/index";
 
+installTerrenoDevConsoleLogger();
+
 export {ErrorBoundary} from "expo-router";
 
 export const unstable_settings = {
@@ -55,7 +57,7 @@ export default function RootLayout(): React.ReactElement | null {
 
 function RootLayoutNav(): React.ReactElement {
   const colorScheme = useColorScheme();
-  const userId = useSelectCurrentUserId();
+  const userId = useSelector(selectBetterAuthUserId);
 
   return (
     <ThemeProvider value={colorScheme === "dark" ? DarkTheme : DefaultTheme}>

package/dist/docs/ui-types-documentation.json

@@ -0,0 +1,33 @@
+{
+  "children": [
+    {
+      "name": "Common",
+      "children": [
+        {
+          "name": "ButtonProps",
+          "kind": 256,
+          "children": [
+            {
+              "name": "text",
+              "type": {"type": "intrinsic", "name": "string"},
+              "flags": {},
+              "comment": {"summary": [{"text": "Button text"}]}
+            },
+            {
+              "name": "onClick",
+              "type": {
+                "type": "reflection",
+                "declaration": {"signatures": [{}]}
+              },
+              "flags": {"isOptional": true}
+            }
+          ]
+        },
+        {
+          "name": "NotAnInterface",
+          "kind": 128
+        }
+      ]
+    }
+  ]
+}

package/dist/docs/upgrades/56.0.0-beta.2.md

@@ -32,8 +32,8 @@ until you are ready to move the app to Expo 56.
 Optional local-first layer (TinyBase MergeableStore, durable outbox, websocket delta sync,
 encrypted web persistence). Install as `@terreno/syncdb@beta` (or the exact version). See:
 
-- [`docs/how-to/migrate-rtk-to-syncdb.md`](https://github.com/FlourishHealth/terreno/blob/master/docs/how-to/migrate-rtk-to-syncdb.md)
-- [`docs/reference/syncdb.md`](https://github.com/FlourishHealth/terreno/blob/master/docs/reference/syncdb.md)
+- [`docs/how-to/migrate-rtk-to-syncdb.md`](https://github.com/TerrenoLabs/terreno/blob/master/docs/how-to/migrate-rtk-to-syncdb.md)
+- [`docs/reference/syncdb.md`](https://github.com/TerrenoLabs/terreno/blob/master/docs/reference/syncdb.md)
 
 `@terreno/syncdb` does not replace the generated OpenAPI SDK, Better Auth wiring, or
 feature flags — only collection sync/CRUD offline paths.

package/dist/docs/upgrades/57.4.0.md

@@ -26,6 +26,32 @@ See [migrate-rtk-to-syncdb.md](../../../docs/how-to/migrate-rtk-to-syncdb.md).
 
 ## Changed behavior
 
+### Framework Mongoose models use Terreno-specific names
+
+**What changed**
+
+Framework-owned models introduced in 57.3 and 57.4 now register as
+`TerrenoAuthToken`, `TerrenoMcpServiceToken`, `TerrenoWebhookReceipt`,
+`TerrenoInboxNotification`, `TerrenoNotificationPreference`, `TerrenoOrganization`,
+`TerrenoMembership`, `TerrenoAuditEvent`, `TerrenoJob`, `TerrenoJobSchedule`, and
+the `TerrenoAnnouncement*` names.
+
+**Why**
+
+Generic Mongoose names such as `Notification`, `Membership`, and `Job` collided with
+consumer models on the default connection.
+
+**Migration**
+
+No MongoDB migration is needed: every model remains pinned to its existing collection.
+Update code that inspects framework `modelName` values. Consumer models can keep their
+generic names.
+
+JWT recovery routes also have independent `authOptions` switches:
+`passwordReset`, `emailVerification`, and `legacyResetPasswordRoute`. All default on.
+Set `legacyResetPasswordRoute: false` if your app owns `POST /resetPassword` but still
+uses `POST /auth/resetPassword`.
+
 ### Scaffold with `create-terreno-app`, not MCP `terreno_bootstrap_app`
 
 **What changed**

package/dist/docs/upgrades/57.6.0.md

@@ -0,0 +1,135 @@
+# Upgrading to 57.6.0
+
+**Action required:** Yes
+**Affected packages:** @terreno/api, @terreno/test, @terreno/mcp, @terreno/cli, create-terreno-app
+
+## Summary
+
+Bump every `@terreno/*` package together to `57.6.0`. This minor on the Expo SDK 57 line namespaces framework Mongoose models so they no longer collide with consumer `Notification` / `Membership` / `Job` models, moves the GitHub home to `TerrenoLabs/terreno`, and documents TypeScript 6 tsconfig profiles, `@terreno/cli`, Slack member-id mentions, and SyncDB tools on `terreno-mcp-local`. No Expo upgrade is required if you are already on `57.x`.
+
+## Breaking changes
+
+None
+
+## Deprecations
+
+None
+
+## Changed behavior
+
+### Framework Mongoose models use `Terreno*` names
+
+**What changed**
+
+Framework-owned models introduced in 57.3 and 57.4 now register as
+`TerrenoAuthToken`, `TerrenoMcpServiceToken`, `TerrenoWebhookReceipt`,
+`TerrenoInboxNotification`, `TerrenoNotificationPreference`, `TerrenoOrganization`,
+`TerrenoMembership`, `TerrenoAuditEvent`, `TerrenoJob`, `TerrenoJobSchedule`, and
+the `TerrenoAnnouncement*` names. Public helpers `FRAMEWORK_MODEL_PUBLIC_NAMES` and
+`publicFrameworkModelName` map compiled names back to the pre-namespace names used
+by admin UI keys and `admin<ModelName>` RBAC resources.
+
+JWT recovery routes also have independent `authOptions` switches:
+`passwordReset`, `emailVerification`, and `legacyResetPasswordRoute`. All default on.
+
+**Why**
+
+Generic Mongoose names such as `Notification`, `Membership`, and `Job` collided with
+consumer models on the default connection.
+
+**Migration**
+
+No MongoDB migration is needed: every model remains pinned to its existing collection.
+Update code that inspects framework `modelName` values. Consumer models can keep their
+generic names.
+
+```typescript
+// Before: mongoose.model("Notification") could be the framework inbox model
+// After: framework inbox is mongoose.model("TerrenoInboxNotification")
+// Admin / RBAC still use public names such as "Notification"
+```
+
+Set `legacyResetPasswordRoute: false` if your app owns `POST /resetPassword` but still
+uses `POST /auth/resetPassword`. See [password-reset.md](../../../docs/how-to/password-reset.md).
+
+### GitHub organization is TerrenoLabs
+
+**What changed**
+
+The repository is `TerrenoLabs/terreno`. The roadmap board is
+[github.com/orgs/TerrenoLabs/projects/1](https://github.com/orgs/TerrenoLabs/projects/1).
+Package `repository` URLs, docs links, and plugin/skill install commands point at the
+new org. Old `FlourishHealth/terreno` URLs redirect.
+
+**Why**
+
+Terreno now lives in its own GitHub organization.
+
+**Migration**
+
+```bash
+# Before
+/plugin marketplace add FlourishHealth/terreno
+npx skills add FlourishHealth/terreno
+
+# After
+/plugin marketplace add TerrenoLabs/terreno
+npx skills add TerrenoLabs/terreno
+```
+
+Update git remotes and clone URLs. Leave the Expo account `flourishhealth` as-is.
+
+### TypeScript 6 tsconfigs
+
+**What changed**
+
+Every Terreno tsconfig builds on TypeScript 6 without `ignoreDeprecations`. Node
+packages compile with `module: nodenext` to ES2023 CommonJS so dynamic `import()`
+stays a real ESM import (`loadMigrations` can load files by `file://` URL).
+Frontend libraries emit ES2022 with bundler resolution and declaration maps.
+`@terreno/test` no longer publishes its compiled Bun tests. `create-terreno-app`
+scaffolds drop `ignoreDeprecations` and `moduleResolution: node`.
+
+**Why**
+
+TypeScript 6 deprecates options that TypeScript 7 removes. `module: commonjs`
+rewrote dynamic `import()` to `require()`, which cannot load `file://` URLs.
+
+**Migration**
+
+If you copied a Terreno tsconfig, drop `ignoreDeprecations` and
+`moduleResolution: node`. Use `nodenext` for Node packages and `bundler` for
+frontend libraries. See [typescript-configuration.md](../../../docs/explanation/typescript-configuration.md).
+
+Do not import compiled test files from `@terreno/test` — they are no longer in
+the published package.
+
+## New capabilities
+
+### `@terreno/cli`
+
+The `terreno` binary searches docs, runs codegen (syncdb, RTK SDK, models, routes,
+screens, forms, admin), bootstraps apps, tails unified logs, inspects Redux/RTK
+state, and optionally drives CDP / Bun 1.4 WebView proof. OpenAPI helpers:
+`terreno api list|call|request` and `generate rest-cli`.
+
+### Slack member-id mentions
+
+`sendToSlack` accepts `mentionUserIds`. Names and emails in the message text do
+not notify anyone. Helpers: `formatSlackUserMention`, `normalizeSlackUserId`, and
+`lookupSlackUserIdByEmail` (optional `SLACK_BOT_TOKEN` with `users:read.email`).
+
+### SyncDB on `terreno-mcp-local`
+
+Inspect debugger and local-store state, snapshot/compare/merge, mutate entities,
+flush the outbox, reconcile/resync, resolve conflicts, retry failures, and
+exercise offline transitions. State-changing operations require `TERRENO_MCP_EVAL=1`.
+See [debug-with-mcp.md](../../../docs/how-to/debug-with-mcp.md).
+
+## Verification
+
+- `bun add` every `@terreno/*` dependency to `57.6.0`, then `bun run compile` and `bun run lint` at the app root
+- Confirm consumer models named `Notification`, `Membership`, or `Job` no longer collide with framework models
+- Point plugin/skill install commands at `TerrenoLabs/terreno`
+- If you copied a Terreno tsconfig, confirm `tsc` runs without `ignoreDeprecations`
+- `cd <your frontend> && bun run sdk` after pulling `@terreno/api` if you rely on new Slack helpers or auth option OpenAPI

package/dist/docs/versioned/0.29.0/explanation/modular-api-design.md

@@ -220,7 +220,7 @@ Migration will be supported with:
 ## Learn More
 
 - 📖 [Implementation plan](../implementationPlans/ModularAPI.md) — Full technical specification
-- 💬 [GitHub PR #149](https://github.com/FlourishHealth/terreno/pull/149) — Discussion and feedback
+- 💬 [GitHub PR #149](https://github.com/TerrenoLabs/terreno/pull/149) — Discussion and feedback
 
 ## Related
 

package/dist/docs/versioned/0.29.0/how-to/deploy-to-gcp.md

@@ -20,7 +20,7 @@ Run the setup script once to provision all GCP resources:
 
 ``````bash
 # Clone the repository
-git clone https://github.com/FlourishHealth/terreno.git
+git clone https://github.com/TerrenoLabs/terreno.git
 cd terreno
 
 # Run the setup script

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

@@ -16,8 +16,8 @@ Umbrella plans that coordinate several IPs.
 |------|--------|---------|-------|
 | [Admin UI v2 — Django-parity admin](admin-ui-v2-django-parity.md) | Approved | 2026-06-15 | [tasks](../tasks/admin-ui-v2-django-parity.md) |
 | [RBAC Permissions](rbac-permissions.md) | Draft (API design) | 2026-07-08 | TBD |
-| [SyncDB Local-First Data Layer](syncdb-local-first.md) | In progress ([PR #869](https://github.com/flourishhealth/terreno/pull/869)) | 2026-07-13 | [tasks](../tasks/syncdb-local-first.md) |
-| [MCP Boost parity](mcp-boost-parity.md) | In progress ([PR #802](https://github.com/flourishhealth/terreno/pull/802)) | 2026-06-21 | TBD |
+| [SyncDB Local-First Data Layer](syncdb-local-first.md) | In progress ([PR #869](https://github.com/TerrenoLabs/terreno/pull/869)) | 2026-07-13 | [tasks](../tasks/syncdb-local-first.md) |
+| [MCP Boost parity](mcp-boost-parity.md) | In progress ([PR #802](https://github.com/TerrenoLabs/terreno/pull/802)) | 2026-06-21 | TBD |
 
 ## Open source launch IPs
 

package/dist/docs/versioned/0.29.0/implementationPlans/README.md

@@ -26,7 +26,7 @@ This directory contains detailed technical plans for major features **before imp
 | Plan | Status | Target Version | Discussion |
 |------|--------|----------------|------------|
 | Admin UI v2 (Django parity) | ✅ Approved | TBD | — |
-| Modular API | 📝 Planning | 2.0.0 | [#149](https://github.com/FlourishHealth/terreno/pull/149) |
+| Modular API | 📝 Planning | 2.0.0 | [#149](https://github.com/TerrenoLabs/terreno/pull/149) |
 | Offline Mode | Placeholder | TBD | TBD |
 | MCP Boost Parity | 📝 Planning | TBD | TBD |
 | Docs Site & Versioning | 📝 Planning | TBD | TBD |

package/dist/docs/versioned/0.29.0/implementationPlans/ai-dev-loop-boost.md

@@ -6,7 +6,7 @@
 **Owner:** unassigned
 **Created:** 2026-07-27
 **Program:** [OSS launch](oss-launch-program.md)
-**Depends on:** PR [#802](https://github.com/flourishhealth/terreno/pull/802) merging (assumed)
+**Depends on:** PR [#802](https://github.com/TerrenoLabs/terreno/pull/802) merging (assumed)
 **RTK deprecation flag:** **Partial** — `get_rtk_state` and `installTerrenoDevConsoleLogger` are RTK-named surfaces delivered by #802 that must be renamed or relocated after #869. Marked tasks are blocked on both PRs.
 
 ## Goal

package/dist/docs/versioned/0.29.0/implementationPlans/deployment-foundation.md

@@ -61,7 +61,7 @@ Expo Router offers three, and the choice determines what hosting works:
 | `static` | per-route HTML | no | no | any static host | usable now; better SEO |
 | `server` | `dist/client` + `dist/server` | yes | yes (alpha, SDK ≥ 55) | needs a Node/Bun/edge runtime | not yet — see the SSR IP |
 
-The repo is currently on Expo `~54.0.29` (root `package.json` catalog), so `server` output with SSR requires the SDK upgrade tracked in PR [#779](https://github.com/flourishhealth/terreno/pull/779). The foundation doc must state this rather than implying SSR is available.
+The repo is currently on Expo `~54.0.29` (root `package.json` catalog), so `server` output with SSR requires the SDK upgrade tracked in PR [#779](https://github.com/TerrenoLabs/terreno/pull/779). The foundation doc must state this rather than implying SSR is available.
 
 ### Backend container
 

package/dist/docs/versioned/0.29.0/implementationPlans/oss-launch-program.md

@@ -37,7 +37,7 @@ Language rules for all docs:
 
 ## RTK deprecation gate
 
-**`@terreno/rtk` is being replaced.** PR [#869](https://github.com/flourishhealth/terreno/pull/869) (`@terreno/syncdb` local-first data layer) makes **Better Auth + `@terreno/syncdb`** the supported frontend platform. RTK Query becomes legacy.
+**`@terreno/rtk` is being replaced.** PR [#869](https://github.com/TerrenoLabs/terreno/pull/869) (`@terreno/syncdb` local-first data layer) makes **Better Auth + `@terreno/syncdb`** the supported frontend platform. RTK Query becomes legacy.
 
 **Program-wide rule: IPs flagged `Blocked` may not be implemented until #869 merges.** Writing docs against RTK now guarantees a rewrite. Planning (this program) proceeds; implementation of `None`-flagged IPs may start before #869; `Partial` IPs proceed except for `[RTK]`-marked tasks.
 
@@ -66,7 +66,7 @@ Every `[RTK]`-marked task in every task file must be reviewed against the merged
 
 ## Boost dependency (AI story)
 
-PR [#802](https://github.com/flourishhealth/terreno/pull/802) (MCP Boost parity, Phases 4–6) is **assumed merged** by the AI-facing IPs. It delivers the runtime half of the AI story:
+PR [#802](https://github.com/TerrenoLabs/terreno/pull/802) (MCP Boost parity, Phases 4–6) is **assumed merged** by the AI-facing IPs. It delivers the runtime half of the AI story:
 
 - `read_logs` merging backend / app (CDP) / Metro / browser sources
 - `last_error` across sources

package/dist/docs/versioned/0.29.0/implementationPlans/rtk-to-syncdb-migration-docs.md

@@ -6,7 +6,7 @@
 **Owner:** unassigned
 **Created:** 2026-07-27
 **Program:** [OSS launch](oss-launch-program.md)
-**Depends on:** PR [#869](https://github.com/flourishhealth/terreno/pull/869) merging
+**Depends on:** PR [#869](https://github.com/TerrenoLabs/terreno/pull/869) merging
 **RTK deprecation flag:** **Blocked** — this IP *is* the RTK deprecation. Nothing here can be written until #869 lands, because the public surface of `@terreno/syncdb` is not final until then.
 
 ## Goal

package/dist/docs/versioned/0.29.0/implementationPlans/terreno-langfuse-integration.md

@@ -2,7 +2,7 @@
 
 A TerrenoApp plugin that integrates [Langfuse](https://langfuse.com) into Terreno backends and frontends. Provides prompt management with MongoDB caching, OpenTelemetry tracing, Vercel AI SDK helpers, React hooks, and an admin UI — all wired up via `.install()`.
 
-> **Prerequisite:** This package relies on the new TerrenoApp plugin system (see [PR #149](https://github.com/FlourishHealth/terreno/pull/149)). TerrenoApp must support `.install()` before this package can be used.
+> **Prerequisite:** This package relies on the new TerrenoApp plugin system (see [PR #149](https://github.com/TerrenoLabs/terreno/pull/149)). TerrenoApp must support `.install()` before this package can be used.
 
 ## Why
 
@@ -142,4 +142,4 @@ const { prompt, compile, isLoading } = usePrompt('chat-assistant');
 - [Langfuse Prompt Management](https://langfuse.com/docs/prompt-management/get-started)
 - [Vercel AI SDK Integration](https://langfuse.com/integrations/frameworks/vercel-ai-sdk)
 - [TypeScript SDK v4](https://langfuse.com/changelog/2025-08-28-typescript-sdk-v4-ga)
-- [TerrenoApp PR #149](https://github.com/FlourishHealth/terreno/pull/149)
+- [TerrenoApp PR #149](https://github.com/TerrenoLabs/terreno/pull/149)

package/dist/docs/versioned/0.29.0/implementationPlans/web-ssr-and-admin-spa.md

@@ -6,7 +6,7 @@
 **Owner:** unassigned
 **Created:** 2026-07-27
 **Program:** [OSS launch](oss-launch-program.md) (Wave 2)
-**Depends on:** Expo SDK ≥ 55 (PR [#779](https://github.com/flourishhealth/terreno/pull/779) upgrades to SDK 56), [`deployment-foundation`](deployment-foundation.md)
+**Depends on:** Expo SDK ≥ 55 (PR [#779](https://github.com/TerrenoLabs/terreno/pull/779) upgrades to SDK 56), [`deployment-foundation`](deployment-foundation.md)
 **RTK deprecation flag:** **Partial** — SSR interacts directly with the data layer. Server-rendered HTML needs data at render time, which is a fundamentally different question for a local-first client than for a request/response client. The data-loading design tasks are `[RTK]` marked and blocked on #869.
 
 ## Goal

package/dist/docs/versioned/0.29.0/reference/README.md

@@ -18,5 +18,5 @@ Technical reference for Terreno packages and APIs. Information-oriented, precise
 
 ## Other references
 
-- Root [package.json](https://github.com/flourishhealth/terreno/blob/master/package.json) — Workspace scripts and catalog
+- Root [package.json](https://github.com/TerrenoLabs/terreno/blob/master/package.json) — Workspace scripts and catalog
 - Per-package `package.json` in each package directory — Commands and dependencies

package/dist/docs/versioned/0.29.0/reference/components/accordion.mdx

@@ -14,7 +14,7 @@ Accordion is a container that can be expanded and collapsed to show content abou
 **Package:** `@terreno/ui`  
 **Categories:** Component  
 **Props interface:** `AccordionProps`  
-**Story source:** [`demo/stories/Accordion.stories.tsx`](https://github.com/flourishhealth/terreno/blob/master/demo/stories/Accordion.stories.tsx)
+**Story source:** [`demo/stories/Accordion.stories.tsx`](https://github.com/TerrenoLabs/terreno/blob/master/demo/stories/Accordion.stories.tsx)
 
 ## Live demo