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

package/skills/maestro-examples/references/chorus/chorus-web/tests/signup-validation.test.ts

@@ -0,0 +1,51 @@
+import { test, expect } from '@playwright/test'
+import { H } from '@chorus/services'
+import { TEST_CONSTANTS } from './constants'
+
+test.use({ storageState: { cookies: [], origins: [] } })
+
+const seedData = H.SeedPipe(
+  H.ProfileSeed({
+    profileId: 1200,
+    email: 'duplicate@example.com',
+    passwordHash: TEST_CONSTANTS.passwordHash
+  })
+)
+
+test.beforeAll(async () => {
+  await seedData.setup()
+})
+
+test.afterAll(async () => {
+  await seedData.teardown()
+})
+
+test('password mismatch shows error', async ({ page }) => {
+  await page.goto('/signup')
+  await page.waitForLoadState('networkidle')
+  await page.getByLabel('Email').fill('mismatch@example.com')
+  await page.getByLabel('Password', { exact: true }).fill('password123')
+  await page.getByLabel('Confirm password').fill('different456')
+  await page.getByRole('button', { name: 'Sign up' }).click()
+  await expect(page.getByText(/passwords must match/i)).toBeVisible()
+})
+
+test('short password shows error', async ({ page }) => {
+  await page.goto('/signup')
+  await page.waitForLoadState('networkidle')
+  await page.getByLabel('Email').fill('short@example.com')
+  await page.getByLabel('Password', { exact: true }).fill('abc')
+  await page.getByLabel('Confirm password').fill('abc')
+  await page.getByRole('button', { name: 'Sign up' }).click()
+  await expect(page.getByText(/password is too short/i).first()).toBeVisible()
+})
+
+test('duplicate email shows error', async ({ page }) => {
+  await page.goto('/signup')
+  await page.waitForLoadState('networkidle')
+  await page.getByLabel('Email').fill('duplicate@example.com')
+  await page.getByLabel('Password', { exact: true }).fill('password123')
+  await page.getByLabel('Confirm password').fill('password123')
+  await page.getByRole('button', { name: 'Sign up' }).click()
+  await expect(page.getByText(/already exists/i)).toBeVisible()
+})

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

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

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

@@ -0,0 +1,38 @@
+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: [
+    envOnlyMacros(),
+    tsconfigPaths(),
+    tailwindcss(),
+    reactRouter(),
+    sentryReactRouter(
+      {
+        org: process.env.SENTRY_ORG,
+        project: process.env.SENTRY_PROJECT,
+        authToken: process.env.SENTRY_AUTH_TOKEN
+      },
+      config
+    ),
+    iconsSpritesheet({
+      inputDir: './other/svg-icons',
+      outputDir: './app/icons',
+      fileName: 'sprite.svg',
+      withTypes: true,
+      iconNameTransformer: (name) => name
+    })
+  ],
+  server: {
+    port: 3001,
+    strictPort: true
+  },
+  ssr: {
+    noExternal: ['react-pdf-hook']
+  }
+}))

package/skills/maestro-examples/references/chorus/config/app-a.ts

@@ -0,0 +1,7 @@
+export default async function (env: Record<string, string | undefined>) {
+  await new Promise((r) => setTimeout(r, 1000))
+
+  return {
+    FOO: 'BAR'
+  }
+}

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

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

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

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

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

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

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

@@ -0,0 +1,15 @@
+export default async function (env: Record<string, string | undefined>) {
+  return {
+    DB_HOSTNAME: env.DB_HOSTNAME,
+    DB_USER: env.DB_USER,
+    DB_PASSWORD: env.DB_PASSWORD,
+    DB_DATABASE: env.DB_DATABASE,
+    DB_PORT: env.DB_PORT,
+    CRYPT_KEY: env.CRYPT_KEY,
+    HASH_KEY: env.HASH_KEY,
+    ENV_NAME: env.ENV_NAME ?? 'local',
+    AWS_REGION: 'us-east-1',
+    SENTRY_DSN: env.SENTRY_DSN ?? '',
+    VITE_SENTRY_DSN: env.SENTRY_DSN ?? ''
+  }
+}

