@maestro-js/agent-skills 1.0.0-alpha.2 → 1.0.0-alpha.21

package/skills/maestro-examples/references/cadence/cadence-web/tests/organization/delete.spec.ts

@@ -0,0 +1,70 @@
+import { test, expect } from '@playwright/test'
+import { H } from '@cadence/services'
+import { TEST_CONSTANTS } from '../constants'
+
+test.use({ storageState: { cookies: [], origins: [] } })
+
+const deleteOrgId = 1300
+const deleteOrgSlug = 'delete-test-org'
+const deleteOrgName = 'Delete Test Org'
+const deleteEmail = 'delete-admin@cadence.example.com'
+
+const seedData = H.SeedPipe(
+  H.OrganizationSeed({
+    id: deleteOrgId,
+    name: deleteOrgName,
+    slug: deleteOrgSlug
+  }),
+  H.UserSeed({
+    id: 1300,
+    organizationId: deleteOrgId,
+    name: 'Delete Admin',
+    email: deleteEmail,
+    passwordHash: TEST_CONSTANTS.passwordHash,
+    role: 'admin'
+  })
+)
+
+test.beforeAll(async () => {
+  await seedData.setup()
+})
+
+test.afterAll(async () => {
+  // Best-effort cleanup in case the delete didn't succeed
+  try {
+    await seedData.teardown()
+  } catch {
+    // Ignore errors
+  }
+})
+
+test('admin can delete organization and is redirected to login', async ({ page }) => {
+  // Log in as admin of the fresh org
+  await page.goto('/auth/login')
+  await page.waitForLoadState('networkidle')
+  await page.getByLabel('Organization slug').fill(deleteOrgSlug)
+  await page.getByLabel('Email address').fill(deleteEmail)
+  await page.getByLabel('Password').fill(TEST_CONSTANTS.password)
+  await page.getByRole('button', { name: 'Sign in' }).click()
+  await page.waitForURL('/contacts')
+
+  // Navigate to settings
+  await page.goto('/settings')
+  await page.waitForLoadState('networkidle')
+
+  // Click delete, then confirm
+  await page.getByRole('button', { name: 'Delete', exact: true }).click()
+  await page.getByRole('button', { name: 'Yes, delete organization' }).click()
+
+  // Should redirect to login
+  await expect(page).toHaveURL(/\/auth\/login/)
+
+  // Try logging in with old credentials — should fail
+  await page.getByLabel('Organization slug').fill(deleteOrgSlug)
+  await page.getByLabel('Email address').fill(deleteEmail)
+  await page.getByLabel('Password').fill(TEST_CONSTANTS.password)
+  await page.getByRole('button', { name: 'Sign in' }).click()
+
+  await expect(page.getByText('Invalid credentials')).toBeVisible()
+  await expect(page).toHaveURL(/\/auth\/login/)
+})

package/skills/maestro-examples/references/cadence/cadence-web/tests/organization/edit-name.spec.ts

