@voltro/cli 0.33.0 → 0.34.0

package/templates/apps/frontend-saas/src/pages/dashboard/page.test.tsx

@@ -1,7 +1,9 @@
 // @vitest-environment jsdom
 //
-// Projects page — the live list + the paywall branch. We mock `@voltro/client`
-// (useSubscription streams the rows; useMutation is the create) and drive the
+// Projects page — the live list + the paywall branch. We mock the app's TYPED
+// hook binding `src/lib/api.ts` (useSubscription streams the rows; useMutation
+// is the create) — mocking `@voltro/client` underneath it would leave the real
+// `createHooks` running over a stub, i.e. the wrong seam. We drive the
 // create form, asserting: the SSR'd rows render, the empty state shows, and a
 // `projects.create` that rejects with a typed `EntitlementExceeded` flips the
 // page into the upgrade CTA (NOT a raw error).
@@ -14,7 +16,15 @@ import enCatalog from '../../locales/en'
 
 const subData = vi.fn<() => { data: unknown }>()
 const mutate = vi.fn<(input: { name: string }) => Promise<unknown>>()
-vi.mock('@voltro/client', () => ({
+// Only the HOOKS are faked. `isEntitlementExceeded` comes through from the real
+// module — an earlier version of this file re-implemented it inside the mock,
+// which meant the paywall test asserted that a copy of the predicate agreed
+// with the literal the same test had just written. That passes in every world,
+// including the one where the framework hands `catch` a value with no `_tag`
+// at all. `import type` is erased, so importing the original pulls in nothing
+// but `@voltro/client`.
+vi.mock('../../lib/api', async (importOriginal) => ({
+  ...(await importOriginal<typeof import('../../lib/api')>()),
   useSubscription: () => subData(),
   useMutation: () => ({ mutate, pending: false, error: undefined, data: undefined }),
 }))
@@ -104,10 +114,24 @@ describe('projects — paywall', () => {
   })
 
   test('a typed EntitlementExceeded flips the page into the upgrade CTA', async () => {
+    // The rejection value is the TYPED ERROR ITSELF — that is the framework's
+    // guarantee for `mutate` / `run` / `signal` / `upload`, and the whole reason
+    // this page can branch on `_tag` instead of string-matching a message.
     mutate.mockRejectedValue({ _tag: 'EntitlementExceeded', entitlement: 'projects', limit: 3 })
     render(createElement(Projects))
     await submit()
     expect(container.querySelector('.paywall')).not.toBeNull()
     expect(container.textContent).toContain('hit your plan limit')
   })
+
+  test('an UNTAGGED failure does not paywall — that branch is for a declared outcome', async () => {
+    // The negative control, and the exact state the app was in while a rejected
+    // write handed back a wrapper with no `_tag`: the create fails, and the user
+    // is shown nothing about why. A paywall that appears for every failure is
+    // as wrong as one that never appears.
+    mutate.mockRejectedValue(new Error('socket hang up'))
+    render(createElement(Projects))
+    await submit()
+    expect(container.querySelector('.paywall')).toBeNull()
+  })
 })

package/templates/apps/frontend-saas/src/pages/dashboard/page.tsx

@@ -7,10 +7,9 @@
 import type { ReactNode } from 'react'
 import { useState, type FormEvent } from 'react'
 import type { PageMeta } from '@voltro/web'
-import { useSubscription, useMutation } from '@voltro/client'
 import { T, useT } from '@voltro/i18n'
 import { getCatalog } from '../../locales'
-import { isEntitlementExceeded, type Project } from '../../lib/api'
+import { isEntitlementExceeded, useMutation, useSubscription } from '../../lib/api'
 
 export const renderMode = 'ssr' as const
 
@@ -19,8 +18,9 @@ export const meta = ({ locale }: { readonly locale: string }): PageMeta => ({
 })
 
 export default function Projects(): ReactNode {
-  const { data: live } = useSubscription<ReadonlyArray<Project>>('app', 'projects.list')
-  const { mutate, pending } = useMutation<{ name: string }, Project>('app', 'projects.create')
+  // Tag + row type both come from the generated procedure map — no annotation.
+  const { data: live } = useSubscription('projects.list')
+  const { mutate, pending } = useMutation('projects.create')
   const projects = live ?? []
   const [name, setName] = useState('')
   const [paywalled, setPaywalled] = useState(false)

package/templates/apps/frontend-saas/src/pages/dashboard/team/page.tsx

@@ -6,10 +6,9 @@
 import type { ReactNode } from 'react'
 import { useState, type FormEvent } from 'react'
 import type { PageMeta } from '@voltro/web'
-import { useSubscription, useMutation } from '@voltro/client'
 import { T, useT } from '@voltro/i18n'
 import { getCatalog } from '../../../locales/index'
-import { isEntitlementExceeded, type Invite } from '../../../lib/api'
+import { isEntitlementExceeded, useMutation, useSubscription } from '../../../lib/api'
 
 export const renderMode = 'ssr' as const
 
@@ -24,8 +23,8 @@ const STATUS_KEY: Record<string, 'team.status.pending' | 'team.status.accepted'
 }
 
 export default function Team(): ReactNode {
-  const { data: live } = useSubscription<ReadonlyArray<Invite>>('app', 'invites.list')
-  const { mutate, pending } = useMutation<{ email: string }, Invite>('app', 'invites.create')
+  const { data: live } = useSubscription('invites.list')
+  const { mutate, pending } = useMutation('invites.create')
   const invites = live ?? []
   const [email, setEmail] = useState('')
   const [outOfSeats, setOutOfSeats] = useState(false)

package/templates/apps/frontend-spa/package.json

@@ -12,20 +12,22 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@voltro/cli": "0.33.0",
-    "@voltro/client": "0.33.0",
-    "@voltro/env": "0.33.0",
-    "@voltro/i18n": "0.33.0",
-    "@voltro/ui-shadcn": "0.33.0",
-    "@voltro/web": "0.33.0",
+    "@voltro/cli": "0.34.0",
+    "@voltro/client": "0.34.0",
+    "@voltro/env": "0.34.0",
+    "@voltro/i18n": "0.34.0",
+    "@voltro/ui-shadcn": "0.34.0",
+    "@voltro/web": "0.34.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@voltro/devtools": "0.33.0",
+    "@voltro/devtools": "0.34.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
+    "jsdom": "^30.0.0",
     "typescript": "^6.0.3",
+    "@vitest/coverage-v8": "^4.1.10",
     "vitest": "^4.1.10"
   }
 }