package/skills/maestro-examples/references/chorus/infrastructure/cdk/index.ts

@@ -0,0 +1,60 @@
+import * as path from 'path'
+import { App, Stack } from 'aws-cdk-lib'
+import { AuroraMysqlEngineVersion } from 'aws-cdk-lib/aws-rds'
+import {
+  AuroraDatabase,
+  Cluster,
+  Email,
+  ReactRouterEcrImage,
+  ReactRouterSsrSiteLambda,
+  ReactRouterSsrSiteEcsFargateService,
+  Vpc
+} from '@maestro-js/aws-cdk-recipes'
+
+const app = new App()
+const stack = new Stack(app, 'Sandbox')
+
+const network = new Vpc(stack, 'Network', {
+  natGateways: 'single',
+  wireguard: true
+})
+
+const db = new AuroraDatabase(stack, 'Database', {
+  engine: 'mysql',
+  version: AuroraMysqlEngineVersion.VER_3_08_0,
+  database: 'sandbox',
+  scaling: { pauseAfter: '5 minutes' },
+  deletionProtection: false,
+  vpc: network.vpc
+})
+
+db.connections.allowDefaultPortFrom(network.securityGroup, 'WireGuard VPN access')
+
+new Email(stack, 'Email', {
+  sender: 'maestro@marcatopartners.com',
+  configurationSetName: 'sandbox'
+})
+
+// new StaticSite(stack, 'MyStaticApp', {
+//   path: path.join(import.meta.dirname, '../../my-static-app/build/client')
+// })
+
+new ReactRouterSsrSiteLambda(stack, 'MySsrAppLambda', {
+  path: path.join(import.meta.dirname, '../../chorus-web'),
+  vpc: network
+})
+
+// const cluster = new Cluster(stack, 'Cluster', {
+//   vpc: network.vpc
+// })
+
+// const image = new ReactRouterEcrImage(stack, 'MySsrAppImage', {
+//   path: path.join(import.meta.dirname, '../../chorus-web')
+// })
+
+// new ReactRouterSsrSiteEcsFargateService(stack, 'MySsrAppEcs', {
+//   path: path.join(import.meta.dirname, '../../chorus-web'),
+//   cluster: cluster.cluster,
+//   image: image.asset,
+//   healthCheck: { path: '/health' }
+// })

package/skills/maestro-examples/references/chorus/infrastructure/cdk.context.json

@@ -0,0 +1,5 @@
+{
+  "acknowledged-issue-numbers": [
+    34892
+  ]
+}

package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/20260303005902_init_authentication.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', '20260303005902_init_authentication-up.sql'), 'utf-8')
+  await db.statement(sql)
+}
+
+export async function down(db: DbMigrations.Db) {
+  const sql = await readFile(join(__dirname, 'sqls', '20260303005902_init_authentication-down.sql'), 'utf-8')
+  await db.statement(sql)
+}

package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/20260308234835_add-maestro-queue-table.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', '20260308234835_add-maestro-queue-table-up.sql'), 'utf-8')
+  await db.statement(sql)
+}
+
+export async function down(db: DbMigrations.Db) {
+  const sql = await readFile(join(__dirname, 'sqls', '20260308234835_add-maestro-queue-table-down.sql'), 'utf-8')
+  await db.statement(sql)
+}

package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/20260315051819_channels.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', '20260315051819_channels-up.sql'), 'utf-8')
+  await db.statement(sql)
+}
+
+export async function down(db: DbMigrations.Db) {
+  const sql = await readFile(join(__dirname, 'sqls', '20260315051819_channels-down.sql'), 'utf-8')
+  await db.statement(sql)
+}

package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/20260315052202_channel-moderators.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', '20260315052202_channel-moderators-up.sql'), 'utf-8')
+  await db.statement(sql)
+}
+
+export async function down(db: DbMigrations.Db) {
+  const sql = await readFile(join(__dirname, 'sqls', '20260315052202_channel-moderators-down.sql'), 'utf-8')
+  await db.statement(sql)
+}