@@ -0,0 +1,51 @@
+import { test, expect } from '@playwright/test'
+import { H, Db } from '@cadence/services'
+import { TEST_CONSTANTS } from '../constants'
+
+const updatedName = `Updated Org ${Date.now()}`
+
+const seedData = H.SeedPipe(
+  H.OrganizationSeed({
+    id: TEST_CONSTANTS.orgId,
+    name: TEST_CONSTANTS.orgName,
+    slug: TEST_CONSTANTS.orgSlug
+  }),
+  H.UserSeed({
+    id: TEST_CONSTANTS.userId,
+    organizationId: TEST_CONSTANTS.orgId,
+    name: TEST_CONSTANTS.userName,
+    email: TEST_CONSTANTS.email,
+    passwordHash: TEST_CONSTANTS.passwordHash,
+    role: 'admin'
+  })
+)
+
+test.beforeAll(async () => {
+  await seedData.setup()
+})
+
+test.afterAll(async () => {
+  // Restore the original org name to avoid breaking other tests
+  await Db.update('UPDATE organizations SET name = ? WHERE id = ?', [TEST_CONSTANTS.orgName, TEST_CONSTANTS.orgId])
+  await seedData.teardown()
+})
+
+test('admin can edit org name on settings page', async ({ page }) => {
+  await page.goto('/settings')
+  await page.waitForLoadState('networkidle')
+
+  // Clear existing name and enter new one
+  await page.getByLabel('Organization name').clear()
+  await page.getByLabel('Organization name').fill(updatedName)
+  await page.getByRole('button', { name: 'Save changes' }).click()
+
+  // Should redirect back to settings with updated name
+  await page.waitForURL('/settings')
+  await page.waitForLoadState('networkidle')
+
+  // Settings page shows updated name in the input
+  await expect(page.getByLabel('Organization name')).toHaveValue(updatedName)
+
+  // Sidebar shows updated org name
+  await expect(page.getByText(updatedName)).toBeVisible()
+})

package/skills/maestro-examples/references/cadence/cadence-web/tests/users/change-role.spec.ts

@@ -0,0 +1,62 @@
+import { test, expect } from '@playwright/test'
+import { H } from '@cadence/services'
+import { TEST_CONSTANTS } from '../constants'
+
+const memberUserId = 8300
+
+const seedData = H.SeedPipe(
+  H.OrganizationSeed({
+    id: TEST_CONSTANTS.orgId,
+    name: TEST_CONSTANTS.orgName,
+    slug: TEST_CONSTANTS.orgSlug
+  }),
+  H.UserSeed({
+    id: TEST_CONSTANTS.userId,
+    organizationId: TEST_CONSTANTS.orgId,
+    name: TEST_CONSTANTS.userName,
+    email: TEST_CONSTANTS.email,
+    passwordHash: TEST_CONSTANTS.passwordHash,
+    role: 'admin'
+  }),
+  H.UserSeed({
+    id: memberUserId,
+    organizationId: TEST_CONSTANTS.orgId,
+    name: 'Member User',
+    email: 'member-role-test@example.com',
+    role: 'member'
+  })
+)
+
+test.beforeAll(async () => {
+  await seedData.setup()
+})
+
+test.afterAll(async () => {
+  await seedData.teardown()
+})
+
+test('admin can change a member role to viewer', async ({ page }) => {
+  await page.goto('/users')
+  await page.waitForLoadState('networkidle')
+
+  // Find the row containing the member user and click the role select
+  const memberRow = page.getByRole('row').filter({ hasText: 'Member User' })
+  await expect(memberRow).toBeVisible()
+
+  // Click the role select button in the member's row using keyboard to avoid pointer interception
+  const roleButton = memberRow.locator('button[aria-haspopup="listbox"]')
+  await roleButton.scrollIntoViewIfNeeded()
+  await roleButton.focus()
+  await page.keyboard.press('Space')
+
+  // Select "Viewer" from the dropdown
+  await page.getByRole('option', { name: 'Viewer' }).click()
+
+  // Should redirect back to /users with toast
+  await page.waitForURL('/users')
+  await expect(page.getByText('Role updated')).toBeVisible()
+
+  // Verify the role was updated by checking the select now shows Viewer
+  const updatedRow = page.getByRole('row').filter({ hasText: 'Member User' })
+  await expect(updatedRow.getByText('Viewer').first()).toBeVisible()
+})

package/skills/maestro-examples/references/cadence/cadence-web/tests/users/invite-user.spec.ts