package/templates/apps/frontend-ssr/package.json

@@ -12,20 +12,22 @@
     "test": "voltro test"
   },
   "dependencies": {
-    "@voltro/cli": "0.33.0",
-    "@voltro/client": "0.33.0",
-    "@voltro/env": "0.33.0",
-    "@voltro/i18n": "0.33.0",
-    "@voltro/ui-shadcn": "0.33.0",
-    "@voltro/web": "0.33.0",
+    "@voltro/cli": "0.34.0",
+    "@voltro/client": "0.34.0",
+    "@voltro/env": "0.34.0",
+    "@voltro/i18n": "0.34.0",
+    "@voltro/ui-shadcn": "0.34.0",
+    "@voltro/web": "0.34.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@voltro/devtools": "0.33.0",
+    "@voltro/devtools": "0.34.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
+    "jsdom": "^30.0.0",
     "typescript": "^6.0.3",
+    "@vitest/coverage-v8": "^4.1.10",
     "vitest": "^4.1.10"
   }
 }

package/templates/apps/frontend-ssr-api/package.json

@@ -12,21 +12,23 @@
     "test": "voltro test"
   },
   "dependencies": {
-    "@{{projectName}}/api": "0.33.0",
-    "@voltro/cli": "0.33.0",
-    "@voltro/client": "0.33.0",
-    "@voltro/env": "0.33.0",
-    "@voltro/i18n": "0.33.0",
-    "@voltro/ui-shadcn": "0.33.0",
-    "@voltro/web": "0.33.0",
+    "@{{projectName}}/api": "0.34.0",
+    "@voltro/cli": "0.34.0",
+    "@voltro/client": "0.34.0",
+    "@voltro/env": "0.34.0",
+    "@voltro/i18n": "0.34.0",
+    "@voltro/ui-shadcn": "0.34.0",
+    "@voltro/web": "0.34.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@voltro/devtools": "0.33.0",
+    "@voltro/devtools": "0.34.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
+    "jsdom": "^30.0.0",
     "typescript": "^6.0.3",
+    "@vitest/coverage-v8": "^4.1.10",
     "vitest": "^4.1.10"
   }
 }