package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/20260315052539_posts.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', '20260315052539_posts-up.sql'), 'utf-8')
+  await db.statement(sql)
+}
+
+export async function down(db: DbMigrations.Db) {
+  const sql = await readFile(join(__dirname, 'sqls', '20260315052539_posts-down.sql'), 'utf-8')
+  await db.statement(sql)
+}

package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/20260315052734_post-images.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', '20260315052734_post-images-up.sql'), 'utf-8')
+  await db.statement(sql)
+}
+
+export async function down(db: DbMigrations.Db) {
+  const sql = await readFile(join(__dirname, 'sqls', '20260315052734_post-images-down.sql'), 'utf-8')
+  await db.statement(sql)
+}

package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/20260315053110_likes.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', '20260315053110_likes-up.sql'), 'utf-8')
+  await db.statement(sql)
+}
+
+export async function down(db: DbMigrations.Db) {
+  const sql = await readFile(join(__dirname, 'sqls', '20260315053110_likes-down.sql'), 'utf-8')
+  await db.statement(sql)
+}

package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260303005902_init_authentication-down.sql

@@ -0,0 +1,3 @@
+DROP TABLE IF EXISTS rememberMeTokens;
+
+DROP TABLE IF EXISTS users;

package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260303005902_init_authentication-up.sql

@@ -0,0 +1,40 @@
+CREATE TABLE
+  `profiles` (
+    profileId INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
+    email VARCHAR(255) NOT NULL,
+    username VARCHAR(50) NOT NULL,
+    profileImage VARCHAR(500) NOT NULL,
+    passwordHash VARCHAR(255) NOT NULL,
+    credentialsInvalidBefore DATETIME(3) NULL,
+    lastModifiedDate DATETIME(3) NOT NULL,
+    createdDate DATETIME(3) NOT NULL,
+    UNIQUE KEY idx_profiles_email (email),
+    UNIQUE KEY idx_profiles_username (username)
+  );
+
+CREATE TABLE
+  rememberMeTokens (
+    id INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
+    profileId 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 idx_remember_me_tokens_selector (selector),
+    CONSTRAINT fk_remember_me_tokens_profile_id FOREIGN KEY (profileId) REFERENCES `profiles` (profileId) ON DELETE CASCADE
+  );
+
+CREATE TABLE
+  passwordResetTokens (
+    id INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
+    profileId INT UNSIGNED NOT NULL,
+    selector VARCHAR(32) NOT NULL,
+    verifierHash VARCHAR(255) NOT NULL,
+    expirationDate DATETIME(3) NOT NULL,
+    createdDate DATETIME(3) NOT NULL,
+    UNIQUE KEY idx_password_reset_tokens_selector (selector),
+    UNIQUE KEY idx_password_reset_tokens_profile_id (profileId),
+    CONSTRAINT fk_password_reset_tokens_profile_id FOREIGN KEY (profileId) REFERENCES `profiles` (profileId) ON DELETE CASCADE
+  );

package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260308234835_add-maestro-queue-table-down.sql

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

package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260308234835_add-maestro-queue-table-up.sql

@@ -0,0 +1,23 @@
+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
+  );

package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315051819_channels-down.sql

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

package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315051819_channels-up.sql

@@ -0,0 +1,11 @@
+CREATE TABLE channels (
+  id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY,
+  ownerProfileId INT UNSIGNED NOT NULL,
+  name VARCHAR(255) NOT NULL,
+  slug VARCHAR(255) NOT NULL,
+  description VARCHAR(2000) NOT NULL,
+  createdDate DATETIME(3) NOT NULL,
+  lastModifiedDate DATETIME(3) NOT NULL,
+  UNIQUE KEY uq_channels_slug (slug),
+  CONSTRAINT fk_channels_ownerProfileId FOREIGN KEY (ownerProfileId) REFERENCES profiles (profileId)
+);