@@ -0,0 +1,56 @@
+import { test, expect } from '@playwright/test'
+import { H, Db } from '@cadence/services'
+import { TEST_CONSTANTS } from '../constants'
+
+const seedData = H.SeedPipe(
+  H.OrganizationSeed({
+    id: TEST_CONSTANTS.orgId,
+    name: TEST_CONSTANTS.orgName,
+    slug: TEST_CONSTANTS.orgSlug
+  }),
+  H.UserSeed({
+    id: TEST_CONSTANTS.userId,
+    organizationId: TEST_CONSTANTS.orgId,
+    name: TEST_CONSTANTS.userName,
+    email: TEST_CONSTANTS.email,
+    passwordHash: TEST_CONSTANTS.passwordHash,
+    role: 'admin'
+  })
+)
+
+test.beforeAll(async () => {
+  // Clean up any leftover invited user from previous runs
+  await Db.update('DELETE FROM users WHERE email = ?', ['jane-invite-test@example.com'])
+  await seedData.setup()
+})
+
+test.afterAll(async () => {
+  // Clean up the invited user
+  await Db.update('DELETE FROM users WHERE email = ?', ['jane-invite-test@example.com'])
+  await seedData.teardown()
+})
+
+test('admin can invite a new user', async ({ page }) => {
+  await page.goto('/users')
+  await page.waitForLoadState('networkidle')
+
+  // Fill out the invite form
+  await page.getByRole('textbox', { name: 'Name' }).fill('Jane Smith')
+  await page.getByRole('textbox', { name: 'Email' }).fill('jane-invite-test@example.com')
+
+  // Role defaults to "member" - no need to change it
+
+  // Submit
+  await page.getByRole('button', { name: 'Send invite' }).click()
+
+  // Wait for the action to complete (toast appears after redirect)
+  await expect(page.getByText('User invited')).toBeVisible({ timeout: 15000 })
+
+  // Reload to ensure we see the latest data
+  await page.reload()
+  await page.waitForLoadState('networkidle')
+
+  // New user should appear in the list
+  await expect(page.getByText('Jane Smith')).toBeVisible()
+  await expect(page.getByText('jane-invite-test@example.com')).toBeVisible()
+})

package/skills/maestro-examples/references/cadence/cadence-web/tests/users/remove-user.spec.ts

@@ -0,0 +1,58 @@
+import { test, expect } from '@playwright/test'
+import { H } from '@cadence/services'
+import { TEST_CONSTANTS } from '../constants'
+
+const memberUserId = 8400
+
+const seedData = H.SeedPipe(
+  H.OrganizationSeed({
+    id: TEST_CONSTANTS.orgId,
+    name: TEST_CONSTANTS.orgName,
+    slug: TEST_CONSTANTS.orgSlug
+  }),
+  H.UserSeed({
+    id: TEST_CONSTANTS.userId,
+    organizationId: TEST_CONSTANTS.orgId,
+    name: TEST_CONSTANTS.userName,
+    email: TEST_CONSTANTS.email,
+    passwordHash: TEST_CONSTANTS.passwordHash,
+    role: 'admin'
+  }),
+  H.UserSeed({
+    id: memberUserId,
+    organizationId: TEST_CONSTANTS.orgId,
+    name: 'Removable User',
+    email: 'remove-test@example.com',
+    role: 'member'
+  })
+)
+
+test.beforeAll(async () => {
+  await seedData.setup()
+})
+
+test.afterAll(async () => {
+  await seedData.teardown()
+})
+
+test('admin can remove a user from the organization', async ({ page }) => {
+  await page.goto('/users')
+  await page.waitForLoadState('networkidle')
+
+  // Verify the user exists in the list
+  const userRow = page.getByRole('row').filter({ hasText: 'Removable User' })
+  await expect(userRow).toBeVisible()
+
+  // Click the Remove button in that row
+  await userRow.getByRole('button', { name: 'Remove' }).click()
+
+  // Wait for the action to complete (toast appears after redirect)
+  await expect(page.getByText('User removed')).toBeVisible({ timeout: 15000 })
+
+  // Reload to ensure we see the latest data
+  await page.reload()
+  await page.waitForLoadState('networkidle')
+
+  // The user should no longer be in the list
+  await expect(page.getByRole('row').filter({ hasText: 'Removable User' })).not.toBeVisible()
+})