package/templates/apps/frontend-static-blog/package.json

@@ -12,19 +12,21 @@
     "test": "voltro test"
   },
   "dependencies": {
-    "@voltro/cli": "0.33.0",
-    "@voltro/client": "0.33.0",
-    "@voltro/env": "0.33.0",
-    "@voltro/i18n": "0.33.0",
-    "@voltro/web": "0.33.0",
+    "@voltro/cli": "0.34.0",
+    "@voltro/client": "0.34.0",
+    "@voltro/env": "0.34.0",
+    "@voltro/i18n": "0.34.0",
+    "@voltro/web": "0.34.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@voltro/devtools": "0.33.0",
+    "@voltro/devtools": "0.34.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
+    "jsdom": "^30.0.0",
     "typescript": "^6.0.3",
+    "@vitest/coverage-v8": "^4.1.10",
     "vitest": "^4.1.10"
   }
 }

package/templates/apps/frontend-status/package.json

@@ -12,21 +12,23 @@
     "test": "voltro test"
   },
   "dependencies": {
-    "@{{projectName}}/api": "0.33.0",
-    "@voltro/cli": "0.33.0",
-    "@voltro/client": "0.33.0",
-    "@voltro/env": "0.33.0",
-    "@voltro/i18n": "0.33.0",
-    "@voltro/ui-shadcn": "0.33.0",
-    "@voltro/web": "0.33.0",
+    "@{{projectName}}/api": "0.34.0",
+    "@voltro/cli": "0.34.0",
+    "@voltro/client": "0.34.0",
+    "@voltro/env": "0.34.0",
+    "@voltro/i18n": "0.34.0",
+    "@voltro/ui-shadcn": "0.34.0",
+    "@voltro/web": "0.34.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@voltro/devtools": "0.33.0",
+    "@voltro/devtools": "0.34.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
+    "jsdom": "^30.0.0",
     "typescript": "^6.0.3",
+    "@vitest/coverage-v8": "^4.1.10",
     "vitest": "^4.1.10"
   }
 }

package/templates/apps/mobile-app/README.md

@@ -27,6 +27,7 @@ pnpm ios        # or: pnpm android · pnpm start (Expo Go)
 
 | Path | What |
 |---|---|
+| `src/lib/api.ts` | the **typed hook binding** — `createHooks<AppProcedures>('app')`, imported by every screen |
 | `src/lib/deeplinks.ts` | the typed deep-link table + pure resolver (**tested**) |
 | `src/lib/sync.ts` | the background-sync decision layer (**tested**) |
 | `src/lib/notifications.ts` | build a `_voltro_devices` row from a push token (**tested**) |

package/templates/apps/mobile-app/package.json

@@ -12,8 +12,8 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@voltro/client": "0.33.0",
-    "@voltro/react-native": "0.33.0",
+    "@voltro/client": "0.34.0",
+    "@voltro/react-native": "0.34.0",
     "expo": "^52.0.0",
     "expo-constants": "~17.0.0",
     "expo-linking": "~7.0.0",
@@ -26,8 +26,10 @@
     "react-native": "0.76.5"
   },
   "devDependencies": {
+    "@{{projectName}}/api": "0.34.0",
     "@types/react": "^19.0.0",
     "typescript": "^6.0.3",
+    "@vitest/coverage-v8": "^4.1.10",
     "vitest": "^4.1.10"
   }
 }

package/templates/apps/mobile-app/src/app/index.tsx

