@stacksjs/defaults 0.70.370 → 0.70.375

package/ai/skills/stacks-mobile/SKILL.md

@@ -0,0 +1,154 @@
+---
+name: stacks-mobile
+description: Use when building native iOS or Android applications from a Stacks and STX codebase with Craft, including mobile configuration, native capabilities, safe areas, haptics, sharing, and mobile build output.
+license: MIT
+compatibility: Bun >= 1.3.0, TypeScript, Xcode for iOS project generation
+allowed-tools: Read Edit Write Bash Grep Glob
+---
+
+# Stacks Mobile
+
+Stacks mobile applications reuse the same STX views, components, routes, and
+API as the web application. Craft owns the platform project and native bridge;
+Stacks owns application configuration and build orchestration.
+
+## Key paths
+
+- App configuration: `config/mobile.ts`
+- Mobile runtime: `storage/framework/core/mobile/src/`
+- Platform build actions: `storage/framework/core/actions/src/build/ios.ts` and `build/android.ts`
+- Reusable STX components: `storage/framework/defaults/resources/components/Native*.stx`
+- Generated iOS project: `storage/framework/mobile/ios/` (ignored build output)
+
+## Build
+
+```bash
+buddy build:ios
+buddy build:android
+```
+
+The build validates `config/mobile.ts`, initializes a Craft iOS project,
+selects either a remote application URL or bundled web assets, generates the
+Xcode project with xcodegen, and records source, capability, and Craft builder
+revision provenance in `stacks-mobile.json`.
+
+For local Craft development, point Stacks at Craft's builder source:
+
+```bash
+CRAFT_IOS_SRC=/absolute/path/to/craft/packages/ios/src/index.ts buddy build:ios
+CRAFT_ANDROID_SRC=/absolute/path/to/craft/packages/android/src/index.ts buddy build:android
+```
+
+`STACKS_IOS_SKIP_XCODEGEN=1` and `STACKS_ANDROID_SKIP_GRADLE=1` are only for
+source-level CI and tests. Shippable projects must be generated and compiled
+with Xcode or Gradle respectively.
+
+## Configuration
+
+```ts
+import type { MobileConfig } from '@stacksjs/types'
+
+export default {
+  ios: {
+    appName: 'My App',
+    bundleId: 'com.example.app',
+    url: 'https://example.com',
+    fallbackWebAssets: 'dist',
+    deploymentTarget: '16.0',
+    orientations: ['portrait'],
+    urlSchemes: ['myapp'],
+    capabilities: {
+      haptics: true,
+      share: true,
+      geolocation: true,
+      secureStorage: true,
+    },
+  },
+  android: {
+    appName: 'My App',
+    packageName: 'com.example.app',
+    url: 'https://example.com',
+    fallbackWebAssets: 'dist',
+    capabilities: {
+      haptics: true,
+      share: true,
+      geolocation: true,
+      secureStorage: true,
+    },
+  },
+} satisfies MobileConfig
+```
+
+Choose exactly one primary content source:
+
+- `url`: load the deployed Stacks application and keep server-rendered routes.
+- `webAssets`: bundle a static distribution containing `index.html` and every
+  referenced asset.
+- `fallbackWebAssets`: with `url`, bundle a static distribution that Craft
+  loads when the remote application is unreachable on cold start.
+
+Only enable capabilities the product uses. Craft turns enabled capabilities
+into native bridge availability and required iOS privacy descriptions.
+
+## Runtime API
+
+```ts
+import { haptics, keepAwake, location, pushNotifications, share, withNativeFeedback } from '@stacksjs/mobile'
+
+await haptics.selection()
+const position = await location.getCurrentPosition({ enableHighAccuracy: true })
+await location.startRecording({ enableHighAccuracy: true })
+await keepAwake.enable()
+const pushToken = await pushNotifications.register()
+await share.share({ title: 'Route', url: 'https://example.com/routes/1' })
+await withNativeFeedback(() => saveActivity())
+```
+
+The runtime is browser-safe. Craft-backed operations use the native bridge;
+supported web APIs provide fallback behavior outside a native host.
+
+## STX components
+
+- `<NativeAppShell>` applies iOS safe-area insets and reserves tab-bar space.
+- `<NativeTabBar>` provides the accessible navigation shell and selection haptics.
+- `<NativeTabItem>` provides each route, active state, label, and Iconify icon.
+- `<NativeShareButton>` opens the native share sheet and reports feedback.
+- `<NativeNetworkBanner>` reflects native connectivity changes and announces offline state accessibly.
+- `<NativePermissionButton>` wraps permission status, requests, haptics, and the native Settings escape hatch.
+- `<NativeHealthButton>` requests the minimal Apple Health or Android Health Connect grants.
+
+Use Iconify classes for tab icons. Keep native operations inside reusable
+components or TypeScript composables, never through `window.*` in an STX
+script.
+
+## Health and watch surfaces
+
+Enable `healthKit` on iOS or `healthConnect` on Android, then use the shared
+`health` service to request only the record types the product needs. Completed
+recordings can be written back with `health.saveWorkout(...)`; treat permission
+revocation as a normal runtime state and never block saving the application's
+own activity when a health write fails.
+
+Enable `watchApp` to generate and embed the SwiftUI watchOS companion. The
+shared `watchConnectivity` service exchanges commands and the latest recording
+context without exposing `WCSession` to STX templates. Set
+`ios.watchDeploymentTarget` when the default watchOS 9.0 target is not suitable.
+
+## Validation
+
+Before finishing mobile work:
+
+```bash
+buddy lint
+bun run typecheck:app
+buddy test
+buddy build:ios
+buddy build:android
+```
+
+On a Mac with full Xcode selected, compile the generated project for an iOS
+Simulator (including embedded extensions and watchOS dependencies) and a
+physical-device archive. Compile the Android project with Gradle when Android is
+configured. Verify permission prompts, safe-area
+layout, deep links, offline/error states, background transitions, and native
+feedback on device.