package/skills/maestro-examples/references/cadence/cadence-web/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "extends": "../tsconfig.json",
+  "compilerOptions": {
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "types": ["vite/client"],
+    "rootDirs": [".", ".react-router/types"],
+    "paths": {
+      "~/*": ["./app/*"]
+    }
+  },
+  "include": [
+    "app",
+    "tests",
+    "vite.config.ts",
+    "react-router.config.ts",
+    ".react-router",
+    "./environment.d.ts",
+    "playwright.config.ts"
+  ]
+}

package/skills/maestro-examples/references/cadence/cadence-web/vite.config.ts

@@ -0,0 +1,37 @@
+import { reactRouter } from '@react-router/dev/vite'
+import { sentryReactRouter } from '@sentry/react-router'
+import tailwindcss from '@tailwindcss/vite'
+import { defineConfig } from 'vite'
+import { iconsSpritesheet } from 'vite-plugin-icons-spritesheet'
+import tsconfigPaths from 'vite-tsconfig-paths'
+import { envOnlyMacros } from 'vite-env-only'
+
+export default defineConfig((config) => ({
+  plugins: [
+    iconsSpritesheet({
+      inputDir: 'icons',
+      outputDir: 'app/icons',
+      fileName: 'sprite.svg',
+      withTypes: true,
+      typesOutputFile: 'app/icons/types.ts',
+      iconNameTransformer: (name) => name,
+      formatter: 'prettier'
+    }),
+    envOnlyMacros(),
+    tsconfigPaths(),
+    tailwindcss(),
+    reactRouter(),
+    sentryReactRouter(
+      {
+        org: process.env.SENTRY_ORG,
+        project: process.env.SENTRY_PROJECT,
+        authToken: process.env.SENTRY_AUTH_TOKEN
+      },
+      config
+    )
+  ],
+  server: {
+    port: 3005,
+    strictPort: true
+  }
+}))

package/skills/maestro-examples/references/cadence/config/agent-container.ts

@@ -0,0 +1,4 @@
+export default {
+  AGENT_NETWORK: 'cadence',
+  AGENT_SETUP: 'pnpm install && pnpm build-packages && pnpm install'
+}

package/skills/maestro-examples/references/cadence/config/cadence-web.ts

@@ -0,0 +1,12 @@
+import getServicesConfig from './services.ts'
+
+export default async function (env: Record<string, string | undefined>) {
+  const servicesConfig = await getServicesConfig(env)
+
+  return {
+    ...servicesConfig,
+    PORT: env.PORT ?? '3000',
+    SESSION_COOKIE_NAME: 'cadence_session',
+    SESSION_COOKIE_SECURE: servicesConfig.ENV_NAME !== 'local' ? 'true' : 'false'
+  }
+}

package/skills/maestro-examples/references/cadence/config/db-migrate.ts

@@ -0,0 +1,9 @@
+export default async function (env: Record<string, string | undefined>) {
+  return {
+    DB_HOST: env.DB_HOST ?? 'localhost',
+    DB_PORT: env.DB_PORT ?? '3306',
+    DB_USER: env.DB_USER ?? 'cadence',
+    DB_PASSWORD: env.DB_PASSWORD ?? '',
+    DB_DATABASE: env.DB_DATABASE ?? 'cadence'
+  }
+}

package/skills/maestro-examples/references/cadence/config/queue-processor.ts

@@ -0,0 +1,11 @@
+import getServicesConfig from './services.ts'
+
+export default async function (env: Record<string, string | undefined>) {
+  const servicesConfig = await getServicesConfig(env)
+
+  return {
+    ...servicesConfig,
+    QUEUE_CONCURRENCY: env.QUEUE_CONCURRENCY ?? '1',
+    QUEUE_POLL_INTERVAL: env.QUEUE_POLL_INTERVAL ?? '5000'
+  }
+}