@@ -1,22 +1,29 @@
 // Home screen — the reactive end-to-end loop, on a phone.
 //
-// The SAME hooks as the web frontend: `useSubscription('app', 'notes.list')`
-// streams the server-side query; `useMutation('app', 'notes.create')` writes it.
-// When the mutation lands, the server pushes a delta and this list re-renders —
-// no refetch, no polling. (Requires the M0 client boot; see ../client.ts.)
+// The SAME hooks as the web frontend: `useSubscription('notes.list')` streams
+// the server-side query; `useMutation('notes.create')` writes it. When the
+// mutation lands, the server pushes a delta and this list re-renders — no
+// refetch, no polling. (Requires the M0 client boot; see ../client.ts.)
+//
+// Both come from `../lib/api`, which binds them ONCE to the api's generated
+// procedure map — so the tag autocompletes, a typo is a compile error, and the
+// row type is inferred rather than declared here.
 import { useState } from 'react'
 import { Link } from 'expo-router'
 import { FlatList, Pressable, Text, TextInput, View } from 'react-native'
-import { useMutation, useSubscription } from '@voltro/client'
 
-interface Note {
-  readonly id: string
-  readonly title: string
-}
+import { useMutation, useSubscription } from '../lib/api'
+
+// The dev AuthMiddleware resolves the tenant from the `x-tenant` header,
+// defaulting to 'acme'. `notes.create` guards that the submitted tenantId
+// matches the caller's (a typed TenantMismatch otherwise).
+const TENANT = 'acme'
 
 export default function Home() {
-  const notes = useSubscription<ReadonlyArray<Note>>('app', 'notes.list')
-  const createNote = useMutation<{ title: string }, Note>('app', 'notes.create')
+  // No row `interface` and no `<T>`: the shape comes from `notes.list`'s own
+  // output schema, including the client's `optimistic` marker.
+  const notes = useSubscription('notes.list')
+  const createNote = useMutation('notes.create')
   const [title, setTitle] = useState('')
 
   return (
@@ -32,7 +39,10 @@ export default function Home() {
           onPress={() => {
             if (title.trim().length === 0) return
             // Auto-optimistic: the list updates instantly, reconciles on ack.
-            createNote.mutate({ title: title.trim() })
+            // `tenantId` and `body` are REQUIRED by `notes.create`'s input
+            // schema — the old hand-written `useMutation<{ title: string }>`
+            // annotation hid that, so this call decoded-failed at runtime.
+            createNote.mutate({ tenantId: TENANT, title: title.trim(), body: '' })
             setTitle('')
           }}
           style={{ backgroundColor: '#2563eb', borderRadius: 8, paddingHorizontal: 16, justifyContent: 'center' }}

package/templates/apps/mobile-app/src/app/orders/[id].tsx

@@ -12,7 +12,7 @@ export default function OrderDetail() {
       <Text style={{ fontSize: 20, fontWeight: '700' }}>Order {id}</Text>
       <Text style={{ color: '#666' }}>
         Reached via the typed deep-link table. Fetch this order with
-        {' '}useSubscription('app', 'orders.get', {'{'} id {'}'}).
+        {' '}useSubscription('orders.get', {'{'} id {'}'}) from ../../lib/api.
       </Text>
     </View>
   )

package/templates/apps/mobile-app/src/lib/api.ts

@@ -0,0 +1,34 @@
+// The typed hook surface for the `app` api — bound ONCE, here, and imported by
+// every screen instead of `@voltro/client`.
+//
+// `AppProcedures` is emitted by codegen into the sibling api's
+// `rpcGroup.generated.ts`: a type-level map of every rpc tag to the descriptor
+// behind it. Feeding it to `createHooks` makes the tag a literal union and the
+// input/output types INFER:
+//
+//     const notes  = useSubscription('notes.list')   // rows, typed
+//     const create = useMutation('notes.create')     // input + output typed
+//
+// So no screen declares a row `interface` mirroring the api any more. The old
+// `useSubscription<ReadonlyArray<Note>>('app', 'notes.list')` spelled the api
+// name at every call site, left the tag an unchecked string (a typo was a
+// runtime error), and the `<T>` was an ASSERTION nothing compared against the
+// server. All three are compile-checked now.
+//
+// `'app'` is the key this project's api is registered under. The api is a
+// type-only import — `import type` is erased, so Metro never resolves it and
+// nothing server-side reaches the bundle. It is a devDependency for exactly
+// that reason; scaffold the pair (`create-project --api=api-backend --mobile`),
+// which is what this template's README already assumes.
+//
+// RUNTIME NOTE: the hooks are typed today and live once the mobile codegen
+// target lands — `buildApiHandles()` in ../client.ts still returns an empty map
+// (see the seam documented there), so screens render their loading state until
+// then. The TYPES are real either way; they come from the api's own descriptors.
+import { createHooks } from '@voltro/client'
+import type { AppProcedures } from '@{{projectName}}/api/rpcGroup'
+
+// Destructured on purpose — `react-hooks/rules-of-hooks` only treats a member
+// call as a hook when the object is PascalCase, so top-level `useX` identifiers
+// are what keep the React lint rules working at every call site.
+export const { useSubscription, useMutation, useAction } = createHooks<AppProcedures>('app')

package/templates/apps/mobile-app/voltro.mobile.ts

@@ -1,6 +1,8 @@
 // The api(s) this mobile app consumes — mirrors a web app.config.ts's `apis:`
-// map. The NAME ('app') is the lookup key the hooks use:
-// `useSubscription('app', 'notes.list')`, `useMutation('app', 'notes.create')`.
+// map. The NAME ('app') is the lookup key the hooks bind to: `src/lib/api.ts`
+// spells it ONCE via `createHooks<AppProcedures>('app')`, and every screen then
+// calls `useSubscription('notes.list')` / `useMutation('notes.create')` with no
+// api name and no hand-written result type.
 // The `package` resolves the sibling api in this project so codegen can pull its
 // typed rpc surface (end-to-end types on a phone). Scaffold the api with
 // `--api=api-backend`.

package/templates/baselines/bare/.env.example

@@ -5,6 +5,20 @@
 # override .env values, so CI can set DB_URL via env without touching
 # this file.
 
+# ── Environment ────────────────────────────────────────────────────────
+#
+# DECLARE IT. Every `voltro db …` / `voltro migrate` invocation resolves an
+# UNSET `NODE_ENV` to `production` — the same way `voltro serve` and `voltro
+# start` do — so a bare `pnpm migrate` with no NODE_ENV refuses rather than
+# applying an un-reviewed diff to what might be a production database. It also
+# decides which `_voltro_*` bookkeeping tables the command declares, and a
+# migration command that resolves it differently from the serving process
+# declares a DIFFERENT schema.
+#
+# `voltro dev` declares `development` for itself and needs nothing from here;
+# this line is what makes the explicit schema commands work locally.
+NODE_ENV=development
+
 # Postgres connection. Bring your own (host install, docker run,
 # cloud provider URL).
 DB_URL=postgres://app:app@localhost:5432/{{projectName}}

package/templates/baselines/bare/baseline.json

@@ -23,9 +23,9 @@
     "deploy/voltro.service.example"
   ],
   "packageJsonScripts": {
-    "dev":       "turbo run dev",
-    "build":     "turbo run build",
-    "test":      "turbo run test",
-    "typecheck": "turbo run typecheck"
+    "dev":       "pnpm -r --parallel dev",
+    "build":     "pnpm -r build",
+    "test":      "pnpm -r test",
+    "typecheck": "pnpm -r typecheck"
   }
 }

package/templates/baselines/compose/.env.example

@@ -5,6 +5,20 @@
 # override .env values, so CI can set DB_URL via env without touching
 # this file.
 
+# ── Environment ────────────────────────────────────────────────────────
+#
+# DECLARE IT. Every `voltro db …` / `voltro migrate` invocation resolves an
+# UNSET `NODE_ENV` to `production` — the same way `voltro serve` and `voltro
+# start` do — so a bare `pnpm migrate` with no NODE_ENV refuses rather than
+# applying an un-reviewed diff to what might be a production database. It also
+# decides which `_voltro_*` bookkeeping tables the command declares, and a
+# migration command that resolves it differently from the serving process
+# declares a DIFFERENT schema.
+#
+# `voltro dev` declares `development` for itself and needs nothing from here;
+# this line is what makes the explicit schema commands work locally.
+NODE_ENV=development
+
 # Postgres connection — points at the postgres service in
 # docker-compose.yml (port 5433 to avoid clashing with a host pg on 5432).
 # When you run inside the docker network (dev:docker / prod:up), the

package/templates/baselines/compose/README.md

@@ -22,7 +22,7 @@ Two flavours: dev with volume-mounted HMR, prod with built images.
 
 ```sh
 pnpm db:up      # boot postgres only
-pnpm dev        # turbo run dev, native node, HMR <50ms
+pnpm dev        # pnpm -r --parallel dev, native node, HMR <50ms
 ```
 
 ### Daily dev — full-docker (slower HMR but zero host install)

package/templates/baselines/compose/baseline.json

@@ -29,15 +29,15 @@
     "docker-compose.prod.yml"
   ],
   "packageJsonScripts": {
-    "dev":             "turbo run dev",
-    "dev:hybrid":      "docker compose up -d --wait postgres && turbo run dev",
+    "dev":             "pnpm -r --parallel dev",
+    "dev:hybrid":      "docker compose up -d --wait postgres && pnpm -r --parallel dev",
     "dev:docker":      "HOST_UID=$(id -u) HOST_GID=$(id -g) docker compose -f docker-compose.dev.yml up",
     "dev:docker:bg":   "HOST_UID=$(id -u) HOST_GID=$(id -g) docker compose -f docker-compose.dev.yml up -d",
     "dev:docker:down": "docker compose -f docker-compose.dev.yml down",
     "dev:docker:logs": "docker compose -f docker-compose.dev.yml logs -f",
-    "build":           "turbo run build",
-    "test":            "turbo run test",
-    "typecheck":       "turbo run typecheck",
+    "build":           "pnpm -r build",
+    "test":            "pnpm -r test",
+    "typecheck":       "pnpm -r typecheck",
     "db:up":           "docker compose up -d --wait postgres",
     "db:down":         "docker compose stop postgres",
     "db:reset":        "docker compose down -v postgres && docker compose up -d --wait postgres",

package/templates/baselines/compose-mariadb/.env.example

@@ -4,6 +4,20 @@
 # boot. Shell exports always override .env values, so CI can set DB_URL
 # via env without touching this file.
 
+# ── Environment ────────────────────────────────────────────────────────
+#
+# DECLARE IT. Every `voltro db …` / `voltro migrate` invocation resolves an
+# UNSET `NODE_ENV` to `production` — the same way `voltro serve` and `voltro
+# start` do — so a bare `pnpm migrate` with no NODE_ENV refuses rather than
+# applying an un-reviewed diff to what might be a production database. It also
+# decides which `_voltro_*` bookkeeping tables the command declares, and a
+# migration command that resolves it differently from the serving process
+# declares a DIFFERENT schema.
+#
+# `voltro dev` declares `development` for itself and needs nothing from here;
+# this line is what makes the explicit schema commands work locally.
+NODE_ENV=development
+
 # MariaDB connection — points at the mariadb service in docker-compose.yml
 # (port 3307 to avoid clashing with a host MySQL on 3306). Inside the
 # docker network (dev:docker) the host is `mariadb`; native (pnpm dev with

package/templates/baselines/compose-mariadb/README.md

@@ -31,7 +31,7 @@ primitive; the `createbuckets` one-shot provisions the app bucket.
 
 ```sh
 pnpm db:up      # boot mariadb + minio (+ create the bucket)
-pnpm dev        # turbo run dev, native node, HMR <50ms
+pnpm dev        # pnpm -r --parallel dev, native node, HMR <50ms
 ```
 
 ### Daily dev — full-docker (slower HMR but zero host install)

package/templates/baselines/compose-mariadb/baseline.json

@@ -29,15 +29,15 @@
     "docker-compose.prod.yml"
   ],
   "packageJsonScripts": {
-    "dev":             "turbo run dev",
-    "dev:hybrid":      "docker compose up -d --wait mariadb minio && docker compose up -d createbuckets && turbo run dev",
+    "dev":             "pnpm -r --parallel dev",
+    "dev:hybrid":      "docker compose up -d --wait mariadb minio && docker compose up -d createbuckets && pnpm -r --parallel dev",
     "dev:docker":      "HOST_UID=$(id -u) HOST_GID=$(id -g) docker compose -f docker-compose.dev.yml up",
     "dev:docker:bg":   "HOST_UID=$(id -u) HOST_GID=$(id -g) docker compose -f docker-compose.dev.yml up -d",
     "dev:docker:down": "docker compose -f docker-compose.dev.yml down",
     "dev:docker:logs": "docker compose -f docker-compose.dev.yml logs -f",
-    "build":           "turbo run build",
-    "test":            "turbo run test",
-    "typecheck":       "turbo run typecheck",
+    "build":           "pnpm -r build",
+    "test":            "pnpm -r test",
+    "typecheck":       "pnpm -r typecheck",
     "db:up":           "docker compose up -d --wait mariadb minio && docker compose up -d createbuckets",
     "db:down":         "docker compose stop mariadb minio",
     "db:reset":        "docker compose down -v && docker compose up -d --wait mariadb minio && docker compose up -d createbuckets",

package/templates/baselines/helm/.env.example

@@ -6,6 +6,20 @@
 # In-cluster env values come from the Helm chart's ConfigMap +
 # Secret, NOT from this file. See charts/voltro-app/templates/.
 
+# ── Environment ────────────────────────────────────────────────────────
+#
+# DECLARE IT. Every `voltro db …` / `voltro migrate` invocation resolves an
+# UNSET `NODE_ENV` to `production` — the same way `voltro serve` and `voltro
+# start` do — so a bare `pnpm migrate` with no NODE_ENV refuses rather than
+# applying an un-reviewed diff to what might be a production database. It also
+# decides which `_voltro_*` bookkeeping tables the command declares, and a
+# migration command that resolves it differently from the serving process
+# declares a DIFFERENT schema.
+#
+# `voltro dev` declares `development` for itself and needs nothing from here;
+# this line is what makes the explicit schema commands work locally.
+NODE_ENV=development
+
 # Local Postgres (your install — or a docker run sidecar — or any
 # managed instance you can reach from your laptop).
 DB_URL=postgres://app:app@localhost:5432/{{projectName}}

package/templates/baselines/helm/baseline.json

@@ -39,10 +39,10 @@
     "deploy/README.md"
   ],
   "packageJsonScripts": {
-    "dev":              "turbo run dev",
-    "build":            "turbo run build",
-    "test":             "turbo run test",
-    "typecheck":        "turbo run typecheck",
+    "dev":              "pnpm -r --parallel dev",
+    "build":            "pnpm -r build",
+    "test":             "pnpm -r test",
+    "typecheck":        "pnpm -r typecheck",
     "helm:lint":        "helm lint charts/voltro-app",
     "helm:template:dev":   "helm template {{projectName}}-dev charts/voltro-app -f charts/voltro-app/values-dev.yaml",
     "helm:install:dev":    "helm upgrade --install {{projectName}}-dev charts/voltro-app -f charts/voltro-app/values-dev.yaml --namespace {{projectName}}-dev --create-namespace",

package/dist/apiBuild-C-x9YacA.js

@@ -1,2 +0,0 @@
-import { c as e, l as t } from "./apiBuild-h9VHtnlw.js";
-export { e as runApiBuild, t as runServeBundleBuild };

package/dist/checkCommand-DRovTKza.js

@@ -1,2 +0,0 @@
-import { r as e, t } from "./checkCommand-xGhRFFg2.js";
-export { t as offlineManifest, e as toInput };