package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315052202_channel-moderators-down.sql

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

package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315052202_channel-moderators-up.sql

@@ -0,0 +1,7 @@
+CREATE TABLE channelModerators (
+  channelId BIGINT UNSIGNED NOT NULL,
+  profileId INT UNSIGNED NOT NULL,
+  PRIMARY KEY (channelId, profileId),
+  CONSTRAINT fk_channelModerators_channelId FOREIGN KEY (channelId) REFERENCES channels (id),
+  CONSTRAINT fk_channelModerators_profileId FOREIGN KEY (profileId) REFERENCES profiles (profileId)
+);

package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315052539_posts-down.sql

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

package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315052539_posts-up.sql

@@ -0,0 +1,14 @@
+CREATE TABLE posts (
+  id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY,
+  channelId BIGINT UNSIGNED NOT NULL,
+  profileId INT UNSIGNED NOT NULL,
+  replyingToPostId BIGINT UNSIGNED,
+  content TEXT NOT NULL,
+  hiddenDate DATETIME(3),
+  createdDate DATETIME(3) NOT NULL,
+  lastModifiedDate DATETIME(3) NOT NULL,
+  KEY idx_posts_channel_created (channelId, createdDate),
+  CONSTRAINT fk_posts_channelId FOREIGN KEY (channelId) REFERENCES channels (id),
+  CONSTRAINT fk_posts_profileId FOREIGN KEY (profileId) REFERENCES profiles (profileId),
+  CONSTRAINT fk_posts_replyingToPostId FOREIGN KEY (replyingToPostId) REFERENCES posts (id)
+);

package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315052734_post-images-down.sql

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

package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315052734_post-images-up.sql

@@ -0,0 +1,7 @@
+CREATE TABLE postImages (
+  postId BIGINT UNSIGNED NOT NULL,
+  sortOrder TINYINT UNSIGNED NOT NULL,
+  url VARCHAR(500) NOT NULL,
+  PRIMARY KEY (postId, sortOrder),
+  CONSTRAINT fk_postImages_postId FOREIGN KEY (postId) REFERENCES posts (id)
+);

package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315053110_likes-down.sql

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

package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315053110_likes-up.sql

@@ -0,0 +1,8 @@
+CREATE TABLE likes (
+  postId BIGINT UNSIGNED NOT NULL,
+  profileId INT UNSIGNED NOT NULL,
+  createdDate DATETIME(3) NOT NULL,
+  PRIMARY KEY (postId, profileId),
+  CONSTRAINT fk_likes_postId FOREIGN KEY (postId) REFERENCES posts (id),
+  CONSTRAINT fk_likes_profileId FOREIGN KEY (profileId) REFERENCES profiles (profileId)
+);

package/skills/maestro-examples/references/chorus/infrastructure/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@chorus/infrastructure",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "cdk-synth": "cdk synth --app 'node ./cdk/index.ts'",
+    "cdk-diff": "cdk diff --app 'node ./cdk/index.ts'",
+    "cdk-deploy": "cdk deploy --all --app 'node ./cdk/index.ts'",
+    "cdk-destroy": "cdk destroy --app 'node ./cdk/index.ts'",
+    "aws-whoami": "aws sts get-caller-identity"
+  },
+  "dependencies": {
+    "@maestro-js/aws-cdk-recipes": "^1.0.0-alpha.21",
+    "@maestro-js/db-migrate": "^1.0.0-alpha.21",
+    "aws-cdk": "^2.1106.1",
+    "aws-cdk-lib": "^2.178.0",
+    "constructs": "^10.4.2",
+    "esbuild": "^0.25.0"
+  }
+}

package/skills/maestro-examples/references/chorus/infrastructure/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../tsconfig.json",
+  "compilerOptions": {
+    "moduleResolution": "nodenext",
+    "module": "nodenext"
+  },
+  "include": ["."]
+}

package/skills/maestro-examples/references/chorus/package.json