package/ai/skills/stacks-new-feature/SKILL.md

@@ -50,7 +50,7 @@ export default defineModel({
     title: {
       fillable: true,
       required: true,
-      validation: { rule: schema.string().maxLength(200) },
+      validation: { rule: schema.string().max(200) },
       factory: (faker) => faker.lorem.sentence()
     },
     content: {

package/ai/skills/stacks-orm/SKILL.md

@@ -104,8 +104,8 @@ export default defineModel({
       required: true,
       unique: false,
       validation: {
-        rule: schema.string().maxLength(100),
-        message: { maxLength: 'Name is too long' }
+        rule: schema.string().max(100),
+        message: { max: 'Name is too long' }
       },
       factory: (faker) => faker.lorem.word()
     },

package/ai/skills/stacks-validation/SKILL.md

@@ -121,8 +121,8 @@ import { schema } from '@stacksjs/validation'
 ```typescript
 // String types
 schema.string()                    // StringValidatorType
-schema.string().minLength(2)       // chain: min length
-schema.string().maxLength(100)     // chain: max length
+schema.string().min(2)             // chain: min length
+schema.string().max(100)           // chain: max length
 schema.string().email()            // chain: must be email
 schema.string().url()              // chain: must be URL
 schema.string().matches(/pattern/) // chain: regex match
@@ -189,10 +189,10 @@ export default defineModel({
   attributes: {
     name: {
       validation: {
-        rule: schema.string().minLength(2).maxLength(100),
+        rule: schema.string().min(2).max(100),
         message: {
-          minLength: 'Name must be at least 2 characters',
-          maxLength: 'Name cannot exceed 100 characters',
+          min: 'Name must be at least 2 characters',
+          max: 'Name cannot exceed 100 characters',
         }
       }
     },
@@ -226,9 +226,9 @@ export default defineModel({
 
     bio: {
       validation: {
-        rule: schema.string().maxLength(500),
+        rule: schema.string().max(500),
         message: {
-          maxLength: 'Bio cannot exceed 500 characters',
+          max: 'Bio cannot exceed 500 characters',
         }
       }
     },

package/ide/vscode/package.json

@@ -2,7 +2,7 @@
   "publisher": "Stacks",
   "name": "vscode-stacks",
   "displayName": "Stacks",
-  "version": "0.70.370",
+  "version": "0.70.375",
   "description": "A modern Stacks development environment.",
   "license": "MIT",
   "funding": "https://github.com/sponsors/chrisbbreuer",

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/defaults",
   "type": "module",
   "sideEffects": false,
-  "version": "0.70.370",
+  "version": "0.70.375",
   "description": "The complete managed Stacks application scaffold, including runtime defaults, AI guidance, editor metadata, and npm-backed project support files.",
   "author": "Chris Breuer",
   "license": "MIT",
@@ -46,6 +46,7 @@
   "dependencies": {
     "@iconify-json/f7": "^1.2.2",
     "@iconify-json/hugeicons": "^1.2.27",
+    "@stacksjs/mobile": "^0.70.375",
     "@stacksjs/sanitizer": "^0.2.113"
   },
   "scripts": {

package/resources/components/NativeAppShell.stx

@@ -0,0 +1,75 @@
+<script>
+interface NativeAppShellProps {
+  class?: string
+  tabBar?: boolean
+}
+
+const { tabBar = false } = defineProps<NativeAppShellProps>()
+</script>
+
+<script client>
+const className = useReactiveProp<string>('class', '')
+</script>
+
+<div data-native-app-shell class="native-app-shell" :class="className()">
+  <main class="native-app-content">
+    <slot />
+  </main>
+  @if(tabBar)
+    <footer class="native-app-tab-slot">
+      <slot name="tab-bar" />
+    </footer>
+  @endif
+</div>
+
+<style>
+  .native-app-shell {
+    --native-safe-area-top: env(safe-area-inset-top, 0px);
+    --native-safe-area-right: env(safe-area-inset-right, 0px);
+    --native-safe-area-bottom: env(safe-area-inset-bottom, 0px);
+    --native-safe-area-left: env(safe-area-inset-left, 0px);
+
+    min-height: 100dvh;
+    color: inherit;
+    background: inherit;
+    padding-top: var(--native-safe-area-top);
+    padding-right: var(--native-safe-area-right);
+    padding-left: var(--native-safe-area-left);
+  }
+
+  .native-app-shell::before {
+    content: '';
+    position: fixed;
+    top: 0;
+    right: 0;
+    left: 0;
+    z-index: 35;
+    height: var(--native-safe-area-top);
+    pointer-events: none;
+    background: var(--native-safe-area-background, Canvas);
+  }
+
+  .native-app-content {
+    min-height: calc(100dvh - var(--native-safe-area-top));
+    padding-bottom: var(--native-safe-area-bottom);
+  }
+
+  .native-app-shell:has(.native-app-tab-slot) .native-app-content {
+    padding-bottom: calc(5rem + var(--native-safe-area-bottom));
+  }
+
+  .native-app-sticky-top {
+    top: var(--native-safe-area-top);
+  }
+
+  .native-app-tab-slot {
+    position: fixed;
+    right: 0;
+    bottom: 0;
+    left: 0;
+    z-index: 30;
+    padding-right: var(--native-safe-area-right);
+    padding-bottom: var(--native-safe-area-bottom);
+    padding-left: var(--native-safe-area-left);
+  }
+</style>

package/resources/components/NativeHealthButton.stx

@@ -0,0 +1,49 @@
+<script client>
+import type { HealthDataType } from '@stacksjs/mobile'
+import { device, haptics, health, isNativeMobile } from '@stacksjs/mobile'
+
+const types = useReactiveProp<HealthDataType[]>('types', ['steps', 'distance', 'activeEnergy', 'heartRate', 'workouts'])
+const className = useReactiveProp<string>('class', 'inline-flex min-h-11 items-center justify-center gap-2 rounded-xl px-4 text-sm font-semibold')
+const status = state<'idle' | 'requesting' | 'connected' | 'denied' | 'unavailable' | 'error'>('idle')
+const emit = defineEmits()
+
+const provider = derived(() => device.isIOS() ? 'Apple Health' : device.isAndroid() ? 'Health Connect' : 'Health')
+const buttonLabel = derived(() => {
+  if (status() === 'requesting') return `Connecting ${provider()}`
+  if (status() === 'connected') return `${provider()} connected`
+  if (status() === 'unavailable') return `${provider()} unavailable`
+  return `Connect ${provider()}`
+})
+
+async function connectHealth(): Promise<void> {
+  if (!isNativeMobile()) {
+    status.set('unavailable')
+    return
+  }
+  if (status() === 'requesting' || status() === 'connected') return
+  status.set('requesting')
+  await haptics.selection()
+  try {
+    const allowed = await health.requestAuthorization(types())
+    status.set(allowed ? 'connected' : 'denied')
+    emit('change', { connected: allowed, provider: provider() })
+    await haptics.notification(allowed ? 'success' : 'warning')
+  }
+  catch (error) {
+    status.set('error')
+    emit('error', error)
+    await haptics.notification('error')
+  }
+}
+</script>
+
+<button
+  type="button"
+  :class="className()"
+  :disabled="status() === 'requesting' || status() === 'connected' || status() === 'unavailable'"
+  :aria-busy="status() === 'requesting' ? 'true' : 'false'"
+  @click="connectHealth()"
+>
+  <i aria-hidden="true" class="h-5 w-5 i-hugeicons-health"></i>
+  <span>{{ buttonLabel() }}</span>
+</button>

package/resources/components/NativeNetworkBanner.stx

@@ -0,0 +1,53 @@
+<script client>
+import { network } from '@stacksjs/mobile'
+import { onDestroy, onMount } from 'stx'
+
+const className = useReactiveProp<string>('class', '')
+const offlineLabel = useReactiveProp<string>('offlineLabel', 'You are offline. Changes will sync automatically.')
+const connected = state(true)
+let removeListener: (() => void) | null = null
+
+function applyStatus(status: { isConnected: boolean }): void {
+  connected.set(status.isConnected)
+}
+
+onMount(() => {
+  void network.getStatus().then(applyStatus).catch(() => connected.set(false))
+  removeListener = network.onChange(applyStatus)
+})
+
+onDestroy(() => removeListener?.())
+</script>
+
+<div
+  :if="!connected()"
+  role="status"
+  aria-live="polite"
+  class="native-network-banner"
+  :class="className()"
+>
+  <i aria-hidden="true" class="h-4 w-4 i-hugeicons-wifi-disconnected-01"></i>
+  <span>{{ offlineLabel() }}</span>
+</div>
+
+<style>
+  .native-network-banner {
+    position: sticky;
+    top: env(safe-area-inset-top, 0px);
+    z-index: 50;
+    display: flex;
+    gap: 0.5rem;
+    align-items: center;
+    justify-content: center;
+    min-height: 2.75rem;
+    padding: 0.625rem 1rem;
+    color: rgb(120 53 15);
+    background: rgb(254 243 199 / 0.96);
+    font-size: 0.8125rem;
+    font-weight: 600;
+  }
+
+  @media (prefers-color-scheme: dark) {
+    .native-network-banner { color: rgb(254 243 199); background: rgb(120 53 15 / 0.96); }
+  }
+</style>

package/resources/components/NativePermissionButton.stx

@@ -0,0 +1,61 @@
+<script client>
+import type { PermissionStatus, PermissionType } from '@stacksjs/mobile'
+import { haptics, permissions } from '@stacksjs/mobile'
+import { onMount } from 'stx'
+
+const permission = useReactiveProp<PermissionType>('permission', 'location')
+const label = useReactiveProp<string>('label', 'Allow access')
+const grantedLabel = useReactiveProp<string>('grantedLabel', 'Access allowed')
+const className = useReactiveProp<string>('class', 'inline-flex min-h-11 items-center justify-center gap-2 rounded-xl px-4 text-sm font-semibold')
+const status = state<PermissionStatus>('undetermined')
+const busy = state(false)
+const emit = defineEmits()
+
+onMount(() => {
+  void permissions.check(permission()).then(status.set).catch(() => status.set('undetermined'))
+})
+
+async function requestAccess(): Promise<void> {
+  if (busy() || status() === 'granted') return
+  busy.set(true)
+  await haptics.selection()
+  try {
+    const next = await permissions.request(permission())
+    status.set(next)
+    emit('change', next)
+    await haptics.notification(next === 'granted' ? 'success' : 'warning')
+  }
+  catch (error) {
+    emit('error', error)
+    await haptics.notification('error')
+  }
+  finally {
+    busy.set(false)
+  }
+}
+
+async function openNativeSettings(): Promise<void> {
+  await permissions.openSettings()
+}
+</script>
+
+<div class="inline-flex flex-col gap-2">
+  <button
+    type="button"
+    :class="className()"
+    :disabled="busy() || status() === 'granted'"
+    :aria-busy="busy() ? 'true' : 'false'"
+    @click="requestAccess()"
+  >
+    <i aria-hidden="true" :class="status() === 'granted' ? 'i-hugeicons-checkmark-circle-02' : 'i-hugeicons-shield-01'" class="h-5 w-5"></i>
+    <span>{{ busy() ? 'Requesting access' : status() === 'granted' ? grantedLabel() : label() }}</span>
+  </button>
+  <button
+    :if="status() === 'denied' || status() === 'restricted'"
+    type="button"
+    class="min-h-11 text-sm underline underline-offset-4"
+    @click="openNativeSettings()"
+  >
+    Open device settings
+  </button>
+</div>

package/resources/components/NativeShareButton.stx

@@ -0,0 +1,35 @@
+<script client>
+import { haptics, share } from '@stacksjs/mobile'
+
+const title = useReactiveProp<string | undefined>('title', undefined)
+const text = useReactiveProp<string | undefined>('text', undefined)
+const url = useReactiveProp<string | undefined>('url', undefined)
+const className = useReactiveProp<string>('class', 'inline-flex gap-2 items-center justify-center min-h-11 px-4 font-semibold text-sm rounded-xl')
+const label = useReactiveProp<string>('label', 'Share')
+const status = state<'idle' | 'sharing' | 'shared' | 'error'>('idle')
+
+async function openShareSheet(): Promise<void> {
+  if (status() === 'sharing') return
+  status.set('sharing')
+  await haptics.impact('light')
+  try {
+    await share.share({ title: title(), text: text(), url: url() })
+    status.set('shared')
+    await haptics.notification('success')
+  }
+  catch {
+    status.set('error')
+    await haptics.notification('error')
+  }
+}
+</script>
+
+<button
+  type="button"
+  :class="className()"
+  :aria-busy="status() === 'sharing' ? 'true' : 'false'"
+  @click="openShareSheet()"
+>
+  <i aria-hidden="true" class="h-5 w-5 i-hugeicons-share-08"></i>
+  <span>{{ status() === 'sharing' ? 'Sharing' : label() }}</span>
+</button>

package/resources/components/NativeTabBar.stx

@@ -0,0 +1,74 @@
+<script>
+interface NativeTabBarProps {
+  label?: string
+}
+
+const { label = 'App navigation' } = defineProps<NativeTabBarProps>()
+</script>
+
+<script client>
+import { haptics } from '@stacksjs/mobile'
+
+function selectTab(): void {
+  void haptics.selection()
+}
+</script>
+
+<nav aria-label="{{ label }}" class="native-tab-bar" @click="selectTab()">
+  <slot />
+</nav>
+
+<style>
+  .native-tab-bar {
+    display: grid;
+    grid-auto-flow: column;
+    grid-auto-columns: 1fr;
+    min-height: 4.5rem;
+    border-top: 1px solid rgb(148 163 184 / 0.22);
+    background: rgb(255 255 255 / 0.9);
+    backdrop-filter: blur(24px) saturate(160%);
+    -webkit-backdrop-filter: blur(24px) saturate(160%);
+  }
+
+  .native-tab-item {
+    display: flex;
+    flex-direction: column;
+    gap: 0.2rem;
+    align-items: center;
+    justify-content: center;
+    min-width: 2.75rem;
+    color: rgb(100 116 139);
+    font-size: 0.6875rem;
+    font-weight: 600;
+    line-height: 1;
+    text-decoration: none;
+    transition: color 150ms ease, transform 150ms ease;
+    -webkit-tap-highlight-color: transparent;
+  }
+
+  .native-tab-item:active { transform: scale(0.96); }
+  .native-tab-item.is-active { color: rgb(5 150 105); }
+  .native-tab-icon { width: 1.35rem; height: 1.35rem; }
+
+  .dark .native-tab-bar {
+    border-color: rgb(71 85 105 / 0.55);
+    background: rgb(15 23 42 / 0.9);
+  }
+
+  .dark .native-tab-item { color: rgb(148 163 184); }
+  .dark .native-tab-item.is-active { color: rgb(52 211 153); }
+
+  @media (prefers-reduced-transparency: reduce) {
+    .native-tab-bar {
+      background: rgb(255 255 255);
+      backdrop-filter: none;
+      -webkit-backdrop-filter: none;
+    }
+
+    .dark .native-tab-bar { background: rgb(15 23 42); }
+  }
+
+  @media (prefers-reduced-motion: reduce) {
+    .native-tab-item { transition: none; }
+  }
+</style>

package/resources/components/NativeTabItem.stx

@@ -0,0 +1,19 @@
+<script>
+interface NativeTabItemProps {
+  label: string
+  href: string
+  icon: string
+}
+
+const { href, icon, label } = defineProps<NativeTabItemProps>()
+</script>
+
+<StxLink
+  to="{{ href }}"
+  aria-label="{{ label }}"
+  activeClass="is-active"
+  class="native-tab-item"
+>
+  <i aria-hidden="true" class="{{ icon }} native-tab-icon"></i>
+  <span>{{ label }}</span>
+</StxLink>

package/resources/components/index.ts

@@ -12,4 +12,11 @@ export { default as DashboardNavbar } from './Dashboard/Navbar.stx'
 export * from './Dashboard'
 export { default as Audio } from './Audio.stx'
 export { default as Image } from './Image.stx'
+export { default as NativeAppShell } from './NativeAppShell.stx'
+export { default as NativeHealthButton } from './NativeHealthButton.stx'
+export { default as NativeNetworkBanner } from './NativeNetworkBanner.stx'
+export { default as NativePermissionButton } from './NativePermissionButton.stx'
+export { default as NativeShareButton } from './NativeShareButton.stx'
+export { default as NativeTabBar } from './NativeTabBar.stx'
+export { default as NativeTabItem } from './NativeTabItem.stx'
 export { default as Video } from './Video.stx'

package/vcs/github/labeler.yml

@@ -0,0 +1,150 @@
+# actions/labeler@v6 format (structured match rules).
+# Each label maps to changed-files > any-glob-to-any-file.
+#
+# Scoped to the paths an application actually owns. The framework's own
+# labeler carries a label per internal package; in an app those are installed
+# dependencies, not code under review.
+
+app:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'app/**'
+
+actions:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'app/Actions/**'
+
+commands:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'app/Commands/**'
+
+events:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'app/Events/**'
+          - 'app/Listeners/**'
+          - 'app/Events.ts'
+          - 'app/Listener.ts'
+
+jobs:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'app/Jobs/**'
+
+mail:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'app/Mail/**'
+
+middleware:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'app/Middleware/**'
+          - 'app/Middleware.ts'
+
+models:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'app/Models/**'
+
+notifications:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'app/Notifications/**'
+
+config:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'config/**'
+
+database:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'database/**'
+
+migrations:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'database/migrations/**'
+
+resources:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'resources/**'
+
+components:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'resources/components/**'
+
+views:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'resources/views/**'
+          - 'resources/layouts/**'
+          - 'resources/partials/**'
+
+functions:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'resources/functions/**'
+
+stores:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'resources/stores/**'
+
+lang:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'resources/lang/**'
+          - 'locales/**'
+
+routes:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'routes/**'
+          - 'app/Routes.ts'
+
+tests:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'tests/**'
+
+docs:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'docs/**'
+          - 'config/docs.ts'
+          - '**/*.md'
+
+content:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'content/**'
+
+public:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'public/**'
+
+cloud:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'cloud/**'
+          - 'config/cloud.ts'
+
+deps:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'package.json'
+          - 'bun.lock'
+          - 'deps.yml'
+          - 'pantry.lock'
+
+ci:
+  - changed-files:
+      - any-glob-to-any-file:
+          - '.github/**'

package/vcs/github/workflows/ci.yml

@@ -110,5 +110,12 @@ jobs:
       - name: Set Application Key
         run: bun buddy key:generate
 
+      # Feature tests query real tables, and a fresh checkout has no database
+      # file at all: it is gitignored, being machine-local state. Without this
+      # the suite fails in beforeAll with "no such table", which reads like a
+      # broken test rather than a missing schema.
+      - name: Migrate the database
+        run: bun buddy migrate
+
       - name: Test Suite
         run: bun run test

package/vcs/github/workflows/labeler.yml

@@ -10,4 +10,4 @@ jobs:
       pull-requests: write
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/labeler@v4
+      - uses: actions/labeler@v6