package/skills/maestro-examples/references/cadence/config/services.ts

@@ -0,0 +1,16 @@
+export default async function (env: Record<string, string | undefined>) {
+  return {
+    DB_HOST: env.DB_HOST ?? 'localhost',
+    DB_PORT: env.DB_PORT ?? '3306',
+    DB_USER: env.DB_USER ?? 'cadence',
+    DB_PASSWORD: env.DB_PASSWORD ?? '',
+    DB_DATABASE: env.DB_DATABASE ?? 'cadence',
+    REDIS_URL: env.REDIS_URL ?? 'localhost',
+    REDIS_PORT: env.REDIS_PORT ?? '6379',
+    ENCRYPTION_KEY: env.ENCRYPTION_KEY,
+    HASH_KEY: env.HASH_KEY,
+    MAIL_FROM: env.MAIL_FROM ?? 'noreply@cadencecrm.app',
+    BASE_URL: env.BASE_URL ?? 'http://localhost:3000',
+    ENV_NAME: env.ENV_NAME ?? 'local'
+  }
+}

package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/20260404000001_organizations-and-users.ts

@@ -0,0 +1,16 @@
+import type { DbMigrations } from '@maestro-js/db-migrate'
+import { readFile } from 'node:fs/promises'
+import { join, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+
+export async function up(db: DbMigrations.Db) {
+  const sql = await readFile(join(__dirname, 'sqls', '20260404000001_organizations-and-users-up.sql'), 'utf-8')
+  await db.statement(sql)
+}
+
+export async function down(db: DbMigrations.Db) {
+  const sql = await readFile(join(__dirname, 'sqls', '20260404000001_organizations-and-users-down.sql'), 'utf-8')
+  await db.statement(sql)
+}

package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/20260404000002_contacts.ts

@@ -0,0 +1,16 @@
+import type { DbMigrations } from '@maestro-js/db-migrate'
+import { readFile } from 'node:fs/promises'
+import { join, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+
+export async function up(db: DbMigrations.Db) {
+  const sql = await readFile(join(__dirname, 'sqls', '20260404000002_contacts-up.sql'), 'utf-8')
+  await db.statement(sql)
+}
+
+export async function down(db: DbMigrations.Db) {
+  const sql = await readFile(join(__dirname, 'sqls', '20260404000002_contacts-down.sql'), 'utf-8')
+  await db.statement(sql)
+}

package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/20260404000003_interactions.ts

@@ -0,0 +1,16 @@
+import type { DbMigrations } from '@maestro-js/db-migrate'
+import { readFile } from 'node:fs/promises'
+import { join, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+
+export async function up(db: DbMigrations.Db) {
+  const sql = await readFile(join(__dirname, 'sqls', '20260404000003_interactions-up.sql'), 'utf-8')
+  await db.statement(sql)
+}
+
+export async function down(db: DbMigrations.Db) {
+  const sql = await readFile(join(__dirname, 'sqls', '20260404000003_interactions-down.sql'), 'utf-8')
+  await db.statement(sql)
+}

package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/20260404000004_remember-me-tokens.ts

@@ -0,0 +1,16 @@
+import type { DbMigrations } from '@maestro-js/db-migrate'
+import { readFile } from 'node:fs/promises'
+import { join, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+
+export async function up(db: DbMigrations.Db) {
+  const sql = await readFile(join(__dirname, 'sqls', '20260404000004_remember-me-tokens-up.sql'), 'utf-8')
+  await db.statement(sql)
+}
+
+export async function down(db: DbMigrations.Db) {
+  const sql = await readFile(join(__dirname, 'sqls', '20260404000004_remember-me-tokens-down.sql'), 'utf-8')
+  await db.statement(sql)
+}

package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/20260404000005_password-reset-tokens.ts

@@ -0,0 +1,16 @@
+import type { DbMigrations } from '@maestro-js/db-migrate'
+import { readFile } from 'node:fs/promises'
+import { join, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+
+export async function up(db: DbMigrations.Db) {
+  const sql = await readFile(join(__dirname, 'sqls', '20260404000005_password-reset-tokens-up.sql'), 'utf-8')
+  await db.statement(sql)
+}
+
+export async function down(db: DbMigrations.Db) {
+  const sql = await readFile(join(__dirname, 'sqls', '20260404000005_password-reset-tokens-down.sql'), 'utf-8')
+  await db.statement(sql)
+}

package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/20260404000006_queue-and-recurring-jobs.ts

@@ -0,0 +1,16 @@
+import type { DbMigrations } from '@maestro-js/db-migrate'
+import { readFile } from 'node:fs/promises'
+import { join, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+
+export async function up(db: DbMigrations.Db) {
+  const sql = await readFile(join(__dirname, 'sqls', '20260404000006_queue-and-recurring-jobs-up.sql'), 'utf-8')
+  await db.statement(sql)
+}
+
+export async function down(db: DbMigrations.Db) {
+  const sql = await readFile(join(__dirname, 'sqls', '20260404000006_queue-and-recurring-jobs-down.sql'), 'utf-8')
+  await db.statement(sql)
+}

package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000001_organizations-and-users-down.sql

@@ -0,0 +1,2 @@
+DROP TABLE IF EXISTS users;
+DROP TABLE IF EXISTS organizations;

package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000001_organizations-and-users-up.sql

@@ -0,0 +1,24 @@
+CREATE TABLE organizations (
+  id INT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY,
+  name VARCHAR(255) NOT NULL,
+  slug VARCHAR(100) NOT NULL,
+  deletedDate DATETIME(3),
+  createdDate DATETIME(3) NOT NULL,
+  lastModifiedDate DATETIME(3) NOT NULL,
+  UNIQUE KEY uq_organizations_slug (slug)
+);
+
+CREATE TABLE users (
+  id INT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY,
+  organizationId INT UNSIGNED NOT NULL,
+  name VARCHAR(255) NOT NULL,
+  email VARCHAR(255) NOT NULL,
+  passwordHash VARCHAR(255) NOT NULL,
+  role ENUM('admin', 'member', 'viewer') NOT NULL,
+  credentialsInvalidBefore DATETIME(3),
+  deletedDate DATETIME(3),
+  createdDate DATETIME(3) NOT NULL,
+  lastModifiedDate DATETIME(3) NOT NULL,
+  UNIQUE KEY uq_users_organizationId_email (organizationId, email),
+  CONSTRAINT fk_users_organizationId FOREIGN KEY (organizationId) REFERENCES organizations (id)
+);

package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000002_contacts-down.sql

@@ -0,0 +1 @@
+DROP TABLE IF EXISTS contacts;

package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000002_contacts-up.sql

@@ -0,0 +1,16 @@
+CREATE TABLE contacts (
+  id INT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY,
+  organizationId INT UNSIGNED NOT NULL,
+  firstName VARCHAR(255) NOT NULL,
+  lastName VARCHAR(255),
+  email VARCHAR(255),
+  phone VARCHAR(50),
+  jobTitle VARCHAR(255),
+  tags JSON NOT NULL,
+  archivedDate DATETIME(3),
+  deletedDate DATETIME(3),
+  createdDate DATETIME(3) NOT NULL,
+  lastModifiedDate DATETIME(3) NOT NULL,
+  INDEX ix_contacts_organizationId_deletedDate (organizationId, deletedDate),
+  CONSTRAINT fk_contacts_organizationId FOREIGN KEY (organizationId) REFERENCES organizations (id)
+);

package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000003_interactions-down.sql

@@ -0,0 +1 @@
+DROP TABLE interactions;

package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000003_interactions-up.sql

@@ -0,0 +1,15 @@
+CREATE TABLE interactions (
+  id INT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY,
+  contactId INT UNSIGNED NOT NULL,
+  userId INT UNSIGNED NOT NULL,
+  type ENUM('email', 'note') NOT NULL,
+  subject VARCHAR(255),
+  body TEXT NOT NULL,
+  date DATETIME(3) NOT NULL,
+  deletedDate DATETIME(3),
+  createdDate DATETIME(3) NOT NULL,
+  lastModifiedDate DATETIME(3) NOT NULL,
+  INDEX idx_interactions_contactId_deletedDate_date (contactId, deletedDate, date),
+  CONSTRAINT fk_interactions_contactId FOREIGN KEY (contactId) REFERENCES contacts (id),
+  CONSTRAINT fk_interactions_userId FOREIGN KEY (userId) REFERENCES users (id)
+);

package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000004_remember-me-tokens-down.sql

@@ -0,0 +1 @@
+DROP TABLE rememberMeTokens;

package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000004_remember-me-tokens-up.sql

@@ -0,0 +1,12 @@
+CREATE TABLE rememberMeTokens (
+  id INT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY,
+  userId INT UNSIGNED NOT NULL,
+  selector VARCHAR(32) NOT NULL,
+  verifierHash VARCHAR(255) NOT NULL,
+  deviceContext JSON,
+  expirationDate DATETIME(3),
+  rotatedDate DATETIME(3),
+  createdDate DATETIME(3) NOT NULL,
+  UNIQUE KEY uq_rememberMeTokens_selector (selector),
+  CONSTRAINT fk_rememberMeTokens_userId FOREIGN KEY (userId) REFERENCES users (id) ON DELETE CASCADE
+);

package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000005_password-reset-tokens-down.sql

@@ -0,0 +1 @@
+DROP TABLE passwordResetTokens;

package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000005_password-reset-tokens-up.sql

@@ -0,0 +1,11 @@
+CREATE TABLE passwordResetTokens (
+  id INT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY,
+  userId INT UNSIGNED NOT NULL,
+  selector VARCHAR(255) NOT NULL,
+  verifierHash VARCHAR(255) NOT NULL,
+  expirationDate DATETIME(3) NOT NULL,
+  createdDate DATETIME(3) NOT NULL,
+  UNIQUE KEY uq_passwordResetTokens_selector (selector),
+  INDEX ix_passwordResetTokens_userId (userId),
+  CONSTRAINT fk_passwordResetTokens_userId FOREIGN KEY (userId) REFERENCES users (id)
+);

package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000006_queue-and-recurring-jobs-down.sql

@@ -0,0 +1,2 @@
+DROP TABLE IF EXISTS recurringJobs;
+DROP TABLE IF EXISTS queueMessages;

package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000006_queue-and-recurring-jobs-up.sql

@@ -0,0 +1,21 @@
+CREATE TABLE queueMessages (
+  id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
+  attempt INT UNSIGNED NOT NULL DEFAULT 0,
+  queue VARCHAR(255) NOT NULL,
+  status ENUM('waiting', 'processing', 'succeeded', 'failed', 'failedPermanently') NOT NULL DEFAULT 'waiting',
+  scheduledDate DATETIME NOT NULL,
+  enqueuedDate DATETIME NOT NULL DEFAULT NOW(),
+  startedDate DATETIME,
+  completedDate DATETIME,
+  body JSON,
+  result TEXT,
+  lockId BIGINT UNSIGNED DEFAULT NULL,
+  PRIMARY KEY (id, attempt),
+  INDEX locking_pop (lockId, status, scheduledDate),
+  INDEX queue (queue)
+);
+
+CREATE TABLE recurringJobs (
+  name VARCHAR(255) NOT NULL PRIMARY KEY,
+  lastRunDate DATETIME DEFAULT NULL
+);