@@ -0,0 +1,17 @@
+{
+  "type": "module",
+  "private": "true",
+  "scripts": {
+    "fks-cascade": "maestro config:run --config services -- node ./scripts/foreign-key-delete-behavior.ts cascade",
+    "fks-restrict": "maestro config:run --config services -- node ./scripts/foreign-key-delete-behavior.ts restrict"
+  },
+  "dependencies": {
+    "@maestro-js/config": "^1.0.0-alpha.21"
+  },
+  "devDependencies": {
+    "@maestro-js/cli": "^1.0.0-alpha.21",
+    "@maestro-js/db-migrate": "^1.0.0-alpha.21",
+    "@maestro-js/db": "^1.0.0-alpha.21",
+    "@types/node": "^22.19.11"
+  }
+}

package/skills/maestro-examples/references/chorus/packages/email-templates/other/generate-email-modules.ts

@@ -0,0 +1,22 @@
+import fs from 'fs'
+import path from 'path'
+
+const emailDirContents = fs.readdirSync(path.join(process.cwd(), './src/emails'))
+
+const emailTemplates = emailDirContents
+  .filter((e) => e.endsWith('.tsx'))
+  .map((e) => e.replace('.tsx', ''))
+
+const fileContents = `/**
+ * This file is auto-generated on build.
+ */
+
+${emailTemplates.map((e, index) => `import * as Module${index} from './emails/${e}'`).join('\n')}
+
+export const EmailTemplateModules = {
+  ${emailTemplates.map((e, index) => `['${e}']: Module${index}`).join(',\n  ')}
+}
+`
+
+const generatedFilePath = './src/email-modules.ts'
+fs.writeFileSync(path.join(process.cwd(), generatedFilePath), fileContents)

package/skills/maestro-examples/references/chorus/packages/email-templates/other/generate-email-previews.ts

@@ -0,0 +1,18 @@
+import fs from 'fs'
+import path from 'path'
+import { render } from '@react-email/render'
+
+const emailsDir = path.join(process.cwd(), 'src/emails')
+const previewsDir = path.join(process.cwd(), 'previews')
+fs.mkdirSync(previewsDir, { recursive: true })
+
+const emailFiles = fs.readdirSync(emailsDir).filter((f) => f.endsWith('.tsx'))
+
+for (const file of emailFiles) {
+  const name = file.replace('.tsx', '')
+  const mod = await import(path.join(emailsDir, file))
+  const props = mod.previewProps ?? {}
+  const html = await render(mod.default(props), { pretty: true })
+  fs.writeFileSync(path.join(previewsDir, `${name}.html`), html)
+  console.log(`Generated preview: previews/${name}.html`)
+}

package/skills/maestro-examples/references/chorus/packages/email-templates/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@chorus/email-templates",
+  "private": true,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./out/index.d.ts",
+      "default": "./out/index.js"
+    }
+  },
+  "scripts": {
+    "build": "node ./other/generate-email-modules.ts && tsup src/index.ts --format esm --outDir out --external react",
+    "typecheck": "tsc --noEmit",
+    "preview": "tsx ./other/generate-email-previews.ts"
+  },
+  "dependencies": {
+    "@react-email/components": "^1.0.8",
+    "@react-email/render": "2.0.4",
+    "react": "^19.2.4",
+    "tailwind-merge": "^1.12.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.14",
+    "tsup": "^8.0.2",
+    "typescript": "~5.8.3"
+  }
+}

package/skills/maestro-examples/references/chorus/packages/email-templates/src/components/button.tsx

@@ -0,0 +1,19 @@
+import { Button as ReactEmailButton } from '@react-email/components'
+import { tw } from '../utils/tw'
+
+export type ButtonProps = {
+  children: string
+  href: string
+  className?: string
+}
+
+export function Button(props: ButtonProps) {
+  return (
+    <ReactEmailButton
+      className={tw('bg-primary-600 text-white py-2 px-4 rounded-full font-medium text-sm no-underline', props.className)}
+      href={props.href}
+    >
+      {props.children}
+    </ReactEmailButton>
+  )
+}