Improve view field identification command perfs and reliability (#17168)

# Introduction
Related to https://github.com/twentyhq/core-team-issues/issues/1989
Same continuity than what we've done in
https://github.com/twentyhq/twenty/pull/17161 comparing expect to
existing instead of existing versus expected

Plus various fixes
Tried both view and view field identification on prod extract, ( clean
soft deleted workspace and applied the migration WIP )

.cursor/Dockerfile

@@ -1,34 +0,0 @@
-FROM ubuntu:22.04
-
-ENV DEBIAN_FRONTEND=noninteractive
-
-RUN apt-get update && apt-get install -y \
-    curl \
-    git \
-    make \
-    build-essential \
-    postgresql-client \
-    docker.io \
-    && rm -rf /var/lib/apt/lists/*
-
-# Install nvm (project recommends nvm + .nvmrc for consistent Node versions)
-ENV NVM_DIR=/usr/local/nvm
-RUN mkdir -p $NVM_DIR \
-    && curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
-
-SHELL ["/bin/bash", "-c"]
-
-# Copy .nvmrc so nvm install picks up the right version
-COPY .nvmrc /tmp/.nvmrc
-
-# Install Node.js from .nvmrc, enable Corepack, and symlink binaries
-# so they're available on PATH without hardcoding a version
-RUN . $NVM_DIR/nvm.sh \
-    && nvm install $(cat /tmp/.nvmrc) \
-    && nvm alias default $(cat /tmp/.nvmrc) \
-    && corepack enable \
-    && BIN_DIR=$(dirname $(nvm which default)) \
-    && ln -sf $BIN_DIR/node /usr/local/bin/node \
-    && ln -sf $BIN_DIR/npm /usr/local/bin/npm \
-    && ln -sf $BIN_DIR/npx /usr/local/bin/npx \
-    && ln -sf $BIN_DIR/corepack /usr/local/bin/corepack

.cursor/environment.json

@@ -1,10 +1,18 @@
 {
-  "install": "yarn install",
-  "start": "sudo service docker start && sleep 2 && (docker start twenty_pg 2>/dev/null || make -C packages/twenty-docker postgres-on-docker) && (docker start twenty_redis 2>/dev/null || make -C packages/twenty-docker redis-on-docker) && until docker exec twenty_pg pg_isready -U postgres -h localhost 2>/dev/null; do sleep 1; done && echo 'PostgreSQL ready' && until docker exec twenty_redis redis-cli ping 2>/dev/null | grep -q PONG; do sleep 1; done && echo 'Redis ready' && bash packages/twenty-utils/setup-dev-env.sh && npx nx database:reset twenty-server",
+  "install": "curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash - && sudo apt-get install -y nodejs && node --version && yarn install && echo 'Installing dependencies complete'",
+  "start": "sudo service docker start && echo 'Docker service started' && sleep 3 && echo 'Starting PostgreSQL and Redis containers...' && make postgres-on-docker && make redis-on-docker && echo 'Waiting for containers to initialize...' && sleep 20 && echo 'Checking container status...' && docker ps --filter name=twenty_ && echo 'Waiting for PostgreSQL to be ready...' && until docker exec twenty_pg pg_isready -U postgres -h localhost; do echo 'PostgreSQL not ready yet, waiting...'; sleep 3; done && echo 'PostgreSQL is ready!' && echo 'Setting up database...' && cd packages/twenty-server && npx nx database:reset twenty-server || echo 'Database already initialized' && echo 'Environment setup complete!'",
   "terminals": [
     {
       "name": "Development Server",
-      "command": "yarn start"
+      "command": "echo 'Waiting for database to be fully ready...' && sleep 30 && until docker exec twenty_pg pg_isready -U postgres -h localhost; do echo 'Waiting for PostgreSQL...'; sleep 2; done && echo 'Starting Twenty development server...' && export SERVER_URL=http://localhost:3000 && export PG_DATABASE_URL=postgres://postgres:postgres@localhost:5432/postgres && yarn start"
+    },
+    {
+      "name": "Database Management",
+      "command": "sleep 25 && echo 'Database management terminal ready' && echo 'Waiting for PostgreSQL to be available...' && until docker exec twenty_pg pg_isready -U postgres -h localhost; do echo 'Waiting for PostgreSQL...'; sleep 2; done && echo 'PostgreSQL is ready for database operations!' && echo 'You can now run database commands like:' && echo '  npx nx database:reset twenty-server' && echo '  npx nx database:migrate twenty-server' && bash"
+    },
+    {
+      "name": "Container Logs & Status",
+      "command": "sleep 10 && echo '=== Container Status Monitor ===' && while true; do echo '\\n=== Container Status at $(date) ===' && docker ps --filter name=twenty_ --format 'table {{.Names}}\\t{{.Status}}\\t{{.Ports}}' && echo '\\n=== PostgreSQL Status ===' && (docker exec twenty_pg pg_isready -U postgres -h localhost && echo 'PostgreSQL: ✅ Ready') || echo 'PostgreSQL: ❌ Not Ready' && echo '\\n=== Redis Status ===' && (docker exec twenty_redis redis-cli ping && echo 'Redis: ✅ Ready') || echo 'Redis: ❌ Not Ready' && sleep 30; done"
     }
   ]
-}
+} 

.cursor/rules/README.mdc

@@ -13,7 +13,6 @@ This directory contains Twenty's development guidelines and best practices in th
 - **architecture.mdc** - Project overview, technology stack, and infrastructure setup (Always Applied)
 - **nx-rules.mdc** - Nx workspace guidelines and best practices (Auto-attached to Nx files)
 - **server-migrations.mdc** - Backend migration and TypeORM guidelines for `twenty-server` (Auto-attached to server entities and migration files)
-- **creating-syncable-entity.mdc** - Comprehensive guide for creating new syncable entities (with universalIdentifier and applicationId) in the workspace migration system (Agent-requested for metadata-modules and workspace-migration files)
 
 ### Code Quality
 - **typescript-guidelines.mdc** - TypeScript best practices and conventions (Auto-attached to .ts/.tsx files)
@@ -40,7 +39,6 @@ You can manually reference any rule using the `@ruleName` syntax:
 - `@nx-rules` - Include Nx-specific guidance
 - `@react-general-guidelines` - Load React best practices
 - `@testing-guidelines` - Get testing recommendations
-- `@creating-syncable-entity` - Guide for creating new syncable entities
 
 ### Rule Types Used
 - **Always Applied** - Loaded in every context (architecture.mdc, README.mdc)
@@ -55,7 +53,7 @@ You can manually reference any rule using the `@ruleName` syntax:
 # Testing
 npx nx test twenty-front                    # Run unit tests
 npx nx storybook:build twenty-front         # Build Storybook
-npx nx storybook:test                       # Run Storybook tests
+npx nx storybook:serve-and-test:static     # Run Storybook tests
 
 # Development
 npx nx lint:diff-with-main twenty-front            # Lint files changed vs main (fastest)

.cursor/rules/creating-syncable-entity.mdc

@@ -1,219 +0,0 @@
----
-description: Main guide for creating syncable entities in Twenty's workspace migration system
-globs: ["**/metadata-modules/**", "**/workspace-migration/**"]
-alwaysApply: false
----
-
-# Creating a New Syncable Entity - Main Guide
-
-This is the main guide for creating **syncable entities** in Twenty's workspace migration architecture.
-
-## Documentation Structure
-
-This main guide provides a high-level overview and navigation hub.
-
-**⚡ Skills** (`.cursor/skills/syncable-entity-*/SKILL.md`) - Concise, action-oriented implementation guides for each step. Reference these when creating a new syncable entity.
-
-**When to use:**
-- Start here for architecture overview and workflow
-- Reference specific skills (`@syncable-entity-types-and-constants`) when implementing each step
-
-## What is a Syncable Entity?
-
-A syncable entity is a metadata entity that:
-- Has a **`universalIdentifier`**: A unique identifier used for syncing entities across workspaces/applications
-- Has an **`applicationId`**: Links the entity to an application (Twenty Standard or Custom applications)
-- Participates in the **workspace migration system**: Can be created, updated, and deleted through the migration pipeline
-- Is **cached as a flat entity**: Denormalized representation for efficient validation and change detection
-
-Examples: `skill`, `agent`, `view`, `viewField`, `role`, `pageLayout`, etc.
-
-## Architecture Overview
-
-```
-Input DTO → Transform → Universal Flat Entity → Builder/Validator → Runner → Database
-                              ↓
-                        Cache Service
-```
-
-**Key Components:**
-- **TypeORM Entity**: Database model extending `SyncableEntity`
-- **Flat Entity**: Denormalized type (no relations, dates as strings) - for caching
-- **Universal Flat Entity**: Flat entity with foreign keys mapped to universal identifiers - for migrations
-- **Transform Utils**: Convert DTOs to universal flat entities
-- **Builder/Validator**: Validate and create migration actions
-- **Runner**: Execute actions against the database
-
-## Implementation Steps
-
-Follow these skills in order:
-
-### 1️⃣ **Foundation: Types & Constants** → `@syncable-entity-types-and-constants`
-
-**What:** Define all types, entities, and register in central constants
-
-**Tasks:**
-- Create TypeORM entity (extends `SyncableEntity`)
-- Define flat entity types
-- Define action types (universal + flat)
-- Register in 5 central constants
-
-**Why first:** Everything else depends on these types
-
----
-
-### 2️⃣ **Data Layer: Cache & Transform** → `@syncable-entity-cache-and-transform`
-
-**What:** Handle conversion between different representations
-
-**Tasks:**
-- Create cache service
-- Create entity-to-flat conversion
-- Create input transform utils
-- Handle foreign key resolution
-
-**Dependencies:** Requires Step 1
-
----
-
-### 3️⃣ **Business Logic: Builder & Validation** → `@syncable-entity-builder-and-validation`
-
-**What:** Validate business rules and create actions
-
-**Tasks:**
-- Create validator service (never throws, never mutates)
-- Create builder service
-- Wire into orchestrator (⚠️ critical!)
-
-**Dependencies:** Requires Steps 1-2
-
----
-
-### 4️⃣ **Execution: Runner & Actions** → `@syncable-entity-runner-and-actions`
-
-**What:** Execute migration actions against the database
-
-**Tasks:**
-- Create action handlers (create/update/delete)
-- Implement transpilation methods
-- Create universal-to-flat conversion utilities
-
-**Dependencies:** Requires Steps 1-3
-
----
-
-### 5️⃣ **Assembly: Integration** → `@syncable-entity-integration`
-
-**What:** Wire everything together
-
-**Tasks:**
-- Register in 3 NestJS modules
-- Create service and resolver layers
-- Use exception interceptor
-
-**Dependencies:** Requires Steps 1-4
-
----
-
-### 6️⃣ **Testing: Integration Tests** (**MANDATORY**) → `@syncable-entity-testing`
-
-**What:** Comprehensive test suite
-
-**Tasks:**
-- Create test utilities
-- Write failing tests (all validator exceptions)
-- Write successful tests (all CRUD operations)
-- Use snapshot testing
-
-**Dependencies:** Requires all previous steps
-
----
-
-## Quick Reference
-
-### Multi-Agent Workflow
-
-For parallel development:
-1. **Agent 1** (Foundation): Complete Step 1 first - unblocks everyone
-2. **Agent 2** (Cache): Can start immediately after Step 1
-3. **Agent 3** (Builder): Can work in parallel with Agent 4 after Step 1
-4. **Agent 4** (Runner): Can work in parallel with Agent 3 after Step 1
-5. **Agent 5** (Integration): Assembles everything after Steps 2-4
-
-### Key Design Principles
-
-| Layer | Responsibility | Can Throw? | Can Mutate? |
-|-------|---------------|------------|-------------|
-| Transform Utils | Data transformation | Yes (input validation) | N/A (creates new) |
-| Validator | Business rule validation | **No** (returns errors) | **No** |
-| Builder | Action creation | **No** (returns errors) | **No** |
-| Runner | Database operations | Yes (DB errors) | Yes (via TypeORM) |
-
-### Common Pitfalls
-
-⚠️ **Most Commonly Forgotten:**
-1. Wiring builder in orchestrator service
-2. Registering in all 3 modules (builder, validators, action handlers)
-3. Setting `universalIdentifier` correctly in entity-to-flat conversion
-
-⚠️ **Common Mistakes:**
-1. Using regular IDs instead of universal identifiers in transform utils
-2. Throwing exceptions in validators/builders
-3. Mutating entity maps in validators/builders
-4. Forgetting to handle JSONB properties with `SerializedRelation`
-
-### File Locations
-
-```
-packages/twenty-shared/src/metadata/
-└── all-metadata-name.constant.ts
-
-packages/twenty-server/src/engine/metadata-modules/
-├── my-entity/                           # Step 1
-│   └── entities/
-├── flat-my-entity/                      # Steps 1-2
-│   ├── types/
-│   ├── constants/
-│   ├── services/
-│   └── utils/
-└── flat-entity/constant/                # Step 1 (central registries)
-    ├── all-entity-properties-configuration-by-metadata-name.constant.ts
-    ├── all-one-to-many-metadata-relations.constant.ts
-    ├── all-many-to-one-metadata-foreign-key.constant.ts
-    └── all-many-to-one-metadata-relations.constant.ts
-
-packages/twenty-server/src/engine/workspace-manager/workspace-migration/
-├── workspace-migration-builder/         # Step 3
-│   ├── builders/my-entity/
-│   └── validators/services/
-└── workspace-migration-runner/          # Step 4
-    └── action-handlers/my-entity/
-```
-
-### Complete Checklist
-
-Before considering complete:
-- [ ] All 6 guides completed
-- [ ] TypeORM entity extends `SyncableEntity`
-- [ ] All constants registered (5 central registries)
-- [ ] Cache service with correct decorator
-- [ ] Transform utils return universal flat entities
-- [ ] Validator never throws/mutates
-- [ ] Builder wired in orchestrator (⚠️ critical!)
-- [ ] All 3 action handlers implemented
-- [ ] All 3 modules updated
-- [ ] **Integration tests written (MANDATORY)**
-- [ ] **All failing scenarios covered**
-- [ ] **All successful use cases tested**
-
----
-
-## Need Help?
-
-Reference the appropriate skill for step-by-step guidance:
-- `@syncable-entity-types-and-constants` - Types, entities, constants
-- `@syncable-entity-cache-and-transform` - Cache & transform
-- `@syncable-entity-builder-and-validation` - Builder & validation
-- `@syncable-entity-runner-and-actions` - Runner & actions
-- `@syncable-entity-integration` - Integration & wiring
-- `@syncable-entity-testing` - Testing patterns

.cursor/skills/syncable-entity-builder-and-validation/SKILL.md

@@ -1,393 +0,0 @@
----
-name: syncable-entity-builder-and-validation
-description: Create validation logic and migration action builders for syncable entities in Twenty. Use when implementing business rule validation, uniqueness checks, foreign key validation, or building workspace migration actions for syncable entities. Validators never throw and never mutate.
----
-
-# Syncable Entity: Builder & Validation (Step 3/6)
-
-**Purpose**: Implement business rule validation and create migration action builders.
-
-**When to use**: After completing Steps 1-2 (Types, Cache, Transform). Required before implementing action handlers.
-
----
-
-## Quick Start
-
-This step creates:
-1. Validator service (business logic validation)
-2. Builder service (action creation)
-3. Orchestrator wiring (**CRITICAL** - often forgotten!)
-
-**Key principles**:
-- Validators **never throw** - return error arrays
-- Validators **never mutate** - pass optimistic entity maps
-- Use indexed lookups (O(1)) not `Object.values().find()` (O(n))
-
----
-
-## Step 1: Create Validator Service
-
-**File**: `src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-my-entity-validator.service.ts`
-
-```typescript
-import { Injectable } from '@nestjs/common';
-import { t, msg } from '@lingui/macro';
-import { isDefined } from 'twenty-shared/utils';
-
-import { type FlatMyEntity } from 'src/engine/metadata-modules/flat-my-entity/types/flat-my-entity.type';
-import { type FlatMyEntityMaps } from 'src/engine/metadata-modules/flat-my-entity/types/flat-my-entity-maps.type';
-import { WorkspaceMigrationValidationError } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/types/workspace-migration-validation-error.type';
-import { MyEntityExceptionCode } from 'src/engine/metadata-modules/my-entity/exceptions/my-entity-exception-code.enum';
-
-@Injectable()
-export class FlatMyEntityValidatorService {
-  validateMyEntityForCreate(
-    flatMyEntity: FlatMyEntity,
-    optimisticFlatMyEntityMaps: FlatMyEntityMaps,
-  ): WorkspaceMigrationValidationError[] {
-    const errors: WorkspaceMigrationValidationError[] = [];
-
-    // Pattern 1: Required field validation
-    if (!isDefined(flatMyEntity.name) || flatMyEntity.name.trim() === '') {
-      errors.push({
-        code: MyEntityExceptionCode.NAME_REQUIRED,
-        message: t`Name is required`,
-        userFriendlyMessage: msg`Please provide a name for this entity`,
-      });
-    }
-
-    // Pattern 2: Uniqueness check - use indexed map (O(1))
-    const existingEntityWithName = optimisticFlatMyEntityMaps.byName[flatMyEntity.name];
-
-    if (isDefined(existingEntityWithName) && existingEntityWithName.id !== flatMyEntity.id) {
-      errors.push({
-        code: MyEntityExceptionCode.MY_ENTITY_ALREADY_EXISTS,
-        message: t`Entity with name ${flatMyEntity.name} already exists`,
-        userFriendlyMessage: msg`An entity with this name already exists`,
-      });
-    }
-
-    // Pattern 3: Foreign key validation
-    if (isDefined(flatMyEntity.parentEntityId)) {
-      const parentEntity = optimisticFlatParentEntityMaps.byId[flatMyEntity.parentEntityId];
-
-      if (!isDefined(parentEntity)) {
-        errors.push({
-          code: MyEntityExceptionCode.PARENT_ENTITY_NOT_FOUND,
-          message: t`Parent entity with ID ${flatMyEntity.parentEntityId} not found`,
-          userFriendlyMessage: msg`The specified parent entity does not exist`,
-        });
-      } else if (isDefined(parentEntity.deletedAt)) {
-        errors.push({
-          code: MyEntityExceptionCode.PARENT_ENTITY_DELETED,
-          message: t`Parent entity is deleted`,
-          userFriendlyMessage: msg`Cannot reference a deleted parent entity`,
-        });
-      }
-    }
-
-    // Pattern 4: Standard entity protection
-    if (flatMyEntity.isCustom === false) {
-      errors.push({
-        code: MyEntityExceptionCode.STANDARD_ENTITY_CANNOT_BE_CREATED,
-        message: t`Cannot create standard entity`,
-        userFriendlyMessage: msg`Standard entities can only be created by the system`,
-      });
-    }
-
-    return errors;
-  }
-
-  validateMyEntityForUpdate(
-    flatMyEntity: FlatMyEntity,
-    updates: Partial<FlatMyEntity>,
-    optimisticFlatMyEntityMaps: FlatMyEntityMaps,
-  ): WorkspaceMigrationValidationError[] {
-    const errors: WorkspaceMigrationValidationError[] = [];
-
-    // Standard entity protection
-    if (flatMyEntity.isCustom === false) {
-      errors.push({
-        code: MyEntityExceptionCode.STANDARD_ENTITY_CANNOT_BE_UPDATED,
-        message: t`Cannot update standard entity`,
-        userFriendlyMessage: msg`Standard entities cannot be modified`,
-      });
-      return errors; // Early return if standard
-    }
-
-    // Uniqueness check for name changes
-    if (isDefined(updates.name) && updates.name !== flatMyEntity.name) {
-      const existingEntityWithName = optimisticFlatMyEntityMaps.byName[updates.name];
-
-      if (isDefined(existingEntityWithName) && existingEntityWithName.id !== flatMyEntity.id) {
-        errors.push({
-          code: MyEntityExceptionCode.MY_ENTITY_ALREADY_EXISTS,
-          message: t`Entity with name ${updates.name} already exists`,
-          userFriendlyMessage: msg`An entity with this name already exists`,
-        });
-      }
-    }
-
-    return errors;
-  }
-
-  validateMyEntityForDelete(
-    flatMyEntity: FlatMyEntity,
-  ): WorkspaceMigrationValidationError[] {
-    const errors: WorkspaceMigrationValidationError[] = [];
-
-    // Standard entity protection
-    if (flatMyEntity.isCustom === false) {
-      errors.push({
-        code: MyEntityExceptionCode.STANDARD_ENTITY_CANNOT_BE_DELETED,
-        message: t`Cannot delete standard entity`,
-        userFriendlyMessage: msg`Standard entities cannot be deleted`,
-      });
-    }
-
-    return errors;
-  }
-}
-```
-
-**Performance warning**: Avoid `Object.values().find()` - use indexed maps instead!
-
-```typescript
-// ❌ BAD: O(n) - slow for large datasets
-const duplicate = Object.values(optimisticFlatMyEntityMaps.byId).find(
-  (entity) => entity.name === flatMyEntity.name && entity.id !== flatMyEntity.id
-);
-
-// ✅ GOOD: O(1) - use indexed map
-const existingEntityWithName = optimisticFlatMyEntityMaps.byName[flatMyEntity.name];
-if (isDefined(existingEntityWithName) && existingEntityWithName.id !== flatMyEntity.id) {
-  // Handle duplicate
-}
-```
-
----
-
-## Step 2: Create Builder Service
-
-**File**: `src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/my-entity/workspace-migration-my-entity-actions-builder.service.ts`
-
-```typescript
-import { Injectable } from '@nestjs/common';
-
-import { WorkspaceEntityMigrationBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/workspace-entity-migration-builder.service';
-import { FlatMyEntityValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-my-entity-validator.service';
-import { type UniversalFlatMyEntity } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-my-entity.type';
-import {
-  type UniversalCreateMyEntityAction,
-  type UniversalUpdateMyEntityAction,
-  type UniversalDeleteMyEntityAction,
-} from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/my-entity/types/workspace-migration-my-entity-action.type';
-
-@Injectable()
-export class WorkspaceMigrationMyEntityActionsBuilderService extends WorkspaceEntityMigrationBuilderService<
-  'myEntity',
-  UniversalFlatMyEntity,
-  UniversalCreateMyEntityAction,
-  UniversalUpdateMyEntityAction,
-  UniversalDeleteMyEntityAction
-> {
-  constructor(
-    private readonly flatMyEntityValidatorService: FlatMyEntityValidatorService,
-  ) {
-    super();
-  }
-
-  protected buildCreateAction(
-    universalFlatMyEntity: UniversalFlatMyEntity,
-    flatEntityMaps: AllFlatEntityMapsByMetadataName,
-  ): BuildWorkspaceMigrationActionReturnType<UniversalCreateMyEntityAction> {
-    const validationResult = this.flatMyEntityValidatorService.validateMyEntityForCreate(
-      universalFlatMyEntity,
-      flatEntityMaps.flatMyEntityMaps,
-    );
-
-    if (validationResult.length > 0) {
-      return {
-        status: 'failed',
-        errors: validationResult,
-      };
-    }
-
-    return {
-      status: 'success',
-      action: {
-        type: 'create',
-        metadataName: 'myEntity',
-        universalFlatEntity: universalFlatMyEntity,
-      },
-    };
-  }
-
-  protected buildUpdateAction(
-    universalFlatMyEntity: UniversalFlatMyEntity,
-    universalUpdates: Partial<UniversalFlatMyEntity>,
-    flatEntityMaps: AllFlatEntityMapsByMetadataName,
-  ): BuildWorkspaceMigrationActionReturnType<UniversalUpdateMyEntityAction> {
-    const validationResult = this.flatMyEntityValidatorService.validateMyEntityForUpdate(
-      universalFlatMyEntity,
-      universalUpdates,
-      flatEntityMaps.flatMyEntityMaps,
-    );
-
-    if (validationResult.length > 0) {
-      return {
-        status: 'failed',
-        errors: validationResult,
-      };
-    }
-
-    return {
-      status: 'success',
-      action: {
-        type: 'update',
-        metadataName: 'myEntity',
-        universalFlatEntity: universalFlatMyEntity,
-        universalUpdates,
-      },
-    };
-  }
-
-  protected buildDeleteAction(
-    universalFlatMyEntity: UniversalFlatMyEntity,
-  ): BuildWorkspaceMigrationActionReturnType<UniversalDeleteMyEntityAction> {
-    const validationResult = this.flatMyEntityValidatorService.validateMyEntityForDelete(
-      universalFlatMyEntity,
-    );
-
-    if (validationResult.length > 0) {
-      return {
-        status: 'failed',
-        errors: validationResult,
-      };
-    }
-
-    return {
-      status: 'success',
-      action: {
-        type: 'delete',
-        metadataName: 'myEntity',
-        universalFlatEntity: universalFlatMyEntity,
-      },
-    };
-  }
-}
-```
-
----
-
-## Step 3: Wire into Orchestrator (**CRITICAL**)
-
-**File**: `src/engine/workspace-manager/workspace-migration/workspace-migration-builder/workspace-migration-build-orchestrator.service.ts`
-
-```typescript
-@Injectable()
-export class WorkspaceMigrationBuildOrchestratorService {
-  constructor(
-    // ... existing builders
-    private readonly workspaceMigrationMyEntityActionsBuilderService: WorkspaceMigrationMyEntityActionsBuilderService,
-  ) {}
-
-  async buildWorkspaceMigration({
-    allFlatEntityOperationByMetadataName,
-    flatEntityMaps,
-    isSystemBuild,
-  }: BuildWorkspaceMigrationInput): Promise<BuildWorkspaceMigrationOutput> {
-    // ... existing code
-
-    // Add your entity builder
-    const myEntityResult = await this.workspaceMigrationMyEntityActionsBuilderService.build({
-      flatEntitiesToCreate: allFlatEntityOperationByMetadataName.myEntity?.flatEntityToCreate ?? [],
-      flatEntitiesToUpdate: allFlatEntityOperationByMetadataName.myEntity?.flatEntityToUpdate ?? [],
-      flatEntitiesToDelete: allFlatEntityOperationByMetadataName.myEntity?.flatEntityToDelete ?? [],
-      flatEntityMaps,
-      isSystemBuild,
-    });
-
-    // ... aggregate errors
-
-    return {
-      status: aggregatedErrors.length > 0 ? 'failed' : 'success',
-      errors: aggregatedErrors,
-      actions: [
-        ...existingActions,
-        ...myEntityResult.actions,
-      ],
-    };
-  }
-}
-```
-
-**⚠️ This step is the most commonly forgotten!** Your entity won't sync without orchestrator wiring.
-
----
-
-## Validation Patterns
-
-### Pattern 1: Required Field
-```typescript
-if (!isDefined(field) || field.trim() === '') {
-  errors.push({ code: ..., message: ..., userFriendlyMessage: ... });
-}
-```
-
-### Pattern 2: Uniqueness (O(1) lookup)
-```typescript
-const existing = optimisticMaps.byName[entity.name];
-if (isDefined(existing) && existing.id !== entity.id) {
-  errors.push({ ... });
-}
-```
-
-### Pattern 3: Foreign Key Validation
-```typescript
-if (isDefined(entity.parentId)) {
-  const parent = parentMaps.byId[entity.parentId];
-  if (!isDefined(parent)) {
-    errors.push({ code: NOT_FOUND, ... });
-  } else if (isDefined(parent.deletedAt)) {
-    errors.push({ code: DELETED, ... });
-  }
-}
-```
-
-### Pattern 4: Standard Entity Protection
-```typescript
-if (entity.isCustom === false) {
-  errors.push({ code: STANDARD_ENTITY_PROTECTED, ... });
-  return errors; // Early return
-}
-```
-
----
-
-## Checklist
-
-Before moving to Step 4:
-
-- [ ] Validator service created
-- [ ] Validator **never throws** (returns error arrays)
-- [ ] Validator **never mutates** (uses optimistic maps)
-- [ ] All uniqueness checks use indexed maps (O(1))
-- [ ] Required field validation implemented
-- [ ] Foreign key validation implemented
-- [ ] Standard entity protection implemented
-- [ ] Builder service extends `WorkspaceEntityMigrationBuilderService`
-- [ ] Builder creates actions with universal entities
-- [ ] **Builder wired into orchestrator** (**CRITICAL**)
-- [ ] **Builder injected in orchestrator constructor**
-- [ ] **Builder called in `buildWorkspaceMigration`**
-- [ ] **Actions added to orchestrator return statement**
-
----
-
-## Next Step
-
-Once builder and validation are complete, proceed to:
-**[Syncable Entity: Runner & Actions (Step 4/6)](../syncable-entity-runner-and-actions/SKILL.md)**
-
-For complete workflow, see `@creating-syncable-entity` rule.

.cursor/skills/syncable-entity-cache-and-transform/SKILL.md

@@ -1,303 +0,0 @@
----
-name: syncable-entity-cache-and-transform
-description: Create cache services and transformation utilities for syncable entities in Twenty. Use when implementing entity-to-flat conversions, input DTO transpilation to universal flat entities, or cache recomputation for syncable entities.
----
-
-# Syncable Entity: Cache & Transform (Step 2/6)
-
-**Purpose**: Create cache layer and transformation utilities to convert between different entity representations.
-
-**When to use**: After completing Step 1 (Types & Constants). Required before building validators and action handlers.
-
----
-
-## Quick Start
-
-This step creates:
-1. Cache service for flat entity maps
-2. Entity-to-flat conversion utility
-3. Input transform utils (DTO → Universal Flat Entity)
-
-**Key principle**: Input transform utils must output **universal flat entities** (with `universalIdentifier` and foreign keys mapped to universal identifiers).
-
----
-
-## Step 1: Create Cache Service
-
-**File**: `src/engine/metadata-modules/flat-my-entity/services/flat-my-entity-cache.service.ts`
-
-```typescript
-import { Injectable } from '@nestjs/common';
-import { InjectRepository } from '@nestjs/typeorm';
-import { Repository } from 'typeorm';
-import { v4 } from 'uuid';
-
-import { WorkspaceCache } from 'src/engine/twenty-orm/decorators/workspace-cache.decorator';
-import { MyEntityEntity } from 'src/engine/metadata-modules/my-entity/entities/my-entity.entity';
-import { type FlatMyEntityMaps } from 'src/engine/metadata-modules/flat-my-entity/types/flat-my-entity-maps.type';
-import { fromMyEntityEntityToFlatMyEntity } from 'src/engine/metadata-modules/flat-my-entity/utils/from-my-entity-entity-to-flat-my-entity.util';
-
-@Injectable()
-export class FlatMyEntityCacheService {
-  constructor(
-    @InjectRepository(MyEntityEntity, 'metadata')
-    private readonly myEntityRepository: Repository<MyEntityEntity>,
-  ) {}
-
-  @WorkspaceCache({ flatMapsKey: 'flatMyEntityMaps' })
-  async getFlatMyEntityMaps(): Promise<FlatMyEntityMaps> {
-    const myEntities = await this.myEntityRepository.find({
-      withDeleted: true, // CRITICAL: Include soft-deleted entities
-    });
-
-    const flatMyEntities = myEntities.map((entity) =>
-      fromMyEntityEntityToFlatMyEntity(entity),
-    );
-
-    return {
-      byId: Object.fromEntries(flatMyEntities.map((e) => [e.id, e])),
-      byName: Object.fromEntries(flatMyEntities.map((e) => [e.name, e])),
-    };
-  }
-}
-```
-
-**Critical rules**:
-- Use `@WorkspaceCache` decorator with unique `flatMapsKey`
-- **Always** use `withDeleted: true` to include soft-deleted entities
-- Cache key pattern: `flat{EntityName}Maps` (camelCase)
-
----
-
-## Step 2: Entity-to-Flat Conversion
-
-**File**: `src/engine/metadata-modules/flat-my-entity/utils/from-my-entity-entity-to-flat-my-entity.util.ts`
-
-```typescript
-import { v4 } from 'uuid';
-import { type MyEntityEntity } from 'src/engine/metadata-modules/my-entity/entities/my-entity.entity';
-import { type FlatMyEntity } from 'src/engine/metadata-modules/flat-my-entity/types/flat-my-entity.type';
-
-export const fromMyEntityEntityToFlatMyEntity = (
-  entity: MyEntityEntity,
-): FlatMyEntity => {
-  return {
-    id: entity.id,
-    // Critical: generate a new UUID for universalIdentifier
-    universalIdentifier: v4(),
-    workspaceId: entity.workspaceId,
-    applicationId: entity.applicationId,
-    name: entity.name,
-    label: entity.label,
-    description: entity.description,
-    isCustom: entity.isCustom,
-    parentEntityId: entity.parentEntityId,
-    settings: entity.settings,
-    createdAt: entity.createdAt.toISOString(),
-    updatedAt: entity.updatedAt.toISOString(),
-    deletedAt: entity.deletedAt?.toISOString() ?? null,
-  };
-};
-```
-
-**Critical**: `universalIdentifier` must be a new UUID generated with `v4()` (not `entity.id`)
-
----
-
-## Step 3: Input Transform Utils (DTO → Universal Flat Entity)
-
-**File**: `src/engine/metadata-modules/flat-my-entity/utils/from-create-my-entity-input-to-universal-flat-my-entity.util.ts`
-
-```typescript
-import { v4 } from 'uuid';
-import { sanitizeString } from 'twenty-shared/string';
-import { type CreateMyEntityInput } from 'src/engine/metadata-modules/my-entity/dtos/create-my-entity.input';
-import { type UniversalFlatMyEntity } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-my-entity.type';
-import { resolveEntityRelationUniversalIdentifiers } from 'src/engine/metadata-modules/flat-entity/utils/resolve-entity-relation-universal-identifiers.util';
-import { type AllFlatEntityMapsByMetadataName } from 'src/engine/metadata-modules/flat-entity/types/all-flat-entity-maps-by-metadata-name.type';
-
-export const fromCreateMyEntityInputToUniversalFlatMyEntity = ({
-  input,
-  workspaceId,
-  flatEntityMaps,
-}: {
-  input: CreateMyEntityInput;
-  workspaceId: string;
-  flatEntityMaps?: AllFlatEntityMapsByMetadataName;
-}): UniversalFlatMyEntity => {
-  const id = v4();
-  const universalIdentifier = v4();
-
-  // 1. Extract foreign key IDs BEFORE sanitization
-  const parentEntityId = input.parentEntityId ?? null;
-
-  // 2. Sanitize string properties
-  const name = sanitizeString(input.name);
-  const label = sanitizeString(input.label);
-  const description = input.description ? sanitizeString(input.description) : null;
-
-  // 3. Build base flat entity
-  const baseFlatEntity = {
-    id,
-    universalIdentifier,
-    workspaceId,
-    applicationId: null,
-    name,
-    label,
-    description,
-    isCustom: true,
-    parentEntityId,
-    settings: input.settings ?? null,
-    createdAt: new Date().toISOString(),
-    updatedAt: new Date().toISOString(),
-    deletedAt: null,
-  };
-
-  // 4. Resolve foreign keys to universal identifiers (if flatEntityMaps provided)
-  if (flatEntityMaps) {
-    return resolveEntityRelationUniversalIdentifiers({
-      metadataName: 'myEntity',
-      flatEntity: baseFlatEntity,
-      flatEntityMaps,
-    });
-  }
-
-  // 5. Return with null universal foreign keys if no maps
-  return {
-    ...baseFlatEntity,
-    parentEntityUniversalIdentifier: null,
-  };
-};
-```
-
-**Key steps**:
-1. Generate IDs (`id` and `universalIdentifier` with `v4()`)
-2. Extract foreign keys **before** sanitization
-3. Sanitize all string properties
-4. Build base flat entity
-5. Resolve foreign keys → universal identifiers
-
----
-
-## Step 4: Create Flat Entity Module
-
-**File**: `src/engine/metadata-modules/flat-my-entity/flat-my-entity.module.ts`
-
-```typescript
-import { Module } from '@nestjs/common';
-import { TypeOrmModule } from '@nestjs/typeorm';
-
-import { MyEntityEntity } from 'src/engine/metadata-modules/my-entity/entities/my-entity.entity';
-import { FlatMyEntityCacheService } from 'src/engine/metadata-modules/flat-my-entity/services/flat-my-entity-cache.service';
-
-@Module({
-  imports: [TypeOrmModule.forFeature([MyEntityEntity], 'metadata')],
-  providers: [FlatMyEntityCacheService],
-  exports: [FlatMyEntityCacheService],
-})
-export class FlatMyEntityModule {}
-```
-
-**Rules**:
-- Import entity with `'metadata'` datasource
-- Export cache service for use in other modules
-
----
-
-## Common Patterns
-
-### Pattern: Foreign Key Resolution
-
-```typescript
-// Extract foreign keys BEFORE sanitization
-const parentEntityId = input.parentEntityId ?? null;
-
-// After building base entity, resolve to universal identifiers
-const universalFlatEntity = resolveEntityRelationUniversalIdentifiers({
-  metadataName: 'myEntity',
-  flatEntity: baseFlatEntity,
-  flatEntityMaps,
-});
-```
-
-### Pattern: JSONB with SerializedRelation
-
-```typescript
-// For JSONB properties containing foreign keys
-const settings = input.settings
-  ? {
-      ...input.settings,
-      fieldMetadataId: input.settings.fieldMetadataId,
-    }
-  : null;
-
-// After resolution, JSONB foreign keys become universal identifiers
-return resolveEntityRelationUniversalIdentifiers({
-  metadataName: 'myEntity',
-  flatEntity: { ...baseFlatEntity, settings },
-  flatEntityMaps,
-});
-```
-
-### Pattern: Update Transform
-
-```typescript
-// from-update-my-entity-input-to-universal-flat-my-entity-updates.util.ts
-export const fromUpdateMyEntityInputToUniversalFlatMyEntityUpdates = ({
-  input,
-  flatEntityMaps,
-}: {
-  input: UpdateMyEntityInput;
-  flatEntityMaps?: AllFlatEntityMapsByMetadataName;
-}): Partial<UniversalFlatMyEntity> => {
-  const updates: Partial<UniversalFlatMyEntity> = {};
-
-  if (input.name !== undefined) {
-    updates.name = sanitizeString(input.name);
-  }
-
-  if (input.parentEntityId !== undefined) {
-    updates.parentEntityId = input.parentEntityId;
-  }
-
-  updates.updatedAt = new Date().toISOString();
-
-  // Resolve foreign keys if maps provided
-  if (flatEntityMaps) {
-    return resolveEntityRelationUniversalIdentifiers({
-      metadataName: 'myEntity',
-      flatEntity: updates as any,
-      flatEntityMaps,
-    });
-  }
-
-  return updates;
-};
-```
-
----
-
-## Checklist
-
-Before moving to Step 3:
-
-- [ ] Cache service created with `@WorkspaceCache` decorator
-- [ ] Cache uses `withDeleted: true`
-- [ ] Cache key follows `flat{EntityName}Maps` pattern
-- [ ] Entity-to-flat conversion implemented
-- [ ] `universalIdentifier` set correctly (generated with `v4()`)
-- [ ] Create input transform implemented
-- [ ] Update input transform implemented (if needed)
-- [ ] Foreign keys extracted before sanitization
-- [ ] String properties sanitized
-- [ ] Foreign keys resolved to universal identifiers
-- [ ] Flat entity module created and exports cache service
-
----
-
-## Next Step
-
-Once cache and transform utilities are complete, proceed to:
-**[Syncable Entity: Builder & Validation (Step 3/6)](../syncable-entity-builder-and-validation/SKILL.md)**
-
-For complete workflow, see `@creating-syncable-entity` rule.

.cursor/skills/syncable-entity-integration/SKILL.md

@@ -1,326 +0,0 @@
----
-name: syncable-entity-integration
-description: Wire syncable entity services into NestJS modules, create service layer and resolvers for Twenty entities. Use when registering builders, validators, and action handlers in modules, creating business services, or exposing entities via GraphQL API with proper exception handling.
----
-
-# Syncable Entity: Integration (Step 5/6)
-
-**Purpose**: Wire everything together, register in modules, create services and resolvers.
-
-**When to use**: After completing Steps 1-4 (all previous steps). Required before testing.
-
----
-
-## Quick Start
-
-This step:
-1. Registers services in 3 NestJS modules
-2. Creates service layer (returns flat entities)
-3. Creates resolver layer (converts flat → DTO)
-4. Uses exception interceptor for GraphQL
-
-**Key principle**: Services return flat entities, resolvers transpile flat → DTO.
-
----
-
-## Step 1: Register in Builder Module
-
-**File**: `src/engine/workspace-manager/workspace-migration/workspace-migration-builder/workspace-migration-builder.module.ts`
-
-```typescript
-import { WorkspaceMigrationMyEntityActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/my-entity/workspace-migration-my-entity-actions-builder.service';
-
-@Module({
-  imports: [
-    // ... existing imports
-  ],
-  providers: [
-    // ... existing providers
-    WorkspaceMigrationMyEntityActionsBuilderService,
-  ],
-  exports: [
-    // ... existing exports
-    WorkspaceMigrationMyEntityActionsBuilderService,
-  ],
-})
-export class WorkspaceMigrationBuilderModule {}
-```
-
-**Important**: Add to both `providers` AND `exports` (builder needs to be exported for orchestrator).
-
----
-
-## Step 2: Register in Validators Module
-
-**File**: `src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/workspace-migration-builder-validators.module.ts`
-
-```typescript
-import { FlatMyEntityValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-my-entity-validator.service';
-
-@Module({
-  imports: [
-    // ... existing imports
-  ],
-  providers: [
-    // ... existing providers
-    FlatMyEntityValidatorService,
-  ],
-  exports: [
-    // ... existing exports
-    FlatMyEntityValidatorService,
-  ],
-})
-export class WorkspaceMigrationBuilderValidatorsModule {}
-```
-
----
-
-## Step 3: Register Action Handlers
-
-**File**: `src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/workspace-schema-migration-runner-action-handlers.module.ts`
-
-```typescript
-import { CreateMyEntityActionHandlerService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/my-entity/services/create-my-entity-action-handler.service';
-import { UpdateMyEntityActionHandlerService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/my-entity/services/update-my-entity-action-handler.service';
-import { DeleteMyEntityActionHandlerService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/my-entity/services/delete-my-entity-action-handler.service';
-
-@Module({
-  imports: [
-    // ... existing imports
-  ],
-  providers: [
-    // ... existing providers
-    CreateMyEntityActionHandlerService,
-    UpdateMyEntityActionHandlerService,
-    DeleteMyEntityActionHandlerService,
-  ],
-  exports: [
-    // ... existing exports (action handlers typically not exported)
-  ],
-})
-export class WorkspaceSchemaMigrationRunnerActionHandlersModule {}
-```
-
-**Note**: Action handlers are typically only in `providers`, not `exports`.
-
----
-
-## Step 4: Create Service Layer
-
-**File**: `src/engine/metadata-modules/my-entity/my-entity.service.ts`
-
-```typescript
-import { Injectable } from '@nestjs/common';
-import { isDefined } from 'twenty-shared/utils';
-
-import { type FlatMyEntity } from 'src/engine/metadata-modules/flat-my-entity/types/flat-my-entity.type';
-import { WorkspaceManyOrAllFlatEntityMapsCacheService } from 'src/engine/metadata-modules/flat-entity/services/workspace-many-or-all-flat-entity-maps-cache.service';
-import { findFlatEntityByIdInFlatEntityMapsOrThrow } from 'src/engine/metadata-modules/flat-entity/utils/find-flat-entity-by-id-in-flat-entity-maps-or-throw.util';
-import { fromCreateMyEntityInputToUniversalFlatMyEntity } from 'src/engine/metadata-modules/flat-my-entity/utils/from-create-my-entity-input-to-universal-flat-my-entity.util';
-import { WorkspaceMigrationBuilderException } from 'src/engine/workspace-manager/workspace-migration/exceptions/workspace-migration-builder-exception';
-import { WorkspaceMigrationValidateBuildAndRunService } from 'src/engine/workspace-manager/workspace-migration/services/workspace-migration-validate-build-and-run-service';
-
-@Injectable()
-export class MyEntityService {
-  constructor(
-    private readonly workspaceMigrationValidateBuildAndRunService: WorkspaceMigrationValidateBuildAndRunService,
-    private readonly workspaceManyOrAllFlatEntityMapsCacheService: WorkspaceManyOrAllFlatEntityMapsCacheService,
-  ) {}
-
-  async create(input: CreateMyEntityInput, workspaceId: string): Promise<FlatMyEntity> {
-    // 1. Transform input to universal flat entity
-    const universalFlatMyEntityToCreate = fromCreateMyEntityInputToUniversalFlatMyEntity({
-      input,
-      workspaceId,
-    });
-
-    // 2. Validate, build, and run
-    const result =
-      await this.workspaceMigrationValidateBuildAndRunService.validateBuildAndRunWorkspaceMigration(
-        {
-          allFlatEntityOperationByMetadataName: {
-            myEntity: {
-              flatEntityToCreate: [universalFlatMyEntityToCreate],
-              flatEntityToDelete: [],
-              flatEntityToUpdate: [],
-            },
-          },
-          workspaceId,
-          isSystemBuild: false,
-        },
-      );
-
-    // 3. Throw if validation failed
-    if (isDefined(result)) {
-      throw new WorkspaceMigrationBuilderException(
-        result,
-        'Validation errors occurred while creating entity',
-      );
-    }
-
-    // 4. Return freshly cached flat entity
-    const { flatMyEntityMaps } =
-      await this.workspaceManyOrAllFlatEntityMapsCacheService.getOrRecomputeManyOrAllFlatEntityMaps(
-        {
-          workspaceId,
-          flatMapsKeys: ['flatMyEntityMaps'],
-        },
-      );
-
-    return findFlatEntityByIdInFlatEntityMapsOrThrow({
-      flatEntityId: universalFlatMyEntityToCreate.id,
-      flatEntityMaps: flatMyEntityMaps,
-    });
-  }
-}
-```
-
-**Service pattern**:
-1. Transform input → universal flat entity
-2. Call `validateBuildAndRunWorkspaceMigration`
-3. Throw if validation errors
-4. **Return flat entity** (not DTO)
-
----
-
-## Step 5: Create Resolver Layer
-
-**File**: `src/engine/metadata-modules/my-entity/my-entity.resolver.ts`
-
-```typescript
-import { UseInterceptors } from '@nestjs/common';
-import { Args, Mutation, Resolver } from '@nestjs/graphql';
-
-import { WorkspaceMigrationGraphqlApiExceptionInterceptor } from 'src/engine/workspace-manager/workspace-migration/interceptors/workspace-migration-graphql-api-exception.interceptor';
-import { MyEntityService } from 'src/engine/metadata-modules/my-entity/my-entity.service';
-import { fromFlatMyEntityToMyEntityDto } from 'src/engine/metadata-modules/my-entity/utils/from-flat-my-entity-to-my-entity-dto.util';
-
-@Resolver(() => MyEntityDto)
-@UseInterceptors(WorkspaceMigrationGraphqlApiExceptionInterceptor)
-export class MyEntityResolver {
-  constructor(private readonly myEntityService: MyEntityService) {}
-
-  @Mutation(() => MyEntityDto)
-  async createMyEntity(
-    @Args('input') input: CreateMyEntityInput,
-    @Workspace() { id: workspaceId }: Workspace,
-  ): Promise<MyEntityDto> {
-    // Service returns flat entity
-    const flatMyEntity = await this.myEntityService.create(input, workspaceId);
-    
-    // Resolver converts flat entity to DTO
-    return fromFlatMyEntityToMyEntityDto(flatMyEntity);
-  }
-
-  @Mutation(() => MyEntityDto)
-  async updateMyEntity(
-    @Args('id') id: string,
-    @Args('input') input: UpdateMyEntityInput,
-    @Workspace() { id: workspaceId }: Workspace,
-  ): Promise<MyEntityDto> {
-    const flatMyEntity = await this.myEntityService.update(id, input, workspaceId);
-    return fromFlatMyEntityToMyEntityDto(flatMyEntity);
-  }
-
-  @Mutation(() => Boolean)
-  async deleteMyEntity(
-    @Args('id') id: string,
-    @Workspace() { id: workspaceId }: Workspace,
-  ) {
-    await this.myEntityService.delete(id, workspaceId);
-    return true;
-  }
-}
-```
-
-**Resolver responsibilities**:
-- Receives flat entities from service
-- **Converts flat → DTO** using conversion utility
-- Returns DTOs to GraphQL API
-- Uses exception interceptor for error formatting
-
----
-
-## Step 6: Flat-to-DTO Conversion
-
-**File**: `src/engine/metadata-modules/my-entity/utils/from-flat-my-entity-to-my-entity-dto.util.ts`
-
-```typescript
-import { type FlatMyEntity } from 'src/engine/metadata-modules/flat-my-entity/types/flat-my-entity.type';
-import { type MyEntityDto } from 'src/engine/metadata-modules/my-entity/dtos/my-entity.dto';
-
-export const fromFlatMyEntityToMyEntityDto = (
-  flatMyEntity: FlatMyEntity,
-): MyEntityDto => {
-  return {
-    id: flatMyEntity.id,
-    name: flatMyEntity.name,
-    label: flatMyEntity.label,
-    description: flatMyEntity.description,
-    isCustom: flatMyEntity.isCustom,
-    createdAt: flatMyEntity.createdAt,
-    updatedAt: flatMyEntity.updatedAt,
-    // Convert foreign key IDs to relation objects if needed
-    // parentEntity: flatMyEntity.parentEntityId ? { id: flatMyEntity.parentEntityId } : null,
-  };
-};
-```
-
----
-
-## Layer Responsibilities
-
-| Layer | Input | Output | Responsibility |
-|-------|-------|--------|----------------|
-| **Service** | Input DTO | Flat Entity | Business logic, validation orchestration |
-| **Resolver** | Service result | DTO | Flat → DTO conversion, GraphQL exposure |
-
-**Service Layer**:
-- Works with flat entities internally
-- Returns `FlatMyEntity` type
-- No knowledge of DTOs or GraphQL types
-
-**Resolver Layer**:
-- Receives flat entities from service
-- Converts flat entities to DTOs
-- Returns DTOs to GraphQL API
-
----
-
-## Exception Interceptor
-
-The `WorkspaceMigrationGraphqlApiExceptionInterceptor` automatically handles:
-
-1. `FlatEntityMapsException` → Converts to GraphQL errors (NotFoundError, etc.)
-2. `WorkspaceMigrationBuilderException` → Formats validation errors with i18n
-3. `WorkspaceMigrationRunnerException` → Formats runner errors
-
-**What it does**:
-- Catches exceptions and formats for API responses
-- Translates error messages based on user locale
-- Ensures consistent error structure for frontend
-
----
-
-## Checklist
-
-Before moving to Step 6 (Testing):
-
-- [ ] Builder registered in builder module (providers + exports)
-- [ ] Validator registered in validators module (providers + exports)
-- [ ] All 3 action handlers registered in action handlers module (providers)
-- [ ] Service layer created
-- [ ] Service returns flat entities (not DTOs)
-- [ ] Resolver layer created
-- [ ] Resolver uses exception interceptor
-- [ ] Resolver converts flat → DTO
-- [ ] Flat-to-DTO conversion utility created
-
----
-
-## Next Step
-
-Once integration is complete, proceed to (**MANDATORY**):
-**[Syncable Entity: Integration Testing (Step 6/6)](../syncable-entity-testing/SKILL.md)**
-
-For complete workflow, see `@creating-syncable-entity` rule.

.cursor/skills/syncable-entity-runner-and-actions/SKILL.md

@@ -1,355 +0,0 @@
----
-name: syncable-entity-runner-and-actions
-description: Implement action handlers for executing workspace migrations in Twenty. Use when creating database operations for syncable entities, implementing universal-to-flat entity transpilation, or handling create/update/delete actions in the runner layer.
----
-
-# Syncable Entity: Runner & Actions (Step 4/6)
-
-**Purpose**: Execute migration actions against the database with proper transpilation from universal to flat entities.
-
-**When to use**: After completing Steps 1-3 (Types, Cache, Builder). Required before integration.
-
----
-
-## Quick Start
-
-This step creates:
-1. Create action handler
-2. Update action handler
-3. Delete action handler
-4. Universal-to-flat conversion utilities
-
-**Key pattern**: Each handler has two phases:
-1. **Transpilation**: Universal action → Flat action
-2. **Execution**: Flat action → Database operation
-
----
-
-## Step 1: Create Action Handler
-
-**File**: `src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/my-entity/services/create-my-entity-action-handler.service.ts`
-
-```typescript
-import { Injectable } from '@nestjs/common';
-import { InjectRepository } from '@nestjs/typeorm';
-import { Repository } from 'typeorm';
-
-import { WorkspaceCreateActionHandlerService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/workspace-create-action-handler.service';
-import { MyEntityEntity } from 'src/engine/metadata-modules/my-entity/entities/my-entity.entity';
-import { fromUniversalFlatMyEntityToFlatMyEntity } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/my-entity/utils/from-universal-flat-my-entity-to-flat-my-entity.util';
-import {
-  type UniversalCreateMyEntityAction,
-  type FlatCreateMyEntityAction,
-} from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/my-entity/types/workspace-migration-my-entity-action.type';
-
-@Injectable()
-export class CreateMyEntityActionHandlerService extends WorkspaceCreateActionHandlerService<
-  'myEntity',
-  UniversalCreateMyEntityAction,
-  FlatCreateMyEntityAction
-> {
-  constructor(
-    @InjectRepository(MyEntityEntity, 'metadata')
-    private readonly myEntityRepository: Repository<MyEntityEntity>,
-  ) {
-    super();
-  }
-
-  // Phase 1: Transpile universal action to flat action
-  protected transpileUniversalActionToFlatAction(
-    universalAction: UniversalCreateMyEntityAction,
-    flatEntityMaps: AllFlatEntityMapsByMetadataName,
-  ): FlatCreateMyEntityAction {
-    return {
-      type: 'create',
-      metadataName: 'myEntity',
-      flatEntity: fromUniversalFlatMyEntityToFlatMyEntity(
-        universalAction.universalFlatEntity,
-        flatEntityMaps,
-      ),
-    };
-  }
-
-  // Phase 2: Execute flat action against database
-  protected async executeForMetadata(
-    flatActions: FlatCreateMyEntityAction[],
-  ): Promise<void> {
-    const flatEntities = flatActions.map((action) => action.flatEntity);
-
-    await this.insertFlatEntitiesInRepository({
-      repository: this.myEntityRepository,
-      flatEntities,
-    });
-  }
-
-  protected async executeForWorkspaceSchema(): Promise<void> {
-    // No workspace schema changes needed for metadata-only entity
-    return;
-  }
-}
-```
-
-**Key helper methods**:
-- `transpileUniversalActionToFlatAction`: Converts universal → flat
-- `insertFlatEntitiesInRepository`: Base class helper for inserts
-- `executeForMetadata`: Metadata database operations
-- `executeForWorkspaceSchema`: Workspace schema changes (if needed)
-
----
-
-## Step 2: Update Action Handler
-
-**File**: `src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/my-entity/services/update-my-entity-action-handler.service.ts`
-
-```typescript
-import { Injectable } from '@nestjs/common';
-import { InjectRepository } from '@nestjs/typeorm';
-import { Repository } from 'typeorm';
-
-import { WorkspaceUpdateActionHandlerService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/workspace-update-action-handler.service';
-import { MyEntityEntity } from 'src/engine/metadata-modules/my-entity/entities/my-entity.entity';
-import { fromUniversalFlatMyEntityToFlatMyEntity } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/my-entity/utils/from-universal-flat-my-entity-to-flat-my-entity.util';
-import { resolveUniversalUpdateRelationIdentifiersToIds } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/utils/resolve-universal-relation-identifiers-to-ids.util';
-
-@Injectable()
-export class UpdateMyEntityActionHandlerService extends WorkspaceUpdateActionHandlerService<
-  'myEntity',
-  UniversalUpdateMyEntityAction,
-  FlatUpdateMyEntityAction
-> {
-  constructor(
-    @InjectRepository(MyEntityEntity, 'metadata')
-    private readonly myEntityRepository: Repository<MyEntityEntity>,
-  ) {
-    super();
-  }
-
-  protected transpileUniversalActionToFlatAction(
-    universalAction: UniversalUpdateMyEntityAction,
-    flatEntityMaps: AllFlatEntityMapsByMetadataName,
-  ): FlatUpdateMyEntityAction {
-    const flatEntity = fromUniversalFlatMyEntityToFlatMyEntity(
-      universalAction.universalFlatEntity,
-      flatEntityMaps,
-    );
-
-    // Resolve universal foreign keys in updates to regular IDs
-    const flatUpdates = resolveUniversalUpdateRelationIdentifiersToIds({
-      metadataName: 'myEntity',
-      universalUpdates: universalAction.universalUpdates,
-      flatEntityMaps,
-    });
-
-    return {
-      type: 'update',
-      metadataName: 'myEntity',
-      flatEntity,
-      updates: flatUpdates,
-    };
-  }
-
-  protected async executeForMetadata(
-    flatActions: FlatUpdateMyEntityAction[],
-  ): Promise<void> {
-    for (const action of flatActions) {
-      await this.myEntityRepository.update(
-        { id: action.flatEntity.id },
-        action.updates,
-      );
-    }
-  }
-
-  protected async executeForWorkspaceSchema(): Promise<void> {
-    return;
-  }
-}
-```
-
-**Update-specific helper**:
-- `resolveUniversalUpdateRelationIdentifiersToIds`: Maps universal identifiers back to regular IDs in the updates object
-
----
-
-## Step 3: Delete Action Handler
-
-**File**: `src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/my-entity/services/delete-my-entity-action-handler.service.ts`
-
-```typescript
-import { Injectable } from '@nestjs/common';
-import { InjectRepository } from '@nestjs/typeorm';
-import { Repository } from 'typeorm';
-
-import { WorkspaceDeleteActionHandlerService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/workspace-delete-action-handler.service';
-import { MyEntityEntity } from 'src/engine/metadata-modules/my-entity/entities/my-entity.entity';
-import { fromUniversalFlatMyEntityToFlatMyEntity } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/my-entity/utils/from-universal-flat-my-entity-to-flat-my-entity.util';
-
-@Injectable()
-export class DeleteMyEntityActionHandlerService extends WorkspaceDeleteActionHandlerService<
-  'myEntity',
-  UniversalDeleteMyEntityAction,
-  FlatDeleteMyEntityAction
-> {
-  constructor(
-    @InjectRepository(MyEntityEntity, 'metadata')
-    private readonly myEntityRepository: Repository<MyEntityEntity>,
-  ) {
-    super();
-  }
-
-  protected transpileUniversalActionToFlatAction(
-    universalAction: UniversalDeleteMyEntityAction,
-    flatEntityMaps: AllFlatEntityMapsByMetadataName,
-  ): FlatDeleteMyEntityAction {
-    // Use base class helper for delete transpilation
-    return this.transpileUniversalDeleteActionToFlatDeleteAction({
-      universalAction,
-      flatEntityMaps,
-      fromUniversalFlatEntityToFlatEntity: fromUniversalFlatMyEntityToFlatMyEntity,
-    });
-  }
-
-  protected async executeForMetadata(
-    flatActions: FlatDeleteMyEntityAction[],
-  ): Promise<void> {
-    const ids = flatActions.map((action) => action.flatEntity.id);
-
-    await this.myEntityRepository.delete(ids);
-  }
-
-  protected async executeForWorkspaceSchema(): Promise<void> {
-    return;
-  }
-}
-```
-
-**Delete-specific helper**:
-- `transpileUniversalDeleteActionToFlatDeleteAction`: Base class helper that handles standard delete transpilation
-
----
-
-## Step 4: Universal-to-Flat Conversion
-
-**File**: `src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/my-entity/utils/from-universal-flat-my-entity-to-flat-my-entity.util.ts`
-
-```typescript
-import { resolveUniversalRelationIdentifiersToIds } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/utils/resolve-universal-relation-identifiers-to-ids.util';
-import { type UniversalFlatMyEntity } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-my-entity.type';
-import { type FlatMyEntity } from 'src/engine/metadata-modules/flat-my-entity/types/flat-my-entity.type';
-import { type AllFlatEntityMapsByMetadataName } from 'src/engine/metadata-modules/flat-entity/types/all-flat-entity-maps-by-metadata-name.type';
-
-export const fromUniversalFlatMyEntityToFlatMyEntity = (
-  universalFlatMyEntity: UniversalFlatMyEntity,
-  flatEntityMaps: AllFlatEntityMapsByMetadataName,
-): FlatMyEntity => {
-  // Resolve universal foreign keys back to regular IDs
-  return resolveUniversalRelationIdentifiersToIds({
-    metadataName: 'myEntity',
-    universalFlatEntity: universalFlatMyEntity,
-    flatEntityMaps,
-  }) as FlatMyEntity;
-};
-```
-
-**Key utility**:
-- `resolveUniversalRelationIdentifiersToIds`: Maps universal identifiers → regular IDs (reverse of `resolveEntityRelationUniversalIdentifiers`)
-
----
-
-## Action Handler Patterns
-
-### Pattern: Create Handler
-```typescript
-// 1. Transpile: Universal → Flat
-protected transpileUniversalActionToFlatAction(
-  universalAction,
-  flatEntityMaps,
-) {
-  return {
-    type: 'create',
-    metadataName: 'myEntity',
-    flatEntity: fromUniversalFlatMyEntityToFlatMyEntity(
-      universalAction.universalFlatEntity,
-      flatEntityMaps,
-    ),
-  };
-}
-
-// 2. Execute: Flat → Database
-protected async executeForMetadata(flatActions) {
-  await this.insertFlatEntitiesInRepository({
-    repository: this.myEntityRepository,
-    flatEntities: flatActions.map(a => a.flatEntity),
-  });
-}
-```
-
-### Pattern: Update Handler
-```typescript
-// Transpile with update-specific resolution
-protected transpileUniversalActionToFlatAction(
-  universalAction,
-  flatEntityMaps,
-) {
-  const flatEntity = fromUniversalFlatMyEntityToFlatMyEntity(
-    universalAction.universalFlatEntity,
-    flatEntityMaps,
-  );
-
-  const flatUpdates = resolveUniversalUpdateRelationIdentifiersToIds({
-    metadataName: 'myEntity',
-    universalUpdates: universalAction.universalUpdates,
-    flatEntityMaps,
-  });
-
-  return { type: 'update', metadataName: 'myEntity', flatEntity, updates: flatUpdates };
-}
-```
-
-### Pattern: Delete Handler
-```typescript
-// Use base class helper
-protected transpileUniversalActionToFlatAction(
-  universalAction,
-  flatEntityMaps,
-) {
-  return this.transpileUniversalDeleteActionToFlatDeleteAction({
-    universalAction,
-    flatEntityMaps,
-    fromUniversalFlatEntityToFlatEntity: fromUniversalFlatMyEntityToFlatMyEntity,
-  });
-}
-
-// Delete
-protected async executeForMetadata(flatActions) {
-  const ids = flatActions.map(a => a.flatEntity.id);
-  await this.myEntityRepository.delete(ids);
-}
-```
-
----
-
-## Checklist
-
-Before moving to Step 5:
-
-- [ ] Create action handler implemented
-- [ ] Update action handler implemented
-- [ ] Delete action handler implemented
-- [ ] All handlers extend appropriate base class
-- [ ] `transpileUniversalActionToFlatAction` implemented in all handlers
-- [ ] `executeForMetadata` implemented in all handlers
-- [ ] `executeForWorkspaceSchema` implemented (or returns empty)
-- [ ] Universal-to-flat conversion utility created
-- [ ] Create handler uses `insertFlatEntitiesInRepository`
-- [ ] Update handler uses `resolveUniversalUpdateRelationIdentifiersToIds`
-- [ ] Delete handler uses `transpileUniversalDeleteActionToFlatDeleteAction`
-- [ ] Delete handler uses hard delete (`delete()`)
-
----
-
-## Next Step
-
-Once action handlers are complete, proceed to:
-**[Syncable Entity: Integration (Step 5/6)](../syncable-entity-integration/SKILL.md)**
-
-For complete workflow, see `@creating-syncable-entity` rule.

.cursor/skills/syncable-entity-testing/SKILL.md

@@ -1,494 +0,0 @@
----
-name: syncable-entity-testing
-description: Create comprehensive integration tests for syncable entities in Twenty. Use when writing integration tests for metadata entities, covering validator exceptions, input transpilation errors, and CRUD operations. Tests are MANDATORY for all syncable entities.
----
-
-# Syncable Entity: Integration Testing (Step 6/6 - MANDATORY)
-
-**Purpose**: Create comprehensive test suite covering all validation scenarios, input transpilation exceptions, and successful use cases.
-
-**When to use**: After completing Steps 1-5. Integration tests are **REQUIRED** for all syncable entities.
-
----
-
-## Quick Start
-
-Tests must cover:
-1. **Failing scenarios** - All validator exceptions and input transpilation errors
-2. **Successful scenarios** - All CRUD operations and edge cases
-3. **Test utilities** - Reusable query factories and helper functions
-
-**Test pattern**: Two-file pattern (query factory + wrapper) for each operation.
-
----
-
-## Step 1: Create Test Utilities
-
-### Pattern: Query Factory
-
-**File**: `test/integration/metadata/suites/my-entity/utils/create-my-entity-query-factory.util.ts`
-
-```typescript
-import gql from 'graphql-tag';
-import { type PerformMetadataQueryParams } from 'test/integration/metadata/types/perform-metadata-query.type';
-import { type CreateMyEntityInput } from 'src/engine/metadata-modules/my-entity/dtos/create-my-entity.input';
-
-export type CreateMyEntityFactoryInput = CreateMyEntityInput;
-
-const DEFAULT_MY_ENTITY_GQL_FIELDS = `
-  id
-  name
-  label
-  description
-  isCustom
-  createdAt
-  updatedAt
-`;
-
-export const createMyEntityQueryFactory = ({
-  input,
-  gqlFields = DEFAULT_MY_ENTITY_GQL_FIELDS,
-}: PerformMetadataQueryParams<CreateMyEntityFactoryInput>) => ({
-  query: gql`
-    mutation CreateMyEntity($input: CreateMyEntityInput!) {
-      createMyEntity(input: $input) {
-        ${gqlFields}
-      }
-    }
-  `,
-  variables: {
-    input,
-  },
-});
-```
-
-### Pattern: Wrapper Utility
-
-**File**: `test/integration/metadata/suites/my-entity/utils/create-my-entity.util.ts`
-
-```typescript
-import {
-  type CreateMyEntityFactoryInput,
-  createMyEntityQueryFactory,
-} from 'test/integration/metadata/suites/my-entity/utils/create-my-entity-query-factory.util';
-import { makeMetadataAPIRequest } from 'test/integration/metadata/suites/utils/make-metadata-api-request.util';
-import { type CommonResponseBody } from 'test/integration/metadata/types/common-response-body.type';
-import { type PerformMetadataQueryParams } from 'test/integration/metadata/types/perform-metadata-query.type';
-import { warnIfErrorButNotExpectedToFail } from 'test/integration/metadata/utils/warn-if-error-but-not-expected-to-fail.util';
-import { warnIfNoErrorButExpectedToFail } from 'test/integration/metadata/utils/warn-if-no-error-but-expected-to-fail.util';
-import { type MyEntityDto } from 'src/engine/metadata-modules/my-entity/dtos/my-entity.dto';
-
-export const createMyEntity = async ({
-  input,
-  gqlFields,
-  expectToFail = false,
-  token,
-}: PerformMetadataQueryParams<CreateMyEntityFactoryInput>): CommonResponseBody<{
-  createMyEntity: MyEntityDto;
-}> => {
-  const graphqlOperation = createMyEntityQueryFactory({
-    input,
-    gqlFields,
-  });
-
-  const response = await makeMetadataAPIRequest(graphqlOperation, token);
-
-  if (expectToFail === true) {
-    warnIfNoErrorButExpectedToFail({
-      response,
-      errorMessage: 'My entity creation should have failed but did not',
-    });
-  }
-
-  if (expectToFail === false) {
-    warnIfErrorButNotExpectedToFail({
-      response,
-      errorMessage: 'My entity creation has failed but should not',
-    });
-  }
-
-  return { data: response.body.data, errors: response.body.errors };
-};
-```
-
-**Required utilities** (follow same pattern):
-- `update-my-entity-query-factory.util.ts` + `update-my-entity.util.ts`
-- `delete-my-entity-query-factory.util.ts` + `delete-my-entity.util.ts`
-
----
-
-## Step 2: Failing Creation Tests
-
-**File**: `test/integration/metadata/suites/my-entity/failing-my-entity-creation.integration-spec.ts`
-
-```typescript
-import { expectOneNotInternalServerErrorSnapshot } from 'test/integration/graphql/utils/expect-one-not-internal-server-error-snapshot.util';
-import { createMyEntity } from 'test/integration/metadata/suites/my-entity/utils/create-my-entity.util';
-import { deleteMyEntity } from 'test/integration/metadata/suites/my-entity/utils/delete-my-entity.util';
-import {
-  eachTestingContextFilter,
-  type EachTestingContext,
-} from 'twenty-shared/testing';
-import { isDefined } from 'twenty-shared/utils';
-import { type CreateMyEntityInput } from 'src/engine/metadata-modules/my-entity/dtos/create-my-entity.input';
-
-type TestContext = {
-  input: CreateMyEntityInput;
-};
-
-type GlobalTestContext = {
-  existingEntityLabel: string;
-  existingEntityName: string;
-};
-
-const globalTestContext: GlobalTestContext = {
-  existingEntityLabel: 'Existing Test Entity',
-  existingEntityName: 'existingTestEntity',
-};
-
-type CreateMyEntityTestingContext = EachTestingContext<TestContext>[];
-
-describe('My entity creation should fail', () => {
-  let existingEntityId: string | undefined;
-
-  beforeAll(async () => {
-    // Setup: Create entity for uniqueness tests
-    const { data } = await createMyEntity({
-      expectToFail: false,
-      input: {
-        name: globalTestContext.existingEntityName,
-        label: globalTestContext.existingEntityLabel,
-      },
-    });
-
-    existingEntityId = data.createMyEntity.id;
-  });
-
-  afterAll(async () => {
-    // Cleanup
-    if (isDefined(existingEntityId)) {
-      await deleteMyEntity({
-        expectToFail: false,
-        input: { id: existingEntityId },
-      });
-    }
-  });
-
-  const failingMyEntityCreationTestCases: CreateMyEntityTestingContext = [
-    // Input transpilation validation
-    {
-      title: 'when name is missing',
-      context: {
-        input: {
-          label: 'Entity Missing Name',
-        } as CreateMyEntityInput,
-      },
-    },
-    {
-      title: 'when label is missing',
-      context: {
-        input: {
-          name: 'entityMissingLabel',
-        } as CreateMyEntityInput,
-      },
-    },
-    {
-      title: 'when name is empty string',
-      context: {
-        input: {
-          name: '',
-          label: 'Empty Name Entity',
-        },
-      },
-    },
-
-    // Validator business logic
-    {
-      title: 'when name already exists (uniqueness)',
-      context: {
-        input: {
-          name: globalTestContext.existingEntityName,
-          label: 'Duplicate Name Entity',
-        },
-      },
-    },
-    {
-      title: 'when trying to create standard entity',
-      context: {
-        input: {
-          name: 'myEntity',
-          label: 'Standard Entity',
-          isCustom: false,
-        } as CreateMyEntityInput,
-      },
-    },
-
-    // Foreign key validation
-    {
-      title: 'when parentEntityId does not exist',
-      context: {
-        input: {
-          name: 'invalidParentEntity',
-          label: 'Invalid Parent Entity',
-          parentEntityId: '00000000-0000-0000-0000-000000000000',
-        },
-      },
-    },
-  ];
-
-  it.each(eachTestingContextFilter(failingMyEntityCreationTestCases))(
-    '$title',
-    async ({ context }) => {
-      const { errors } = await createMyEntity({
-        expectToFail: true,
-        input: context.input,
-      });
-
-      expectOneNotInternalServerErrorSnapshot({
-        errors,
-      });
-    },
-  );
-});
-```
-
-**Test coverage requirements**:
-- ✅ Missing required fields
-- ✅ Empty strings
-- ✅ Invalid format
-- ✅ Uniqueness violations
-- ✅ Standard entity protection
-- ✅ Foreign key validation
-
----
-
-## Step 3: Successful Creation Tests
-
-**File**: `test/integration/metadata/suites/my-entity/successful-my-entity-creation.integration-spec.ts`
-
-```typescript
-import { createMyEntity } from 'test/integration/metadata/suites/my-entity/utils/create-my-entity.util';
-import { deleteMyEntity } from 'test/integration/metadata/suites/my-entity/utils/delete-my-entity.util';
-import { type CreateMyEntityInput } from 'src/engine/metadata-modules/my-entity/dtos/create-my-entity.input';
-
-describe('My entity creation should succeed', () => {
-  let createdEntityId: string;
-
-  afterEach(async () => {
-    if (createdEntityId) {
-      await deleteMyEntity({
-        expectToFail: false,
-        input: { id: createdEntityId },
-      });
-    }
-  });
-
-  it('should create entity with minimal required input', async () => {
-    const { data } = await createMyEntity({
-      expectToFail: false,
-      input: {
-        name: 'minimalEntity',
-        label: 'Minimal Entity',
-      },
-    });
-
-    createdEntityId = data?.createMyEntity?.id;
-
-    expect(data.createMyEntity).toMatchObject({
-      id: expect.any(String),
-      name: 'minimalEntity',
-      label: 'Minimal Entity',
-      description: null,
-      isCustom: true,
-      createdAt: expect.any(String),
-      updatedAt: expect.any(String),
-    });
-  });
-
-  it('should create entity with all optional fields', async () => {
-    const input = {
-      name: 'fullEntity',
-      label: 'Full Entity',
-      description: 'Entity with all fields specified',
-    } as const satisfies CreateMyEntityInput;
-
-    const { data } = await createMyEntity({
-      expectToFail: false,
-      input,
-    });
-
-    createdEntityId = data?.createMyEntity?.id;
-
-    expect(data.createMyEntity).toMatchObject({
-      id: expect.any(String),
-      name: 'fullEntity',
-      label: 'Full Entity',
-      description: 'Entity with all fields specified',
-      isCustom: true,
-    });
-  });
-
-  it('should sanitize input by trimming whitespace', async () => {
-    const { data } = await createMyEntity({
-      expectToFail: false,
-      input: {
-        name: '  entityWithSpaces  ',
-        label: '  Entity With Spaces  ',
-        description: '  Description with spaces  ',
-      },
-    });
-
-    createdEntityId = data?.createMyEntity?.id;
-
-    expect(data.createMyEntity).toMatchObject({
-      id: expect.any(String),
-      name: 'entityWithSpaces',
-      label: 'Entity With Spaces',
-      description: 'Description with spaces',
-    });
-  });
-
-  it('should handle long text content', async () => {
-    const longDescription = 'A'.repeat(1000);
-
-    const { data } = await createMyEntity({
-      expectToFail: false,
-      input: {
-        name: 'longDescEntity',
-        label: 'Long Description Entity',
-        description: longDescription,
-      },
-    });
-
-    createdEntityId = data?.createMyEntity?.id;
-
-    expect(data.createMyEntity).toMatchObject({
-      id: expect.any(String),
-      description: longDescription,
-    });
-  });
-});
-```
-
-**Test coverage requirements**:
-- ✅ Minimal required input
-- ✅ All optional fields
-- ✅ Input sanitization
-- ✅ Long text content
-- ✅ Special characters
-
----
-
-## Step 4: Update and Delete Tests
-
-Create similar test files for update and delete operations:
-
-**Required files**:
-- `failing-my-entity-update.integration-spec.ts`
-- `successful-my-entity-update.integration-spec.ts`
-- `failing-my-entity-deletion.integration-spec.ts`
-- `successful-my-entity-deletion.integration-spec.ts`
-
----
-
-## Testing Best Practices
-
-### Pattern: Cleanup
-```typescript
-afterEach(async () => {
-  if (createdEntityId) {
-    await deleteMyEntity({
-      expectToFail: false,
-      input: { id: createdEntityId },
-    });
-  }
-});
-```
-
-### Pattern: Type-Safe Inputs
-```typescript
-const input = {
-  name: 'myEntity',
-  label: 'My Entity',
-} as const satisfies CreateMyEntityInput;
-```
-
-### Pattern: Snapshot Testing
-```typescript
-expectOneNotInternalServerErrorSnapshot({
-  errors,
-});
-```
-
----
-
-## Running Tests
-
-```bash
-# Run all entity tests
-npx jest test/integration/metadata/suites/my-entity --config=packages/twenty-server/jest.config.mjs
-
-# Run specific test file
-npx jest test/integration/metadata/suites/my-entity/failing-my-entity-creation.integration-spec.ts --config=packages/twenty-server/jest.config.mjs
-
-# Update snapshots
-npx jest test/integration/metadata/suites/my-entity --updateSnapshot --config=packages/twenty-server/jest.config.mjs
-```
-
----
-
-## Complete Test Checklist
-
-### Test Utilities
-- [ ] `create-my-entity-query-factory.util.ts` created
-- [ ] `create-my-entity.util.ts` created
-- [ ] `update-my-entity-query-factory.util.ts` created
-- [ ] `update-my-entity.util.ts` created
-- [ ] `delete-my-entity-query-factory.util.ts` created
-- [ ] `delete-my-entity.util.ts` created
-
-### Failing Tests Coverage
-- [ ] Missing required fields
-- [ ] Empty string validation
-- [ ] Uniqueness violations
-- [ ] Standard entity protection
-- [ ] Foreign key validation
-- [ ] JSONB property validation (if applicable)
-
-### Successful Tests Coverage
-- [ ] Create with minimal input
-- [ ] Create with all optional fields
-- [ ] Input sanitization (whitespace)
-- [ ] Long text content
-- [ ] Update single field
-- [ ] Update multiple fields
-- [ ] Successful deletion
-
-### Snapshot Tests
-- [ ] All failing tests use `expectOneNotInternalServerErrorSnapshot`
-- [ ] Snapshots committed to `__snapshots__/` directory
-
----
-
-## Success Criteria
-
-Your integration tests are complete when:
-
-✅ All test utilities created (minimum 6 files)
-✅ Failing creation tests cover all validators
-✅ Failing update tests cover business rules
-✅ Failing deletion tests cover protection rules
-✅ Successful tests cover all use cases
-✅ All snapshots generated and committed
-✅ All tests pass consistently
-✅ Test coverage meets requirements (>80%)
-
----
-
-## Final Step
-
-✅ **Step 6 Complete!** → Your syncable entity is fully tested and production-ready!
-
-**Congratulations!** You've successfully created a new syncable entity in Twenty's workspace migration system.
-
-For complete workflow, see `@creating-syncable-entity` rule.

.cursor/skills/syncable-entity-types-and-constants/SKILL.md

@@ -1,340 +0,0 @@
----
-name: syncable-entity-types-and-constants
-description: Define types, entities, and central constant registrations for syncable entities in Twenty's workspace migration system. Use when creating new syncable entities, defining TypeORM entities, flat entity types, or registering in central constants (ALL_ENTITY_PROPERTIES_CONFIGURATION_BY_METADATA_NAME, ALL_ONE_TO_MANY_METADATA_RELATIONS, ALL_MANY_TO_ONE_METADATA_FOREIGN_KEY, ALL_MANY_TO_ONE_METADATA_RELATIONS).
----
-
-# Syncable Entity: Types & Constants (Step 1/6)
-
-**Purpose**: Define all types, entities, and register in central constants. This is the foundation - everything else depends on these types being correct.
-
-**When to use**: First step when creating any new syncable entity. Must be completed before other steps.
-
----
-
-## Quick Start
-
-This step creates:
-1. Metadata name constant (twenty-shared)
-2. TypeORM entity (extends `SyncableEntity`)
-3. Flat entity types
-4. Action types (universal + flat)
-5. Central constant registrations (5 constants)
-
----
-
-## Step 1: Add Metadata Name
-
-**File**: `packages/twenty-shared/src/metadata/all-metadata-name.constant.ts`
-
-```typescript
-export const ALL_METADATA_NAME = {
-  // ... existing entries
-  myEntity: 'myEntity',
-} as const;
-```
-
----
-
-## Step 2: Create TypeORM Entity
-
-**File**: `src/engine/metadata-modules/my-entity/entities/my-entity.entity.ts`
-
-```typescript
-import { Entity, Column, ManyToOne, JoinColumn } from 'typeorm';
-import { SyncableEntity } from 'src/engine/workspace-manager/types/syncable-entity.interface';
-
-@Entity({ name: 'myEntity' })
-export class MyEntityEntity extends SyncableEntity {
-  @Column({ type: 'varchar' })
-  name: string;
-
-  @Column({ type: 'varchar' })
-  label: string;
-
-  @Column({ type: 'boolean', default: true })
-  isCustom: boolean;
-
-  // Foreign key example (optional)
-  @Column({ type: 'uuid', nullable: true })
-  parentEntityId: string | null;
-
-  @ManyToOne(() => ParentEntityEntity, { nullable: true })
-  @JoinColumn({ name: 'parentEntityId' })
-  parentEntity: ParentEntityEntity | null;
-
-  // JSONB column example (optional)
-  @Column({ type: 'jsonb', nullable: true })
-  settings: Record<string, any> | null;
-}
-```
-
-**Key rules**:
-- Must extend `SyncableEntity` (provides `id`, `universalIdentifier`, `applicationId`, etc.)
-- Must have `isCustom` boolean column
-- Use `@Column({ type: 'jsonb' })` for JSON data
-
----
-
-## Step 3: Define Flat Entity Types
-
-**File**: `src/engine/metadata-modules/flat-my-entity/types/flat-my-entity.type.ts`
-
-```typescript
-import { type FlatEntityFrom } from 'src/engine/metadata-modules/flat-entity/types/flat-entity-from.type';
-import { type MyEntityEntity } from 'src/engine/metadata-modules/my-entity/entities/my-entity.entity';
-
-export type FlatMyEntity = FlatEntityFrom<MyEntityEntity>;
-```
-
-**Maps file** (if entity has indexed lookups):
-
-```typescript
-// flat-my-entity-maps.type.ts
-export type FlatMyEntityMaps = {
-  byId: Record<string, FlatMyEntity>;
-  byName: Record<string, FlatMyEntity>;
-  // Add other indexes as needed
-};
-```
-
----
-
-## Step 4: Define Editable Properties
-
-**File**: `src/engine/metadata-modules/flat-my-entity/constants/editable-flat-my-entity-properties.constant.ts`
-
-```typescript
-export const EDITABLE_FLAT_MY_ENTITY_PROPERTIES = [
-  'name',
-  'label',
-  'description',
-  'parentEntityId',
-  'settings',
-] as const satisfies ReadonlyArray<keyof FlatMyEntity>;
-```
-
-**Rule**: Only include properties that can be updated (exclude `id`, `createdAt`, `universalIdentifier`, etc.)
-
----
-
-## Step 5: Define Action Types
-
-**File**: `src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/my-entity/types/workspace-migration-my-entity-action.type.ts`
-
-```typescript
-import { type FlatMyEntity } from 'src/engine/metadata-modules/flat-my-entity/types/flat-my-entity.type';
-import { type UniversalFlatMyEntity } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-my-entity.type';
-
-// Universal actions (used by builder/runner)
-export type UniversalCreateMyEntityAction = {
-  type: 'create';
-  metadataName: 'myEntity';
-  universalFlatEntity: UniversalFlatMyEntity;
-};
-
-export type UniversalUpdateMyEntityAction = {
-  type: 'update';
-  metadataName: 'myEntity';
-  universalFlatEntity: UniversalFlatMyEntity;
-  universalUpdates: Partial<UniversalFlatMyEntity>;
-};
-
-export type UniversalDeleteMyEntityAction = {
-  type: 'delete';
-  metadataName: 'myEntity';
-  universalFlatEntity: UniversalFlatMyEntity;
-};
-
-// Flat actions (internal to runner)
-export type FlatCreateMyEntityAction = {
-  type: 'create';
-  metadataName: 'myEntity';
-  flatEntity: FlatMyEntity;
-};
-
-export type FlatUpdateMyEntityAction = {
-  type: 'update';
-  metadataName: 'myEntity';
-  flatEntity: FlatMyEntity;
-  updates: Partial<FlatMyEntity>;
-};
-
-export type FlatDeleteMyEntityAction = {
-  type: 'delete';
-  metadataName: 'myEntity';
-  flatEntity: FlatMyEntity;
-};
-```
-
----
-
-## Step 6: Register in Central Constants
-
-### 6a. AllFlatEntityTypesByMetadataName
-
-**File**: `src/engine/metadata-modules/flat-entity/types/all-flat-entity-types-by-metadata-name.ts`
-
-```typescript
-export type AllFlatEntityTypesByMetadataName = {
-  // ... existing entries
-  myEntity: {
-    flatEntityMaps: FlatMyEntityMaps;
-    universalActions: {
-      create: UniversalCreateMyEntityAction;
-      update: UniversalUpdateMyEntityAction;
-      delete: UniversalDeleteMyEntityAction;
-    };
-    flatActions: {
-      create: FlatCreateMyEntityAction;
-      update: FlatUpdateMyEntityAction;
-      delete: FlatDeleteMyEntityAction;
-    };
-    flatEntity: FlatMyEntity;
-    universalFlatEntity: UniversalFlatMyEntity;
-    entity: MyEntityEntity;
-  };
-};
-```
-
-### 6b. ALL_ENTITY_PROPERTIES_CONFIGURATION_BY_METADATA_NAME
-
-**File**: `src/engine/metadata-modules/flat-entity/constant/all-entity-properties-configuration-by-metadata-name.constant.ts`
-
-```typescript
-export const ALL_ENTITY_PROPERTIES_CONFIGURATION_BY_METADATA_NAME = {
-  // ... existing entries
-  myEntity: {
-    name: { toCompare: true },
-    label: { toCompare: true },
-    description: { toCompare: true },
-    parentEntityId: {
-      toCompare: true,
-      universalProperty: 'parentEntityUniversalIdentifier',
-    },
-    settings: {
-      toCompare: true,
-      toStringify: true,
-      universalProperty: 'universalSettings',
-    },
-  },
-} as const;
-```
-
-**Rules**:
-- `toCompare: true` → Editable property (checked for changes)
-- `toStringify: true` → JSONB/object property (needs JSON serialization)
-- `universalProperty` → Maps to universal version (for foreign keys & JSONB with `SerializedRelation`)
-
-### 6c. ALL_ONE_TO_MANY_METADATA_RELATIONS
-
-**File**: `src/engine/metadata-modules/flat-entity/constant/all-one-to-many-metadata-relations.constant.ts`
-
-This constant is **type-checked** — values for `metadataName`, `flatEntityForeignKeyAggregator`, and `universalFlatEntityForeignKeyAggregator` are derived from entity type definitions. The aggregator names follow the pattern: remove trailing `'s'` from the relation property name, then append `Ids` or `UniversalIdentifiers`.
-
-```typescript
-export const ALL_ONE_TO_MANY_METADATA_RELATIONS = {
-  // ... existing entries
-  myEntity: {
-    // If myEntity has a `childEntities: ChildEntityEntity[]` property:
-    childEntities: {
-      metadataName: 'childEntity',
-      flatEntityForeignKeyAggregator: 'childEntityIds',
-      universalFlatEntityForeignKeyAggregator: 'childEntityUniversalIdentifiers',
-    },
-    // null for relations to non-syncable entities
-    someNonSyncableRelation: null,
-  },
-} as const;
-```
-
-### 6d. ALL_MANY_TO_ONE_METADATA_FOREIGN_KEY
-
-**File**: `src/engine/metadata-modules/flat-entity/constant/all-many-to-one-metadata-foreign-key.constant.ts`
-
-Low-level primitive constant. Only contains `foreignKey` — the column name ending in `Id` that stores the foreign key. Type-checked against entity properties.
-
-```typescript
-export const ALL_MANY_TO_ONE_METADATA_FOREIGN_KEY = {
-  // ... existing entries
-  myEntity: {
-    workspace: null,
-    application: null,
-    parentEntity: {
-      foreignKey: 'parentEntityId',
-    },
-  },
-} as const;
-```
-
-### 6e. ALL_MANY_TO_ONE_METADATA_RELATIONS
-
-**File**: `src/engine/metadata-modules/flat-entity/constant/all-many-to-one-metadata-relations.constant.ts`
-
-Derived from both `ALL_MANY_TO_ONE_METADATA_FOREIGN_KEY` (for `foreignKey` type and `universalForeignKey` derivation) and `ALL_ONE_TO_MANY_METADATA_RELATIONS` (for `inverseOneToManyProperty` key constraint). This is the main constant consumed by utils and optimistic tooling.
-
-```typescript
-export const ALL_MANY_TO_ONE_METADATA_RELATIONS = {
-  // ... existing entries
-  myEntity: {
-    workspace: null,
-    application: null,
-    parentEntity: {
-      metadataName: 'parentEntity',
-      foreignKey: 'parentEntityId',
-      inverseOneToManyProperty: 'myEntities',  // key in ALL_ONE_TO_MANY_METADATA_RELATIONS['parentEntity'], or null if no inverse
-      isNullable: false,
-      universalForeignKey: 'parentEntityUniversalIdentifier',
-    },
-  },
-} as const;
-```
-
-**Derivation dependency graph**:
-
-```
-ALL_MANY_TO_ONE_METADATA_FOREIGN_KEY     ALL_ONE_TO_MANY_METADATA_RELATIONS
-(foreignKey only)                        (metadataName, aggregators)
-  │                                        │
-  │ FK type + universalFK derivation       │ inverseOneToManyProperty keys
-  │                                        │
-  └────────────────┬───────────────────────┘
-                   ▼
-    ALL_MANY_TO_ONE_METADATA_RELATIONS
-    (metadataName, foreignKey, inverseOneToManyProperty,
-     isNullable, universalForeignKey)
-```
-
-**Rules**:
-- `workspace: null`, `application: null` — always present, always null (non-syncable relations)
-- `inverseOneToManyProperty` — must be a key in `ALL_ONE_TO_MANY_METADATA_RELATIONS[targetMetadataName]`, or `null` if the target entity doesn't expose an inverse one-to-many relation
-- `universalForeignKey` — derived from `foreignKey` by replacing the `Id` suffix with `UniversalIdentifier`
-- Optimistic utils resolve `flatEntityForeignKeyAggregator` / `universalFlatEntityForeignKeyAggregator` at runtime by looking up `inverseOneToManyProperty` in `ALL_ONE_TO_MANY_METADATA_RELATIONS`
-
----
-
-## Checklist
-
-Before moving to Step 2:
-
-- [ ] Metadata name added to `ALL_METADATA_NAME`
-- [ ] TypeORM entity created (extends `SyncableEntity`)
-- [ ] `isCustom` column added
-- [ ] Flat entity type defined
-- [ ] Flat entity maps type defined (if needed)
-- [ ] Editable properties constant defined
-- [ ] Universal and flat action types defined
-- [ ] Registered in `AllFlatEntityTypesByMetadataName`
-- [ ] Registered in `ALL_ENTITY_PROPERTIES_CONFIGURATION_BY_METADATA_NAME`
-- [ ] Registered in `ALL_ONE_TO_MANY_METADATA_RELATIONS` (if entity has one-to-many relations)
-- [ ] Registered in `ALL_MANY_TO_ONE_METADATA_FOREIGN_KEY`
-- [ ] Registered in `ALL_MANY_TO_ONE_METADATA_RELATIONS`
-- [ ] TypeScript compiles without errors
-
----
-
-## Next Step
-
-Once all types and constants are defined, proceed to:
-**[Syncable Entity: Cache & Transform (Step 2/6)](../syncable-entity-cache-and-transform/SKILL.md)**
-
-For complete workflow, see `@creating-syncable-entity` rule.

.github/crowdin-app.yml

@@ -5,7 +5,6 @@
 #
 
 "preserve_hierarchy": true
-"base_path": ".."
 
 files: [
   {

.github/crowdin-docs.yml

@@ -6,7 +6,6 @@
 "project_id": 2
 "preserve_hierarchy": true
 "base_url": "https://twenty.api.crowdin.com"
-"base_path": ".."
 
 files: [
   {

.github/dependabot.yml

@@ -2,8 +2,6 @@ version: 2
 updates:
   - package-ecosystem: "npm"
     directory: "/"
-    exclude-paths:
-      - "packages/twenty-apps/community/**"
     schedule:
       interval: "weekly"
     open-pull-requests-limit: 3

.github/workflows/ci-create-app.yaml

@@ -20,7 +20,6 @@ jobs:
     with:
       files: |
         packages/create-twenty-app/**
-        !packages/create-twenty-app/package.json
   create-app-test:
     needs: changed-files-check
     if: needs.changed-files-check.outputs.any_changed == 'true'

.github/workflows/ci-emails.yaml

@@ -25,7 +25,7 @@ jobs:
     needs: changed-files-check
     if: needs.changed-files-check.outputs.any_changed == 'true'
     timeout-minutes: 10
-    runs-on: ubuntu-latest-8-cores
+    runs-on: depot-ubuntu-24.04-8
     steps:
       - name: Fetch custom Github Actions and base branch history
         uses: actions/checkout@v4

.github/workflows/ci-front.yaml

@@ -14,8 +14,8 @@ concurrency:
 
 env:
   # restore-cache action adds 'v4-' prefix and '-<branch>-<sha>' suffix to the key
-  STORYBOOK_BUILD_CACHE_KEY_FOR_RESTORE_ACTION: storybook-build-ubuntu-latest-8-cores-runner
-  STORYBOOK_BUILD_CACHE_KEY_FOR_SAVE_ACTION: v4-storybook-build-ubuntu-latest-8-cores-runner-${{ github.ref_name }}-${{ github.sha }}
+  STORYBOOK_BUILD_CACHE_KEY_FOR_RESTORE_ACTION: storybook-build-depot-ubuntu-24.04-8-runner
+  STORYBOOK_BUILD_CACHE_KEY_FOR_SAVE_ACTION: v4-storybook-build-depot-ubuntu-24.04-8-runner-${{ github.ref_name }}-${{ github.sha }}
 
 jobs:
   changed-files-check:
@@ -27,22 +27,18 @@ jobs:
         packages/twenty-front/**
         packages/twenty-ui/**
         packages/twenty-shared/**
-        packages/twenty-sdk/**
-        !packages/twenty-sdk/package.json
   changed-files-check-e2e:
     uses: ./.github/workflows/changed-files.yaml
     with:
       files: |
         packages/**
-        !packages/create-twenty-app/package.json
-        !packages/twenty-sdk/package.json
         playwright.config.ts
         .github/workflows/ci-front.yaml
   front-sb-build:
     needs: changed-files-check
     if: needs.changed-files-check.outputs.any_changed == 'true'
     timeout-minutes: 30
-    runs-on: ubuntu-latest-8-cores
+    runs-on: depot-ubuntu-24.04-8
     env:
       REACT_APP_SERVER_BASE_URL: http://localhost:3000
     steps:
@@ -60,6 +56,8 @@ jobs:
         run: df -h
       - name: Front / Write .env
         run: npx nx reset:env twenty-front
+      - name: Front / Clean storybook-static
+        run: rm -rf packages/twenty-front/storybook-static
       - name: Front / Build storybook
         run: npx nx storybook:build twenty-front
       - name: Save storybook build cache
@@ -68,7 +66,7 @@ jobs:
           key: ${{ env.STORYBOOK_BUILD_CACHE_KEY_FOR_SAVE_ACTION }}
   front-sb-test:
     timeout-minutes: 30
-    runs-on: ubuntu-latest-8-cores
+    runs-on: depot-ubuntu-24.04-8
     needs: front-sb-build
     strategy:
       fail-fast: false
@@ -85,28 +83,18 @@ jobs:
           fetch-depth: 0
       - name: Install dependencies
         uses: ./.github/actions/yarn-install
-      - name: Build dependencies
-        run: |
-          npx nx build twenty-shared
-          npx nx build twenty-ui
-          npx nx build twenty-sdk
       - name: Install Playwright
-        run: |
-          cd packages/twenty-front
-          npx playwright install
+        run: cd packages/twenty-front && npx playwright install
+      - name: Restore storybook build cache
+        uses: ./.github/actions/restore-cache
+        with:
+          key: ${{ env.STORYBOOK_BUILD_CACHE_KEY_FOR_RESTORE_ACTION }}
       - name: Front / Write .env
         run: npx nx reset:env twenty-front
       - name: Run storybook tests
-        run: npx nx storybook:test twenty-front --configuration=${{ matrix.storybook_scope }} --shard=${{ matrix.shard }}/${{ env.SHARD_COUNTER }}
+        run: npx nx storybook:serve-and-test:static twenty-front --configuration=${{ matrix.storybook_scope }} --shard=${{ matrix.shard }}/${{ env.SHARD_COUNTER }} --checkCoverage=false
       - name: Rename coverage file
-        run: |
-          if [ -f "packages/twenty-front/coverage/storybook/coverage-final.json" ]; then
-            mv packages/twenty-front/coverage/storybook/coverage-final.json packages/twenty-front/coverage/storybook/coverage-shard-${{matrix.shard}}.json
-          else
-            echo "Error: coverage-final.json not found"
-            ls -la packages/twenty-front/coverage/storybook/ || echo "Coverage directory does not exist"
-            exit 1
-          fi
+        run: mv packages/twenty-front/coverage/storybook/coverage-storybook.json packages/twenty-front/coverage/storybook/coverage-shard-${{matrix.shard}}.json
       - name: Upload coverage artifact
         uses: actions/upload-artifact@v4
         with:
@@ -143,7 +131,7 @@ jobs:
     timeout-minutes: 30
     if: false
     needs: front-sb-build
-    runs-on: ubuntu-latest-8-cores
+    runs-on: depot-ubuntu-24.04-8
     env:
       REACT_APP_SERVER_BASE_URL: http://127.0.0.1:3000
       CHROMATIC_PROJECT_TOKEN: ${{ secrets.CHROMATIC_PROJECT_TOKEN }}
@@ -197,19 +185,10 @@ jobs:
           tag: scope:frontend
           tasks: reset:env
       - name: Run ${{ matrix.task }} task
-        id: run-task
         uses: ./.github/actions/nx-affected
         with:
           tag: scope:frontend
           tasks: ${{ matrix.task }}
-      - name: Check for coverage threshold failure
-        if: always() && steps.run-task.outcome == 'failure' && matrix.task == 'test'
-        shell: bash
-        run: |
-          echo "::error::The test task failed. If no individual test is failing, this is likely a coverage threshold not being met."
-          echo ""
-          echo "To debug locally, run: npx nx run twenty-front:test:ci"
-          exit 1
       - name: Save ${{ matrix.task }} cache
         uses: ./.github/actions/save-cache
         with:
@@ -218,7 +197,7 @@ jobs:
     needs: changed-files-check
     if: needs.changed-files-check.outputs.any_changed == 'true'
     timeout-minutes: 30
-    runs-on: ubuntu-latest-8-cores
+    runs-on: depot-ubuntu-24.04-8
     env:
       NODE_OPTIONS: "--max-old-space-size=10240"
     steps:

.github/workflows/ci-sdk.yaml

@@ -18,7 +18,6 @@ jobs:
     with:
       files: |
         packages/twenty-sdk/**
-        !packages/twenty-sdk/package.json
   sdk-test:
     needs: changed-files-check
     if: needs.changed-files-check.outputs.any_changed == 'true'
@@ -26,7 +25,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        task: [lint, typecheck, test:unit, storybook:build, storybook:test, test:integration]
+        task: [lint, typecheck, test]
     steps:
       - name: Cancel Previous Runs
         uses: styfle/cancel-workflow-action@0.11.0
@@ -40,9 +39,6 @@ jobs:
         uses: ./.github/actions/yarn-install
       - name: Build
         run: npx nx build twenty-sdk
-      - name: Install Playwright
-        if: contains(matrix.task, 'storybook')
-        run: npx playwright install chromium
       - name: Run ${{ matrix.task }} task
         uses: ./.github/actions/nx-affected
         with:
@@ -50,7 +46,7 @@ jobs:
           tasks: ${{ matrix.task }}
   sdk-e2e-test:
     timeout-minutes: 30
-    runs-on: ubuntu-latest-8-cores
+    runs-on: depot-ubuntu-24.04-8
     needs: [changed-files-check, sdk-test]
     if: needs.changed-files-check.outputs.any_changed == 'true'
     services:
@@ -81,16 +77,20 @@ jobs:
           fetch-depth: 0
       - name: Install dependencies
         uses: ./.github/actions/yarn-install
-      - name: Build
-        run: npx nx build twenty-sdk
+      - name: Server / Append billing config to .env.test
+        working-directory: packages/twenty-server
+        run: |
+          echo "" >> .env.test
+          echo "IS_BILLING_ENABLED=true" >> .env.test
+          echo "BILLING_STRIPE_API_KEY=test-api-key" >> .env.test
+          echo "BILLING_STRIPE_BASE_PLAN_PRODUCT_ID=test-base-plan-product-id" >> .env.test
+          echo "BILLING_STRIPE_WEBHOOK_SECRET=test-webhook-secret" >> .env.test
+          echo "BILLING_PLAN_REQUIRED_LINK=http://localhost:3001/stripe-redirection" >> .env.test
       - name: Server / Create Test DB
         run: |
           PGPASSWORD=postgres psql -h localhost -p 5432 -U postgres -d postgres -c 'CREATE DATABASE "test";'
-      - name: SDK / Run e2e Tests
-        uses: ./.github/actions/nx-affected
-        with:
-          tag: scope:sdk
-          tasks: test:e2e
+      - name: SDK / Run E2E Tests
+        run: npx nx test:e2e twenty-sdk
   ci-sdk-status-check:
     if: always() && !cancelled()
     timeout-minutes: 5

.github/workflows/ci-server.yaml

@@ -31,7 +31,7 @@ jobs:
     needs: changed-files-check
     if: needs.changed-files-check.outputs.any_changed == 'true'
     timeout-minutes: 30
-    runs-on: ubuntu-latest-8-cores
+    runs-on: depot-ubuntu-24.04-8
     services:
       postgres:
         image: twentycrm/twenty-postgres-spilo
@@ -143,7 +143,7 @@ jobs:
           key: ${{ steps.restore-server-setup-cache.outputs.cache-primary-key }}
   server-test:
     timeout-minutes: 30
-    runs-on: ubuntu-latest-8-cores
+    runs-on: depot-ubuntu-24.04-8
     needs: server-setup
     steps:
       - name: Fetch custom Github Actions and base branch history
@@ -164,7 +164,7 @@ jobs:
 
   server-integration-test:
     timeout-minutes: 30
-    runs-on: ubuntu-latest-8-cores
+    runs-on: depot-ubuntu-24.04-8
     needs: server-setup
     strategy:
       fail-fast: false

.github/workflows/claude.yml

@@ -1,174 +0,0 @@
-name: Claude Code
-
-on:
-  issue_comment:
-    types: [created]
-  pull_request_review_comment:
-    types: [created]
-  pull_request_review:
-    types: [submitted]
-  issues:
-    types: [opened, assigned]
-  repository_dispatch:
-    types: [claude-core-team-issues]
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.event.issue.number || github.event.pull_request.number || github.event.client_payload.issue_number }}
-  cancel-in-progress: false
-
-jobs:
-  claude:
-    if: |
-      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude') && github.event.comment.user.type != 'Bot') ||
-      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude') && github.event.comment.user.type != 'Bot') ||
-      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude') && github.event.review.user.type != 'Bot') ||
-      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
-    runs-on: ubuntu-latest
-    timeout-minutes: 60
-    permissions:
-      contents: write
-      pull-requests: write
-      issues: write
-      id-token: write
-    services:
-      postgres:
-        image: postgres:16
-        env:
-          POSTGRES_USER: postgres
-          POSTGRES_PASSWORD: postgres
-          POSTGRES_DB: postgres
-        ports:
-          - 5432:5432
-        options: >-
-          --health-cmd pg_isready
-          --health-interval 10s
-          --health-timeout 5s
-          --health-retries 5
-      redis:
-        image: redis
-        ports:
-          - 6379:6379
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-      - name: Install dependencies
-        uses: ./.github/actions/yarn-install
-      - name: Run Claude Code
-        id: claude-code
-        uses: anthropics/claude-code-action@v1
-        with:
-          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
-          additional_permissions: |
-            actions: read
-          claude_args: '--max-turns 200 --model opus --allowedTools "Edit,Write,WebFetch,Bash(bash packages/twenty-utils/setup-dev-env.sh),Bash(npx nx *),Bash(npx jest *),Bash(yarn *),Bash(git *),Bash(gh *),Bash(sed *),Bash(python3 *),Bash(rm *),Bash(find *),Bash(grep *),Bash(cat *),Bash(ls *),Bash(head *),Bash(tail *),Bash(wc *),Bash(sort *),Bash(uniq *),Bash(mkdir *),Bash(cp *),Bash(mv *),Bash(touch *),Bash(chmod *),Bash(echo *),Bash(curl *),Bash(cd *),Bash(pwd *),Bash(diff *),Bash(xargs *),Bash(awk *),Bash(cut *),Bash(tee *),Bash(tr *)"'
-          settings: |
-            {
-              "env": {
-                "PG_DATABASE_URL": "postgres://postgres:postgres@localhost:5432/default"
-              }
-            }
-      - name: Post Create-PR link if Claude ran out of turns
-        if: failure()
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          BRANCH=$(git branch --show-current)
-          if [ "$BRANCH" = "main" ] || [ "$BRANCH" = "" ]; then
-            exit 0
-          fi
-          AHEAD=$(git rev-list --count main.."$BRANCH" 2>/dev/null || echo "0")
-          if [ "$AHEAD" = "0" ]; then
-            exit 0
-          fi
-          EXISTING_PR=$(gh pr list --head "$BRANCH" --json number --jq '.[0].number' 2>/dev/null || echo "")
-          if [ -n "$EXISTING_PR" ]; then
-            exit 0
-          fi
-          ISSUE_NUMBER="${{ github.event.issue.number || github.event.pull_request.number }}"
-          ENCODED_BRANCH=$(python3 -c "import urllib.parse; print(urllib.parse.quote('$BRANCH', safe=''))")
-          PR_URL="https://github.com/${{ github.repository }}/compare/main...${ENCODED_BRANCH}?quick_pull=1"
-          BODY="⚠️ Claude ran out of turns before creating a PR. Work has been pushed to [\`$BRANCH\`](https://github.com/${{ github.repository }}/tree/$ENCODED_BRANCH).\n\n[**Create PR →**]($PR_URL)"
-          if [ -n "$ISSUE_NUMBER" ]; then
-            gh issue comment "$ISSUE_NUMBER" --body "$(echo -e "$BODY")"
-          fi
-
-  claude-cross-repo:
-    if: github.event_name == 'repository_dispatch'
-    runs-on: ubuntu-latest
-    timeout-minutes: 60
-    permissions:
-      contents: write
-      pull-requests: write
-      issues: write
-      id-token: write
-    services:
-      postgres:
-        image: postgres:16
-        env:
-          POSTGRES_USER: postgres
-          POSTGRES_PASSWORD: postgres
-          POSTGRES_DB: postgres
-        ports:
-          - 5432:5432
-        options: >-
-          --health-cmd pg_isready
-          --health-interval 10s
-          --health-timeout 5s
-          --health-retries 5
-      redis:
-        image: redis
-        ports:
-          - 6379:6379
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-      - name: Install dependencies
-        uses: ./.github/actions/yarn-install
-      - name: Build prompt from dispatch payload
-        id: prompt
-        uses: actions/github-script@v7
-        with:
-          script: |
-            const p = context.payload.client_payload;
-            let prompt;
-            if (p.comment_body) {
-              prompt = `You are responding to a comment on issue #${p.issue_number} ("${p.issue_title}") in the ${p.repo_full_name} repository.\n\nThe comment by @${p.sender} says:\n\n${p.comment_body}\n\nIssue body:\n\n${p.issue_body}\n\nPlease help with this request. The code you are working with is the twenty codebase (this repository).`;
-            } else {
-              prompt = `You are responding to issue #${p.issue_number} ("${p.issue_title}") in the ${p.repo_full_name} repository, opened by @${p.sender}.\n\nIssue body:\n\n${p.issue_body}\n\nPlease help with this request. The code you are working with is the twenty codebase (this repository).`;
-            }
-            core.setOutput('prompt', prompt);
-            core.setOutput('repo', p.repo_full_name);
-            core.setOutput('issue_number', p.issue_number);
-      - name: Run Claude Code
-        id: claude
-        uses: anthropics/claude-code-action@v1
-        with:
-          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
-          prompt: ${{ steps.prompt.outputs.prompt }}
-          additional_permissions: |
-            actions: read
-          claude_args: '--max-turns 200 --model opus --allowedTools "Edit,Write,WebFetch,Bash(bash packages/twenty-utils/setup-dev-env.sh),Bash(npx nx *),Bash(npx jest *),Bash(yarn *),Bash(git *),Bash(gh *),Bash(sed *),Bash(python3 *),Bash(rm *),Bash(find *),Bash(grep *),Bash(cat *),Bash(ls *),Bash(head *),Bash(tail *),Bash(wc *),Bash(sort *),Bash(uniq *),Bash(mkdir *),Bash(cp *),Bash(mv *),Bash(touch *),Bash(chmod *),Bash(echo *),Bash(curl *),Bash(cd *),Bash(pwd *),Bash(diff *),Bash(xargs *),Bash(awk *),Bash(cut *),Bash(tee *),Bash(tr *)"'
-          settings: |
-            {
-              "env": {
-                "PG_DATABASE_URL": "postgres://postgres:postgres@localhost:5432/default"
-              }
-            }
-      - name: Post response to source issue
-        if: always()
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ secrets.TWENTY_DISPATCH_TOKEN }}
-          script: |
-            const [owner, repo] = '${{ steps.prompt.outputs.repo }}'.split('/');
-            const issueNumber = parseInt('${{ steps.prompt.outputs.issue_number }}', 10);
-
-            await github.rest.issues.createComment({
-              owner,
-              repo,
-              issue_number: issueNumber,
-              body: `Claude finished processing this request. [See workflow run](${context.serverUrl}/${context.repo.owner}/${context.repo.repo}/actions/runs/${context.runId})`
-            });

.github/workflows/docs-i18n-pull.yaml

@@ -107,13 +107,10 @@ jobs:
       - name: Regenerate docs.json
         run: yarn docs:generate
 
-      - name: Regenerate documentation paths constants
-        run: yarn docs:generate-paths
-
       - name: Commit artifacts to pull request branch
         if: github.event_name == 'pull_request'
         run: |
-          git add packages/twenty-docs/docs.json packages/twenty-docs/navigation/navigation.template.json packages/twenty-shared/src/constants/DocumentationPaths.ts
+          git add packages/twenty-docs/docs.json packages/twenty-docs/navigation/navigation.template.json
           if git diff --staged --quiet --exit-code; then
             echo "No navigation/doc changes to commit."
             exit 0

.gitignore

@@ -10,7 +10,6 @@
 .nx/installation
 .nx/cache
 .nx/workspace-data
-.nx/nxw.js
 
 .pnp.*
 .yarn/*
@@ -50,4 +49,3 @@ dump.rdb
 mcp.json
 /.junie/
 TRANSLATION_QA_REPORT.md
-.playwright-mcp/

.mcp.json

@@ -2,9 +2,11 @@
   "mcpServers": {
     "postgres": {
       "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-postgres", "${PG_DATABASE_URL}"],
-      "env": {}
+      "command": "uv",
+      "args": ["run", "postgres-mcp", "--access-mode=unrestricted"],
+      "env": {
+        "DATABASE_URI": "${PG_DATABASE_URL}"
+      }
     },
     "playwright": {
       "type": "stdio",

.nx/nxw.js

@@ -0,0 +1,115 @@
+"use strict";
+// This file should be committed to your repository! It wraps Nx and ensures
+// that your local installation matches nx.json.
+// See: https://nx.dev/recipes/installation/install-non-javascript for more info.
+
+
+
+
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = require('fs');
+const path = require('path');
+const cp = require('child_process');
+const installationPath = path.join(__dirname, 'installation', 'package.json');
+function matchesCurrentNxInstall(currentInstallation, nxJsonInstallation) {
+    if (!currentInstallation.devDependencies ||
+        !Object.keys(currentInstallation.devDependencies).length) {
+        return false;
+    }
+    try {
+        if (currentInstallation.devDependencies['nx'] !==
+            nxJsonInstallation.version ||
+            require(path.join(path.dirname(installationPath), 'node_modules', 'nx', 'package.json')).version !== nxJsonInstallation.version) {
+            return false;
+        }
+        for (const [plugin, desiredVersion] of Object.entries(nxJsonInstallation.plugins || {})) {
+            if (currentInstallation.devDependencies[plugin] !== desiredVersion) {
+                return false;
+            }
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function ensureDir(p) {
+    if (!fs.existsSync(p)) {
+        fs.mkdirSync(p, { recursive: true });
+    }
+}
+function getCurrentInstallation() {
+    try {
+        return require(installationPath);
+    }
+    catch {
+        return {
+            name: 'nx-installation',
+            version: '0.0.0',
+            devDependencies: {},
+        };
+    }
+}
+function performInstallation(currentInstallation, nxJson) {
+    fs.writeFileSync(installationPath, JSON.stringify({
+        name: 'nx-installation',
+        devDependencies: {
+            nx: nxJson.installation.version,
+            ...nxJson.installation.plugins,
+        },
+    }));
+    try {
+        cp.execSync('npm i', {
+            cwd: path.dirname(installationPath),
+            stdio: 'inherit',
+        });
+    }
+    catch (e) {
+        // revert possible changes to the current installation
+        fs.writeFileSync(installationPath, JSON.stringify(currentInstallation));
+        // rethrow
+        throw e;
+    }
+}
+function ensureUpToDateInstallation() {
+    const nxJsonPath = path.join(__dirname, '..', 'nx.json');
+    let nxJson;
+    try {
+        nxJson = require(nxJsonPath);
+        if (!nxJson.installation) {
+            console.error('[NX]: The "installation" entry in the "nx.json" file is required when running the nx wrapper. See https://nx.dev/recipes/installation/install-non-javascript');
+            process.exit(1);
+        }
+    }
+    catch {
+        console.error('[NX]: The "nx.json" file is required when running the nx wrapper. See https://nx.dev/recipes/installation/install-non-javascript');
+        process.exit(1);
+    }
+    try {
+        ensureDir(path.join(__dirname, 'installation'));
+        const currentInstallation = getCurrentInstallation();
+        if (!matchesCurrentNxInstall(currentInstallation, nxJson.installation)) {
+            performInstallation(currentInstallation, nxJson);
+        }
+    }
+    catch (e) {
+        const messageLines = [
+            '[NX]: Nx wrapper failed to synchronize installation.',
+        ];
+        if (e instanceof Error) {
+            messageLines.push('');
+            messageLines.push(e.message);
+            messageLines.push(e.stack);
+        }
+        else {
+            messageLines.push(e.toString());
+        }
+        console.error(messageLines.join('\n'));
+        process.exit(1);
+    }
+}
+if (!process.env.NX_WRAPPER_SKIP_INSTALL) {
+    ensureUpToDateInstallation();
+}
+
+require('./installation/node_modules/nx/bin/nx');

.vscode/launch.json

@@ -68,14 +68,12 @@
         "./jest-integration.config.ts",
         "${relativeFile}",
         "--silent=false",
-        "${input:updateSnapshot}"
       ],
       "cwd": "${workspaceFolder}/packages/twenty-server",
       "console": "integratedTerminal",
       "internalConsoleOptions": "neverOpen",
       "env": {
-        "NODE_ENV": "test",
-        "NODE_OPTIONS": "--max-old-space-size=12288 --import tsx/esm"
+        "NODE_ENV": "test"
       }
     },
     {
@@ -99,14 +97,5 @@
         "NODE_ENV": "test"
       }
     }
-  ],
-  "inputs": [
-    {
-      "id": "updateSnapshot",
-      "type": "pickString",
-      "description": "Update snapshots?",
-      "options": ["", "--updateSnapshot"],
-      "default": ""
-    }
   ]
 }

.vscode/settings.json

@@ -53,6 +53,5 @@
     ".cursorrules": "markdown"
   },
   "jestrunner.codeLensSelector": "**/*.{test,spec,integration-spec}.{js,jsx,ts,tsx}",
-  "typescript.tsdk": "node_modules/typescript/lib",
-  "typescript.experimental.useTsgo": false
+  "typescript.tsdk": "node_modules/typescript/lib"
 }

.vscode/tasks.json

@@ -2,64 +2,12 @@
 	"version": "2.0.0",
 	"tasks": [
 		{
-			"label": "twenty-server - run integration test file",
-			"type": "shell",
-			"command": "npx nx run twenty-server:jest -- --config ./jest-integration.config.ts ${relativeFile} --silent=false ${input:watchMode} ${input:updateSnapshot}",
-			"options": {
-				"cwd": "${workspaceFolder}/packages/twenty-server",
-				"env": {
-					"NODE_ENV": "test",
-					"NODE_OPTIONS": "--max-old-space-size=12288 --import tsx/esm"
-				},
-				"shell": {
-					"executable": "/bin/zsh",
-					"args": ["-l", "-c"]
-				}
-			},
-			"presentation": {
-				"reveal": "always",
-				"panel": "new",
-				"close": false
-			},
-			"problemMatcher": []
-		},
-		{
-			"label": "twenty-server - run unit test file",
-			"type": "shell",
-			"command": "npx nx run twenty-server:jest -- --config ./jest.config.mjs ${relativeFile} --silent=false ${input:watchMode} ${input:updateSnapshot}",
-			"options": {
-				"cwd": "${workspaceFolder}/packages/twenty-server",
-				"env": {
-					"NODE_ENV": "test",
-					"NODE_OPTIONS": "--max-old-space-size=12288 --import tsx/esm"
-				},
-				"shell": {
-					"executable": "/bin/zsh",
-					"args": ["-l", "-c"]
-				}
-			},
-			"presentation": {
-				"reveal": "always",
-				"panel": "new",
-				"close": false
-			},
-			"problemMatcher": []
-		}
-	],
-	"inputs": [
-		{
-			"id": "watchMode",
-			"type": "pickString",
-			"description": "Enable watch mode?",
-			"options": ["", "--watch"],
-			"default": ""
-		},
-		{
-			"id": "updateSnapshot",
-			"type": "pickString",
-			"description": "Update snapshots?",
-			"options": ["", "--updateSnapshot"],
-			"default": ""
+			"type": "npm",
+			"script": "start",
+			"path": "server",
+			"problemMatcher": [],
+			"label": "yarn: start - server",
+			"detail": "yarn start"
 		}
 	]
-}
+}

CLAUDE.md

@@ -21,31 +21,30 @@ npx nx run twenty-server:worker  # Start background worker
 
 ### Testing
 ```bash
-# Preferred: run a single test file (fast)
-npx jest path/to/test.test.ts --config=packages/PROJECT/jest.config.mjs
-
-# Run all tests for a package
+# Run tests
 npx nx test twenty-front      # Frontend unit tests
 npx nx test twenty-server     # Backend unit tests
 npx nx run twenty-server:test:integration:with-db-reset  # Integration tests with DB reset
 
 # Storybook
-npx nx storybook:build twenty-front
-npx nx storybook:test twenty-front
+npx nx storybook:build twenty-front         # Build Storybook
+npx nx storybook:serve-and-test:static twenty-front     # Run Storybook tests
 
-# When testing the UI end to end, click on "Continue with Email" and use the prefilled credentials.
+
+When testing the UI end to end, click on "Continue with Email" and use the prefilled credentials.
 ```
 
 ### Code Quality
 ```bash
-# Linting (diff with main - fastest, always prefer this)
-npx nx lint:diff-with-main twenty-front
-npx nx lint:diff-with-main twenty-server
-npx nx lint:diff-with-main twenty-front --configuration=fix  # Auto-fix
+# Linting (diff with main - fastest)
+npx nx lint:diff-with-main twenty-front           # Lint only files changed vs main
+npx nx lint:diff-with-main twenty-server          # Lint only files changed vs main
+npx nx lint:diff-with-main twenty-front --configuration=fix  # Auto-fix files changed vs main
 
-# Linting (full project - slower, use only when needed)
-npx nx lint twenty-front
-npx nx lint twenty-server
+# Linting (full project)
+npx nx lint twenty-front      # Lint all files in frontend
+npx nx lint twenty-server     # Lint all files in backend
+npx nx lint twenty-front --fix  # Auto-fix all linting issues
 
 # Type checking
 npx nx typecheck twenty-front
@@ -58,8 +57,7 @@ npx nx fmt twenty-server
 
 ### Build
 ```bash
-# Build packages (twenty-shared must be built first)
-npx nx build twenty-shared
+# Build packages
 npx nx build twenty-front
 npx nx build twenty-server
 ```
@@ -71,7 +69,7 @@ npx nx database:reset twenty-server         # Reset database
 npx nx run twenty-server:database:init:prod # Initialize database
 npx nx run twenty-server:database:migrate:prod # Run migrations
 
-# Generate migration (replace [name] with kebab-case descriptive name)
+# Generate migration
 npx nx run twenty-server:typeorm migration:generate src/database/typeorm/core/migrations/common/[name] -d src/database/typeorm/core/core.datasource.ts
 
 # Sync metadata
@@ -80,9 +78,8 @@ npx nx run twenty-server:command workspace:sync-metadata
 
 ### GraphQL
 ```bash
-# Generate GraphQL types (run after schema changes)
+# Generate GraphQL types
 npx nx run twenty-front:graphql:generate
-npx nx run twenty-front:graphql:generate --configuration=metadata
 ```
 
 ## Architecture Overview
@@ -110,36 +107,13 @@ packages/
 - **Named exports only** (no default exports)
 - **Types over interfaces** (except when extending third-party interfaces)
 - **String literals over enums** (except for GraphQL enums)
-- **No 'any' type allowed** — strict TypeScript enforced
+- **No 'any' type allowed**
 - **Event handlers preferred over useEffect** for state updates
-- **Props down, events up** — unidirectional data flow
-- **Composition over inheritance**
-- **No abbreviations** in variable names (`user` not `u`, `fieldMetadata` not `fm`)
-
-### Naming Conventions
-- **Variables/functions**: camelCase
-- **Constants**: SCREAMING_SNAKE_CASE
-- **Types/Classes**: PascalCase (suffix component props with `Props`, e.g. `ButtonProps`)
-- **Files/directories**: kebab-case with descriptive suffixes (`.component.tsx`, `.service.ts`, `.entity.ts`, `.dto.ts`, `.module.ts`)
-- **TypeScript generics**: descriptive names (`TData` not `T`)
-
-### File Structure
-- Components under 300 lines, services under 500 lines
-- Components in their own directories with tests and stories
-- Use `index.ts` barrel exports for clean imports
-- Import order: external libraries first, then internal (`@/`), then relative
-
-### Comments
-- Use short-form comments (`//`), not JSDoc blocks
-- Explain WHY (business logic), not WHAT
-- Do not comment obvious code
-- Multi-line comments use multiple `//` lines, not `/** */`
 
 ### State Management
-- **Recoil** for global state: atoms for primitive state, selectors for derived state, atom families for dynamic collections
-- Component-specific state with React hooks (`useState`, `useReducer` for complex logic)
+- **Recoil** for global state management
+- Component-specific state with React hooks
 - GraphQL cache managed by Apollo Client
-- Use functional state updates: `setState(prev => prev + 1)`
 
 ### Backend Architecture
 - **NestJS modules** for feature organization
@@ -148,54 +122,36 @@ packages/
 - **Redis** for caching and session management
 - **BullMQ** for background job processing
 
-### Database & Migrations
+### Database
 - **PostgreSQL** as primary database
 - **Redis** for caching and sessions
+- **TypeORM migrations** for schema management
 - **ClickHouse** for analytics (when enabled)
-- Always generate migrations when changing entity files
-- Migration names must be kebab-case (e.g. `add-agent-turn-evaluation`)
-- Include both `up` and `down` logic in migrations
-- Never delete or rewrite committed migrations
-
-### Utility Helpers
-Use existing helpers from `twenty-shared` instead of manual type guards:
-- `isDefined()`, `isNonEmptyString()`, `isNonEmptyArray()`
 
 ## Development Workflow
 
 IMPORTANT: Use Context7 for code generation, setup or configuration steps, or library/API documentation. Automatically use the Context7 MCP tools to resolve library IDs and get library docs without waiting for explicit requests.
 
 ### Before Making Changes
-1. Always run linting (`lint:diff-with-main`) and type checking after code changes
-2. Test changes with relevant test suites (prefer single-file test runs)
-3. Ensure database migrations are generated for entity changes
+1. Always run linting and type checking after code changes
+2. Test changes with relevant test suites
+3. Ensure database migrations are properly structured
 4. Check that GraphQL schema changes are backward compatible
-5. Run `graphql:generate` after any GraphQL schema changes
 
 ### Code Style Notes
 - Use **Emotion** for styling with styled-components pattern
 - Follow **Nx** workspace conventions for imports
 - Use **Lingui** for internationalization
-- Apply security first, then formatting (sanitize before format)
+- Components should be in their own directories with tests and stories
 
 ### Testing Strategy
-- **Test behavior, not implementation** — focus on user perspective
-- **Test pyramid**: 70% unit, 20% integration, 10% E2E
-- Query by user-visible elements (text, roles, labels) over test IDs
-- Use `@testing-library/user-event` for realistic interactions
-- Descriptive test names: "should [behavior] when [condition]"
-- Clear mocks between tests with `jest.clearAllMocks()`
-
-## CI Environment (GitHub Actions)
-
-When running in CI, the dev environment is **not** pre-configured. Dependencies are installed but builds, env files, and databases are not set up.
-
-- **Before running tests, builds, lint, type checks, or DB operations**, run: `bash packages/twenty-utils/setup-dev-env.sh`
-- **Skip the setup script** for tasks that only read code — architecture questions, code review, documentation, etc.
-- The script is idempotent and safe to run multiple times.
+- **Unit tests** with Jest for both frontend and backend
+- **Integration tests** for critical backend workflows
+- **Storybook** for component development and testing
+- **E2E tests** with Playwright for critical user flows
 
 ## Important Files
 - `nx.json` - Nx workspace configuration with task definitions
 - `tsconfig.base.json` - Base TypeScript configuration
 - `package.json` - Root package with workspace definitions
-- `.cursor/rules/` - Detailed development guidelines and best practices
+- `.cursor/rules/` - Development guidelines and best practices

eslint.config.mjs

@@ -11,10 +11,6 @@ import unicornPlugin from 'eslint-plugin-unicorn';
 import unusedImportsPlugin from 'eslint-plugin-unused-imports';
 import jsoncParser from 'jsonc-eslint-parser';
 
-const twentyRules = await nxPlugin.loadWorkspaceRules(
-  'packages/twenty-eslint-rules',
-);
-
 export default [
   // Base JavaScript configuration
   js.configs.recommended,
@@ -67,10 +63,6 @@ export default [
               sourceTag: 'scope:sdk',
               onlyDependOnLibsWithTags: ['scope:sdk', 'scope:shared'],
             },
-            {
-              sourceTag: 'scope:create-app',
-              onlyDependOnLibsWithTags: ['scope:create-app', 'scope:shared'],
-            },
             {
               sourceTag: 'scope:shared',
               onlyDependOnLibsWithTags: ['scope:shared'],
@@ -203,7 +195,6 @@ export default [
     plugins: {
       ...mdxPlugin.flat.plugins,
       '@nx': nxPlugin,
-      twenty: { rules: twentyRules },
     },
   },
   mdxPlugin.flatCodeBlocks,
@@ -214,9 +205,9 @@ export default [
       'unused-imports/no-unused-imports': 'off',
       'unused-imports/no-unused-vars': 'off',
       // Enforce JSX tags on separate lines to prevent Crowdin translation issues
-      'twenty/mdx-component-newlines': 'error',
+      '@nx/workspace-mdx-component-newlines': 'error',
       // Disallow angle bracket placeholders to prevent Crowdin translation errors
-      'twenty/no-angle-bracket-placeholders': 'error',
+      '@nx/workspace-no-angle-bracket-placeholders': 'error',
     },
   },
 ];

jest.preset.js

@@ -1,9 +1,4 @@
 const nxPreset = require('@nx/jest/preset').default;
 
-module.exports = {
-  ...nxPreset,
-  // Override the new testEnvironmentOptions added in @nx/jest 22.3.3
-  // which breaks Lingui's module resolution
-  testEnvironmentOptions: {},
-};
+module.exports = { ...nxPreset };
 

nx.json

@@ -4,7 +4,9 @@
     "libsDir": "packages"
   },
   "namedInputs": {
-    "default": ["{projectRoot}/**/*"],
+    "default": [
+      "{projectRoot}/**/*"
+    ],
     "excludeStories": [
       "default",
       "!{projectRoot}/.storybook/*",
@@ -32,17 +34,26 @@
   "targetDefaults": {
     "build": {
       "cache": true,
-      "inputs": ["^production", "production"],
-      "dependsOn": ["^build"]
+      "inputs": [
+        "^production",
+        "production"
+      ],
+      "dependsOn": [
+        "^build"
+      ]
     },
     "start": {
       "cache": false,
-      "dependsOn": ["^build"]
+      "dependsOn": [
+        "^build"
+      ]
     },
     "lint": {
       "executor": "@nx/eslint:lint",
       "cache": true,
-      "outputs": ["{options.outputFile}"],
+      "outputs": [
+        "{options.outputFile}"
+      ],
       "options": {
         "eslintConfig": "{projectRoot}/eslint.config.mjs",
         "cache": true,
@@ -56,7 +67,9 @@
           "fix": true
         }
       },
-      "dependsOn": ["^build"]
+      "dependsOn": [
+        "^build"
+      ]
     },
     "lint:diff-with-main": {
       "executor": "nx:run-commands",
@@ -90,37 +103,46 @@
           "write": true
         }
       },
-      "dependsOn": ["^build"]
+      "dependsOn": [
+        "^build"
+      ]
     },
     "typecheck": {
       "executor": "nx:run-commands",
       "cache": true,
       "options": {
         "cwd": "{projectRoot}",
-        "command": "tsgo -p tsconfig.json"
+        "command": "tsc -b tsconfig.json --incremental"
       },
       "configurations": {
         "watch": {
-          "command": "tsgo -p tsconfig.json --watch"
+          "watch": true
         }
       },
-      "dependsOn": ["^build"]
+      "dependsOn": [
+        "^build"
+      ]
     },
     "test": {
       "executor": "@nx/jest:jest",
       "cache": true,
-      "dependsOn": ["^build"],
+      "dependsOn": [
+        "^build"
+      ],
       "inputs": [
         "^default",
         "excludeStories",
         "{workspaceRoot}/jest.preset.js"
       ],
-      "outputs": ["{projectRoot}/coverage"],
+      "outputs": [
+        "{projectRoot}/coverage"
+      ],
       "options": {
         "jestConfig": "{projectRoot}/jest.config.mjs",
-        "silent": true,
         "coverage": true,
-        "coverageReporters": ["text-summary"],
+        "coverageReporters": [
+          "text-summary"
+        ],
         "cacheDirectory": "../../.cache/jest/{projectRoot}"
       },
       "configurations": {
@@ -129,7 +151,10 @@
           "maxWorkers": 3
         },
         "coverage": {
-          "coverageReporters": ["lcov", "text"]
+          "coverageReporters": [
+            "lcov",
+            "text"
+          ]
         },
         "watch": {
           "watch": true
@@ -138,25 +163,36 @@
     },
     "test:e2e": {
       "cache": true,
-      "dependsOn": ["^build"]
+      "dependsOn": [
+        "^build"
+      ]
     },
     "storybook:build": {
       "executor": "nx:run-commands",
       "cache": true,
-      "inputs": ["^default", "excludeTests"],
-      "outputs": ["{projectRoot}/{options.output-dir}"],
+      "inputs": [
+        "^default",
+        "excludeTests"
+      ],
+      "outputs": [
+        "{projectRoot}/{options.output-dir}"
+      ],
       "options": {
         "cwd": "{projectRoot}",
         "command": "NODE_OPTIONS='--max-old-space-size=10240' VITE_DISABLE_TYPESCRIPT_CHECKER=true storybook build --test",
         "output-dir": "storybook-static",
         "config-dir": ".storybook"
       },
-      "dependsOn": ["^build"]
+      "dependsOn": [
+        "^build"
+      ]
     },
     "storybook:serve:dev": {
       "executor": "nx:run-commands",
       "cache": true,
-      "dependsOn": ["^build"],
+      "dependsOn": [
+        "^build"
+      ],
       "options": {
         "cwd": "{projectRoot}",
         "command": "storybook dev",
@@ -165,7 +201,9 @@
     },
     "storybook:serve:static": {
       "executor": "nx:run-commands",
-      "dependsOn": ["storybook:build"],
+      "dependsOn": [
+        "storybook:build"
+      ],
       "options": {
         "cwd": "{projectRoot}",
         "command": "npx http-server {args.staticDir} -a={args.host} --port={args.port} --silent={args.silent}",
@@ -178,21 +216,38 @@
     "storybook:test": {
       "executor": "nx:run-commands",
       "cache": true,
-      "inputs": ["^default", "excludeTests"],
-      "outputs": ["{projectRoot}/coverage/storybook"],
+      "inputs": [
+        "^default",
+        "excludeTests"
+      ],
+      "outputs": [
+        "{projectRoot}/coverage/storybook"
+      ],
       "options": {
         "cwd": "{projectRoot}",
-        "command": "vitest run --coverage --shard={args.shard}",
-        "shard": "1/1"
+        "commands": [
+          "test-storybook --url http://localhost:{args.port} --maxWorkers=3 --coverage --coverageDirectory={args.coverageDir} --shard={args.shard}",
+          "nx storybook:coverage {projectName} --coverageDir={args.coverageDir} --checkCoverage={args.checkCoverage}"
+        ],
+        "shard": "1/1",
+        "parallel": false,
+        "coverageDir": "coverage/storybook",
+        "port": 6006,
+        "checkCoverage": true
       }
     },
     "storybook:test:no-coverage": {
       "executor": "nx:run-commands",
-      "inputs": ["^default", "excludeTests"],
+      "inputs": [
+        "^default",
+        "excludeTests"
+      ],
       "options": {
         "cwd": "{projectRoot}",
-        "command": "vitest run --shard={args.shard}",
-        "shard": "1/1"
+        "commands": [
+          "test-storybook --url http://localhost:{args.port} --maxWorkers=2"
+        ],
+        "port": 6006
       }
     },
     "storybook:coverage": {
@@ -219,6 +274,17 @@
         }
       }
     },
+    "storybook:serve-and-test:static": {
+      "executor": "nx:run-commands",
+      "options": {
+        "commands": [
+          "npx concurrently --kill-others --success=first -n SB,TEST 'nx storybook:serve:static {projectName} --port={args.port}' 'npx wait-on tcp:{args.port} && nx storybook:test {projectName} --shard={args.shard} --checkCoverage={args.checkCoverage} --port={args.port} --configuration={args.scope}'"
+        ],
+        "shard": "1/1",
+        "checkCoverage": true,
+        "port": 6006
+      }
+    },
     "chromatic": {
       "executor": "nx:run-commands",
       "options": {
@@ -260,19 +326,30 @@
       "inputs": [
         "default",
         "{workspaceRoot}/eslint.config.mjs",
-        "{workspaceRoot}/packages/twenty-eslint-rules/**/*"
+        "{workspaceRoot}/tools/eslint-rules/**/*"
+      ]
+    },
+    "@nx/vite:test": {
+      "cache": true,
+      "inputs": [
+        "default",
+        "^default"
       ]
     },
     "@nx/vite:build": {
       "cache": true,
-      "dependsOn": ["^build"],
-      "inputs": ["default", "^default"]
-    },
-    "@nx/vitest:test": {
-      "cache": true,
-      "inputs": ["default", "^default"]
+      "dependsOn": [
+        "^build"
+      ],
+      "inputs": [
+        "default",
+        "^default"
+      ]
     }
   },
+  "installation": {
+    "version": "22.0.3"
+  },
   "generators": {
     "@nx/react": {
       "application": {
@@ -299,7 +376,9 @@
   "tasksRunnerOptions": {
     "default": {
       "options": {
-        "cacheableOperations": ["storybook:build"]
+        "cacheableOperations": [
+          "storybook:build"
+        ]
       }
     }
   },

package.json

@@ -22,7 +22,6 @@
     "googleapis": "105",
     "hex-rgb": "^5.0.0",
     "immer": "^10.1.1",
-    "jotai": "^2.17.1",
     "libphonenumber-js": "^1.10.26",
     "lodash.camelcase": "^4.3.0",
     "lodash.chunk": "^4.2.0",
@@ -73,20 +72,19 @@
     "@graphql-codegen/typescript": "^3.0.4",
     "@graphql-codegen/typescript-operations": "^3.0.4",
     "@graphql-codegen/typescript-react-apollo": "^3.3.7",
-    "@nx/eslint": "22.3.3",
-    "@nx/eslint-plugin": "22.3.3",
-    "@nx/jest": "22.3.3",
-    "@nx/js": "22.3.3",
-    "@nx/react": "22.3.3",
-    "@nx/storybook": "22.3.3",
-    "@nx/vite": "22.3.3",
-    "@nx/web": "22.3.3",
+    "@nx/eslint": "22.0.3",
+    "@nx/eslint-plugin": "22.0.3",
+    "@nx/jest": "22.0.3",
+    "@nx/js": "22.0.3",
+    "@nx/react": "22.0.3",
+    "@nx/storybook": "22.0.3",
+    "@nx/vite": "22.0.3",
+    "@nx/web": "22.0.3",
     "@sentry/types": "^8",
     "@storybook-community/storybook-addon-cookie": "^5.0.0",
     "@storybook/addon-coverage": "^3.0.0",
     "@storybook/addon-docs": "^10.1.11",
     "@storybook/addon-links": "^10.1.11",
-    "@storybook/addon-vitest": "^10.1.11",
     "@storybook/icons": "^2.0.1",
     "@storybook/react-vite": "^10.1.11",
     "@storybook/test-runner": "^0.24.2",
@@ -136,11 +134,7 @@
     "@typescript-eslint/eslint-plugin": "^8.39.0",
     "@typescript-eslint/parser": "^8.39.0",
     "@typescript-eslint/utils": "^8.39.0",
-    "@typescript/native-preview": "^7.0.0-dev.20260116.1",
     "@vitejs/plugin-react-swc": "3.11.0",
-    "@vitest/browser-playwright": "^4.0.18",
-    "@vitest/coverage-istanbul": "^4.0.18",
-    "@vitest/coverage-v8": "^4.0.18",
     "@yarnpkg/types": "^4.0.0",
     "chromatic": "^6.18.0",
     "concurrently": "^8.2.2",
@@ -169,9 +163,9 @@
     "jest-environment-node": "^29.4.1",
     "jest-fetch-mock": "^3.0.3",
     "jsdom": "~22.1.0",
-    "msw": "^2.12.7",
-    "msw-storybook-addon": "^2.0.6",
-    "nx": "22.3.3",
+    "msw": "^2.0.11",
+    "msw-storybook-addon": "^2.0.5",
+    "nx": "22.0.3",
     "prettier": "^3.1.1",
     "raw-loader": "^4.0.2",
     "rimraf": "^5.0.5",
@@ -183,11 +177,9 @@
     "ts-jest": "^29.1.1",
     "ts-loader": "^9.2.3",
     "ts-node": "10.9.1",
-    "tsc-alias": "^1.8.16",
     "tsconfig-paths": "^4.2.0",
     "tsx": "^4.17.0",
-    "vite": "^7.0.0",
-    "vitest": "^4.0.18"
+    "vite": "^7.0.0"
   },
   "engines": {
     "node": "^24.5.0",
@@ -203,16 +195,13 @@
     "typescript": "5.9.2",
     "graphql-redis-subscriptions/ioredis": "^5.6.0",
     "prosemirror-view": "1.40.0",
-    "prosemirror-transform": "1.10.4",
-    "@lingui/core": "5.1.2",
-    "@types/qs": "6.9.16"
+    "prosemirror-transform": "1.10.4"
   },
   "version": "0.2.1",
   "nx": {},
   "scripts": {
     "docs:generate": "tsx packages/twenty-docs/scripts/generate-docs-json.ts",
     "docs:generate-navigation-template": "tsx packages/twenty-docs/scripts/generate-navigation-template.ts",
-    "docs:generate-paths": "tsx packages/twenty-docs/scripts/generate-documentation-paths.ts",
     "start": "npx concurrently --kill-others 'npx nx run-many -t start -p twenty-server twenty-front' 'npx wait-on tcp:3000 && npx nx run twenty-server:worker'"
   },
   "workspaces": {
@@ -231,7 +220,7 @@
       "packages/twenty-apps",
       "packages/twenty-cli",
       "packages/create-twenty-app",
-      "packages/twenty-eslint-rules"
+      "tools/eslint-rules"
     ]
   },
   "prettier": {

packages/create-twenty-app/README.md

@@ -15,12 +15,9 @@
 Create Twenty App is the official scaffolding CLI for building apps on top of [Twenty CRM](https://twenty.com). It sets up a ready‑to‑run project that works seamlessly with the [twenty-sdk](https://www.npmjs.com/package/twenty-sdk).
 
 - Zero‑config project bootstrap
-- Preconfigured scripts for auth, dev mode (watch & sync), generate, uninstall, and function management
+- Preconfigured scripts for auth, generate, dev sync, one‑off sync, uninstall
 - Strong TypeScript support and typed client generation
 
-## Documentation
-See Twenty application documentation https://docs.twenty.com/developers/extend/capabilities/apps
-
 ## Prerequisites
 - Node.js 24+ (recommended) and Yarn 4
 - A Twenty workspace and an API key (create one at https://app.twenty.com/settings/api-webhooks)
@@ -31,50 +28,41 @@ See Twenty application documentation https://docs.twenty.com/developers/extend/c
 npx create-twenty-app@latest my-twenty-app
 cd my-twenty-app
 
-# If you don't use yarn@4
-corepack enable
-yarn install
-
-# Get help and list all available commands
-yarn twenty help
-
 # Authenticate using your API key (you'll be prompted)
-yarn twenty auth:login
+yarn auth
 
 # Add a new entity to your application (guided)
-yarn twenty entity:add
+yarn create-entity
 
 # Generate a typed Twenty client and workspace entity types
-yarn twenty app:generate
+yarn generate
 
-# Start dev mode: watches, builds, and syncs local changes to your workspace
-yarn twenty app:dev
+# Start dev mode: automatically syncs local changes to your workspace
+yarn dev
 
-# Watch your application's function logs
-yarn twenty function:logs
+# Or run a one‑time sync
+yarn sync
 
-# Execute a function with a JSON payload
-yarn twenty function:execute -n my-function -p '{"key": "value"}'
+# Watch your application's functions logs
+yarn logs
 
 # Uninstall the application from the current workspace
-yarn twenty app:uninstall
+yarn uninstall
+
+# Display commands' help
+yarn help
 ```
 
 ## What gets scaffolded
-- A minimal app structure ready for Twenty with example files:
-  - `application-config.ts` - Application metadata configuration
-  - `roles/default-role.ts` - Default role for logic functions
-  - `logic-functions/hello-world.ts` - Example logic function with HTTP trigger
-  - `front-components/hello-world.tsx` - Example front component
+- A minimal app structure ready for Twenty
 - TypeScript configuration
-- A prewired `twenty` script that delegates to the `twenty` CLI from twenty-sdk
+- Prewired scripts that wrap the `twenty` CLI from twenty-sdk
+- Example placeholders to help you add entities, actions, and sync logic
 
 ## Next steps
-- Run `yarn twenty help` to see all available commands.
-- Use `yarn twenty auth:login` to authenticate with your Twenty workspace.
-- Explore the generated project and add your first entity with `yarn twenty entity:add` (logic functions, front components, objects, roles).
-- Use `yarn twenty app:dev` while you iterate — it watches, builds, and syncs changes to your workspace in real time.
-- Keep your types up‑to‑date using `yarn twenty app:generate`.
+- Explore the generated project and add your first entity with `yarn create-entity`.
+- Keep your types up‑to‑date using `yarn generate`.
+- Use `yarn dev` while you iterate to see changes instantly in your workspace.
 
 
 ## Publish your application
@@ -102,8 +90,8 @@ git push
 Our team reviews contributions for quality, security, and reusability before merging.
 
 ## Troubleshooting
-- Auth prompts not appearing: run `yarn twenty auth:login` again and verify the API key permissions.
-- Types not generated: ensure `yarn twenty app:generate` runs without errors, then re‑start `yarn twenty app:dev`.
+- Auth prompts not appearing: run `yarn auth` again and verify the API key permissions.
+- Types not generated: ensure `yarn generate` runs without errors, then re‑start `yarn dev`.
 
 ## Contributing
 - See our [GitHub](https://github.com/twentyhq/twenty)

packages/create-twenty-app/eslint.config.mjs

@@ -1,20 +1,111 @@
-import baseConfig from '../../eslint.config.mjs';
+import js from '@eslint/js';
+import typescriptEslint from '@typescript-eslint/eslint-plugin';
+import typescriptParser from '@typescript-eslint/parser';
+import prettierPlugin from 'eslint-plugin-prettier';
 
 export default [
-  ...baseConfig,
+  js.configs.recommended,
   {
-    ignores: ['**/dist/**'],
-  },
-  {
-    files: ['**/*.{js,jsx,ts,tsx}'],
+    files: ['**/*.ts', '**/*.tsx'],
+    languageOptions: {
+      parser: typescriptParser,
+      parserOptions: {
+        ecmaVersion: 2022,
+        sourceType: 'module',
+      },
+      globals: {
+        // Node.js globals
+        process: 'readonly',
+        console: 'readonly',
+        Buffer: 'readonly',
+        __dirname: 'readonly',
+        __filename: 'readonly',
+        global: 'readonly',
+        setTimeout: 'readonly',
+        clearTimeout: 'readonly',
+        setInterval: 'readonly',
+        clearInterval: 'readonly',
+        // Browser globals that Node.js also has
+        URL: 'readonly',
+        URLSearchParams: 'readonly',
+        // Node.js types
+        NodeJS: 'readonly',
+      },
+    },
+    plugins: {
+      '@typescript-eslint': typescriptEslint,
+      prettier: prettierPlugin,
+    },
     rules: {
+      ...typescriptEslint.configs.recommended.rules,
       'prettier/prettier': 'error',
+      '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/explicit-function-return-type': 'off',
+      '@typescript-eslint/explicit-module-boundary-types': 'off',
+      '@typescript-eslint/no-empty-function': 'off',
+      'no-useless-escape': 'off',
     },
   },
   {
-    rules: {
-      'no-console': 'off',
+    files: ['**/*.js'],
+    languageOptions: {
+      ecmaVersion: 2022,
+      sourceType: 'module',
+      globals: {
+        process: 'readonly',
+        console: 'readonly',
+        Buffer: 'readonly',
+        __dirname: 'readonly',
+        __filename: 'readonly',
+        global: 'readonly',
+      },
     },
-    ignores: ['src/**/*.ts', '!src/cli/**/*.ts'],
+  },
+  {
+    files: ['**/*.test.ts', '**/*.spec.ts', '**/__tests__/**/*.ts'],
+    languageOptions: {
+      parser: typescriptParser,
+      parserOptions: {
+        ecmaVersion: 2022,
+        sourceType: 'module',
+      },
+      globals: {
+        // Node.js globals
+        process: 'readonly',
+        console: 'readonly',
+        Buffer: 'readonly',
+        __dirname: 'readonly',
+        __filename: 'readonly',
+        global: 'readonly',
+        // Jest globals
+        describe: 'readonly',
+        it: 'readonly',
+        test: 'readonly',
+        expect: 'readonly',
+        jest: 'readonly',
+        beforeEach: 'readonly',
+        afterEach: 'readonly',
+        beforeAll: 'readonly',
+        afterAll: 'readonly',
+      },
+    },
+    plugins: {
+      '@typescript-eslint': typescriptEslint,
+      prettier: prettierPlugin,
+    },
+    rules: {
+      ...typescriptEslint.configs.recommended.rules,
+      'prettier/prettier': 'error',
+      '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/explicit-function-return-type': 'off',
+      '@typescript-eslint/explicit-module-boundary-types': 'off',
+      '@typescript-eslint/no-empty-function': 'off',
+      'no-useless-escape': 'off',
+    },
+  },
+  {
+    ignores: ['dist/**', 'node_modules/**'],
   },
 ];

packages/create-twenty-app/package.json

@@ -1,13 +1,11 @@
 {
   "name": "create-twenty-app",
-  "version": "0.6.0-alpha",
+  "version": "0.3.1",
   "description": "Command-line interface to create Twenty application",
   "main": "dist/cli.cjs",
   "bin": "dist/cli.cjs",
   "files": [
-    "dist",
-    "README.md",
-    "package.json"
+    "dist/**/*"
   ],
   "scripts": {
     "build": "npx rimraf dist && npx vite build"
@@ -45,9 +43,6 @@
     "@types/lodash.kebabcase": "^4.1.7",
     "@types/lodash.startcase": "^4",
     "@types/node": "^20.0.0",
-    "twenty-sdk": "workspace:*",
-    "twenty-shared": "workspace:*",
-    "typescript": "^5.9.2",
     "vite": "^7.0.0",
     "vite-plugin-dts": "^4.5.4",
     "vite-tsconfig-paths": "^4.2.1"

packages/create-twenty-app/src/constants/base-application/.yarnrc.yml

@@ -1 +1,3 @@
+yarnPath: .yarn/releases/yarn-4.9.2.cjs
+
 nodeLinker: node-modules

packages/create-twenty-app/src/constants/base-application/README.md

@@ -5,38 +5,17 @@ This is a [Twenty](https://twenty.com) application project bootstrapped with [`c
 First, authenticate to your workspace:
 
 ```bash
-yarn twenty auth:login
+yarn auth
 ```
 
-Then, start development mode to sync your app and watch for changes:
+Then, install this app to your workspace:
 
 ```bash
-yarn twenty app:dev
+yarn sync
 ```
 
 Open your Twenty instance and go to `/settings/applications` section to see the result.
 
-## Available Commands
-
-Run `yarn twenty help` to list all available commands. Common commands:
-
-```bash
-# Authentication
-yarn twenty auth:login     # Authenticate with Twenty
-yarn twenty auth:logout    # Remove credentials
-yarn twenty auth:status    # Check auth status
-yarn twenty auth:switch    # Switch default workspace
-yarn twenty auth:list      # List all configured workspaces
-
-# Application
-yarn twenty app:dev        # Start dev mode (watch, build, and sync)
-yarn twenty entity:add     # Add a new entity (function, front-component, object, role)
-yarn twenty app:generate   # Generate typed Twenty client
-yarn twenty function:logs  # Stream function logs
-yarn twenty function:execute  # Execute a function with JSON payload
-yarn twenty app:uninstall  # Uninstall app from workspace
-```
-
 ## Learn More
 
 To learn more about Twenty applications, take a look at the following resources:

packages/create-twenty-app/src/constants/base-application/tsconfig.json

@@ -5,7 +5,6 @@
     "declaration": true,
     "outDir": "./dist",
     "rootDir": ".",
-    "jsx": "react-jsx",
     "moduleResolution": "node",
     "allowSyntheticDefaultImports": true,
     "emitDecoratorMetadata": true,
@@ -22,10 +21,6 @@
     "skipLibCheck": true,
     "skipDefaultLibCheck": true,
     "resolveJsonModule": true,
-    "paths": {
-      "src/*": ["./src/*"],
-      "~/*": ["./*"]
-    }
   },
   "exclude": ["node_modules", "dist", "**/*.test.ts", "**/*.spec.ts"]
 }

packages/create-twenty-app/src/create-app.command.ts

@@ -1,12 +1,12 @@
-import { copyBaseApplicationProject } from '@/utils/app-template';
-import { convertToLabel } from '@/utils/convert-to-label';
-import { install } from '@/utils/install';
-import { tryGitInit } from '@/utils/try-git-init';
 import chalk from 'chalk';
 import * as fs from 'fs-extra';
 import inquirer from 'inquirer';
-import kebabCase from 'lodash.kebabcase';
 import * as path from 'path';
+import { copyBaseApplicationProject } from '@/utils/app-template';
+import kebabCase from 'lodash.kebabcase';
+import { convertToLabel } from '@/utils/convert-to-label';
+import { tryGitInit } from '@/utils/try-git-init';
+import { install } from '@/utils/install';
 
 const CURRENT_EXECUTION_DIRECTORY = process.env.INIT_CWD || process.cwd();
 
@@ -119,15 +119,10 @@ export class CreateAppCommand {
   }
 
   private logSuccess(appDirectory: string): void {
-    const dirName = appDirectory.split('/').reverse()[0] ?? '';
-
     console.log(chalk.green('✅ Application created!'));
     console.log('');
     console.log(chalk.blue('Next steps:'));
-    console.log(chalk.gray(`  cd ${dirName}`));
-    console.log(chalk.gray(`  corepack enable  # if you don't use yarn@4`));
-    console.log(chalk.gray(`  yarn install     # if you don't use yarn@4`));
-    console.log(chalk.gray('  yarn auth:login  # Authenticate with Twenty'));
-    console.log(chalk.gray('  yarn app:dev     # Start dev mode'));
+    console.log(`cd ${appDirectory.split('/').reverse()[0] ?? ''}`);
+    console.log('yarn auth');
   }
 }

packages/create-twenty-app/src/utils/__tests__/app-template.spec.ts

@@ -12,9 +12,6 @@ jest.mock('fs-extra', () => {
   };
 });
 
-const APPLICATION_FILE_NAME = 'application-config.ts';
-const DEFAULT_ROLE_FILE_NAME = 'default-role.ts';
-
 describe('copyBaseApplicationProject', () => {
   let testAppDirectory: string;
 
@@ -35,7 +32,7 @@ describe('copyBaseApplicationProject', () => {
     }
   });
 
-  it('should create the correct folder structure with src/', async () => {
+  it('should create the correct folder structure with src/app/', async () => {
     await copyBaseApplicationProject({
       appName: 'my-test-app',
       appDisplayName: 'My Test App',
@@ -43,16 +40,16 @@ describe('copyBaseApplicationProject', () => {
       appDirectory: testAppDirectory,
     });
 
-    // Verify src/ folder exists
-    const srcAppPath = join(testAppDirectory, 'src');
+    // Verify src/app/ folder exists
+    const srcAppPath = join(testAppDirectory, 'src', 'app');
     expect(await fs.pathExists(srcAppPath)).toBe(true);
 
-    // Verify application-config.ts exists in src/
-    const appConfigPath = join(srcAppPath, APPLICATION_FILE_NAME);
+    // Verify application.config.ts exists in src/app/
+    const appConfigPath = join(srcAppPath, 'application.config.ts');
     expect(await fs.pathExists(appConfigPath)).toBe(true);
 
-    // Verify default-role.ts exists in src/
-    const roleConfigPath = join(srcAppPath, 'roles', DEFAULT_ROLE_FILE_NAME);
+    // Verify default-function.role.ts exists in src/app/
+    const roleConfigPath = join(srcAppPath, 'default-function.role.ts');
     expect(await fs.pathExists(roleConfigPath)).toBe(true);
   });
 
@@ -70,8 +67,9 @@ describe('copyBaseApplicationProject', () => {
     const packageJson = await fs.readJson(packageJsonPath);
     expect(packageJson.name).toBe('my-test-app');
     expect(packageJson.version).toBe('0.1.0');
-    expect(packageJson.dependencies['twenty-sdk']).toBe('latest');
-    expect(packageJson.scripts['twenty']).toBe('twenty');
+    expect(packageJson.dependencies['twenty-sdk']).toBe('0.3.1');
+    expect(packageJson.scripts.sync).toBe('twenty app sync');
+    expect(packageJson.scripts.dev).toBe('twenty app dev');
   });
 
   it('should create .gitignore file', async () => {
@@ -105,7 +103,7 @@ describe('copyBaseApplicationProject', () => {
     expect(yarnLockContent).toContain('yarn lockfile v1');
   });
 
-  it('should create application-config.ts with defineApplication and correct values', async () => {
+  it('should create application.config.ts with defineApp and correct values', async () => {
     await copyBaseApplicationProject({
       appName: 'my-test-app',
       appDisplayName: 'My Test App',
@@ -113,18 +111,23 @@ describe('copyBaseApplicationProject', () => {
       appDirectory: testAppDirectory,
     });
 
-    const appConfigPath = join(testAppDirectory, 'src', APPLICATION_FILE_NAME);
+    const appConfigPath = join(
+      testAppDirectory,
+      'src',
+      'app',
+      'application.config.ts',
+    );
     const appConfigContent = await fs.readFile(appConfigPath, 'utf8');
 
-    // Verify it uses defineApplication
+    // Verify it uses defineApp
     expect(appConfigContent).toContain(
-      "import { defineApplication } from 'twenty-sdk'",
+      "import { defineApp } from 'twenty-sdk'",
     );
-    expect(appConfigContent).toContain('export default defineApplication({');
+    expect(appConfigContent).toContain('export default defineApp({');
 
     // Verify it imports the role identifier
     expect(appConfigContent).toContain(
-      "import { DEFAULT_ROLE_UNIVERSAL_IDENTIFIER } from 'src/roles/default-role'",
+      "import { DEFAULT_FUNCTION_ROLE_UNIVERSAL_IDENTIFIER } from './default-function.role'",
     );
 
     // Verify display name and description
@@ -138,11 +141,11 @@ describe('copyBaseApplicationProject', () => {
 
     // Verify it references the role
     expect(appConfigContent).toContain(
-      'defaultRoleUniversalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER',
+      'functionRoleUniversalIdentifier: DEFAULT_FUNCTION_ROLE_UNIVERSAL_IDENTIFIER',
     );
   });
 
-  it('should create default-role.ts with defineRole and correct values', async () => {
+  it('should create default-function.role.ts with defineRole and correct values', async () => {
     await copyBaseApplicationProject({
       appName: 'my-test-app',
       appDisplayName: 'My Test App',
@@ -153,8 +156,8 @@ describe('copyBaseApplicationProject', () => {
     const roleConfigPath = join(
       testAppDirectory,
       'src',
-      'roles',
-      DEFAULT_ROLE_FILE_NAME,
+      'app',
+      'default-function.role.ts',
     );
     const roleConfigContent = await fs.readFile(roleConfigPath, 'utf8');
 
@@ -166,7 +169,7 @@ describe('copyBaseApplicationProject', () => {
 
     // Verify it exports the universal identifier constant
     expect(roleConfigContent).toContain(
-      'export const DEFAULT_ROLE_UNIVERSAL_IDENTIFIER',
+      'export const DEFAULT_FUNCTION_ROLE_UNIVERSAL_IDENTIFIER',
     );
 
     // Verify role label includes app name
@@ -182,7 +185,7 @@ describe('copyBaseApplicationProject', () => {
 
     // Verify it has a universalIdentifier (UUID format)
     expect(roleConfigContent).toMatch(
-      /universalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER/,
+      /universalIdentifier: DEFAULT_FUNCTION_ROLE_UNIVERSAL_IDENTIFIER/,
     );
   });
 
@@ -210,7 +213,12 @@ describe('copyBaseApplicationProject', () => {
       appDirectory: testAppDirectory,
     });
 
-    const appConfigPath = join(testAppDirectory, 'src', APPLICATION_FILE_NAME);
+    const appConfigPath = join(
+      testAppDirectory,
+      'src',
+      'app',
+      'application.config.ts',
+    );
     const appConfigContent = await fs.readFile(appConfigPath, 'utf8');
 
     expect(appConfigContent).toContain("description: ''");
@@ -239,11 +247,11 @@ describe('copyBaseApplicationProject', () => {
 
     // Read both app configs
     const firstAppConfig = await fs.readFile(
-      join(firstAppDir, 'src', APPLICATION_FILE_NAME),
+      join(firstAppDir, 'src', 'app', 'application.config.ts'),
       'utf8',
     );
     const secondAppConfig = await fs.readFile(
-      join(secondAppDir, 'src', APPLICATION_FILE_NAME),
+      join(secondAppDir, 'src', 'app', 'application.config.ts'),
       'utf8',
     );
 
@@ -279,19 +287,19 @@ describe('copyBaseApplicationProject', () => {
       appDirectory: secondAppDir,
     });
 
+    // Read both role configs
     const firstRoleConfig = await fs.readFile(
-      join(firstAppDir, 'src', 'roles', DEFAULT_ROLE_FILE_NAME),
+      join(firstAppDir, 'src', 'app', 'default-function.role.ts'),
       'utf8',
     );
-
     const secondRoleConfig = await fs.readFile(
-      join(secondAppDir, 'src', 'roles', DEFAULT_ROLE_FILE_NAME),
+      join(secondAppDir, 'src', 'app', 'default-function.role.ts'),
       'utf8',
     );
 
     // Extract UUIDs using regex
     const uuidRegex =
-      /DEFAULT_ROLE_UNIVERSAL_IDENTIFIER =\s*'([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})'/;
+      /DEFAULT_FUNCTION_ROLE_UNIVERSAL_IDENTIFIER =\s*'([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})'/;
     const firstUuid = firstRoleConfig.match(uuidRegex)?.[1];
     const secondUuid = secondRoleConfig.match(uuidRegex)?.[1];
 

packages/create-twenty-app/src/utils/app-template.ts

@@ -1,9 +1,8 @@
 import * as fs from 'fs-extra';
 import { join } from 'path';
 import { v4 } from 'uuid';
-import { ASSETS_DIR } from 'twenty-shared/application';
 
-const SRC_FOLDER = 'src';
+const APP_FOLDER = 'src/app';
 
 export const copyBaseApplicationProject = async ({
   appName,
@@ -22,45 +21,24 @@ export const copyBaseApplicationProject = async ({
 
   await createGitignore(appDirectory);
 
-  await createPublicAssetDirectory(appDirectory);
-
   await createYarnLock(appDirectory);
 
-  const sourceFolderPath = join(appDirectory, SRC_FOLDER);
+  const appFolderPath = join(appDirectory, APP_FOLDER);
 
-  await fs.ensureDir(sourceFolderPath);
+  await fs.ensureDir(appFolderPath);
 
-  await createDefaultRoleConfig({
+  await createDefaultServerlessFunctionRoleConfig({
     displayName: appDisplayName,
-    appDirectory: sourceFolderPath,
-    fileFolder: 'roles',
-    fileName: 'default-role.ts',
-  });
-
-  await createDefaultFrontComponent({
-    appDirectory: sourceFolderPath,
-    fileFolder: 'front-components',
-    fileName: 'hello-world.tsx',
-  });
-
-  await createDefaultFunction({
-    appDirectory: sourceFolderPath,
-    fileFolder: 'logic-functions',
-    fileName: 'hello-world.ts',
+    appDirectory: appFolderPath,
   });
 
   await createApplicationConfig({
     displayName: appDisplayName,
     description: appDescription,
-    appDirectory: sourceFolderPath,
-    fileName: 'application-config.ts',
+    appDirectory: appFolderPath,
   });
 };
 
-const createPublicAssetDirectory = async (appDirectory: string) => {
-  await fs.ensureDir(join(appDirectory, ASSETS_DIR));
-};
-
 const createYarnLock = async (appDirectory: string) => {
   const yarnLockContent = `# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.
 # yarn lockfile v1
@@ -86,9 +64,6 @@ generated
 # dev
 /dist/
 
-.twenty/*
-!.twenty/output/
-
 # production
 /build
 
@@ -112,26 +87,22 @@ yarn-error.log*
   await fs.writeFile(join(appDirectory, '.gitignore'), gitignoreContent);
 };
 
-const createDefaultRoleConfig = async ({
+const createDefaultServerlessFunctionRoleConfig = async ({
   displayName,
   appDirectory,
-  fileFolder,
-  fileName,
 }: {
   displayName: string;
   appDirectory: string;
-  fileFolder?: string;
-  fileName: string;
 }) => {
   const universalIdentifier = v4();
 
   const content = `import { defineRole } from 'twenty-sdk';
 
-export const DEFAULT_ROLE_UNIVERSAL_IDENTIFIER =
+export const DEFAULT_FUNCTION_ROLE_UNIVERSAL_IDENTIFIER =
   '${universalIdentifier}';
 
 export default defineRole({
-  universalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+  universalIdentifier: DEFAULT_FUNCTION_ROLE_UNIVERSAL_IDENTIFIER,
   label: '${displayName} default function role',
   description: '${displayName} default function role',
   canReadAllObjectRecords: true,
@@ -141,106 +112,30 @@ export default defineRole({
 });
 `;
 
-  await fs.ensureDir(join(appDirectory, fileFolder ?? ''));
-  await fs.writeFile(join(appDirectory, fileFolder ?? '', fileName), content);
-};
-
-const createDefaultFrontComponent = async ({
-  appDirectory,
-  fileFolder,
-  fileName,
-}: {
-  appDirectory: string;
-  fileFolder?: string;
-  fileName: string;
-}) => {
-  const universalIdentifier = v4();
-
-  const content = `import { defineFrontComponent } from 'twenty-sdk';
-
-export const HelloWorld = () => {
-  return (
-    <div style={{ padding: '20px', fontFamily: 'sans-serif' }}>
-      <h1>Hello, World!</h1>
-      <p>This is your first front component.</p>
-    </div>
-  );
-};
-
-export default defineFrontComponent({
-  universalIdentifier: '${universalIdentifier}',
-  name: 'hello-world-front-component',
-  description: 'A sample front component',
-  component: HelloWorld,
-});
-`;
-
-  await fs.ensureDir(join(appDirectory, fileFolder ?? ''));
-  await fs.writeFile(join(appDirectory, fileFolder ?? '', fileName), content);
-};
-
-const createDefaultFunction = async ({
-  appDirectory,
-  fileFolder,
-  fileName,
-}: {
-  appDirectory: string;
-  fileFolder?: string;
-  fileName: string;
-}) => {
-  const universalIdentifier = v4();
-
-  const content = `import { defineLogicFunction } from 'twenty-sdk';
-
-const handler = async (): Promise<{ message: string }> => {
-  return { message: 'Hello, World!' };
-};
-
-// Logic function handler - rename and implement your logic
-export default defineLogicFunction({
-  universalIdentifier: '${universalIdentifier}',
-  name: 'hello-world-logic-function',
-  description: 'A simple logic function',
-  timeoutSeconds: 5,
-  handler,
-  httpRouteTriggerSettings: {
-    path: '/hello-world-logic-function',
-    httpMethod: 'GET',
-    isAuthRequired: false,
-  },
-});
-`;
-
-  await fs.ensureDir(join(appDirectory, fileFolder ?? ''));
-  await fs.writeFile(join(appDirectory, fileFolder ?? '', fileName), content);
+  await fs.writeFile(join(appDirectory, 'default-function.role.ts'), content);
 };
 
 const createApplicationConfig = async ({
   displayName,
   description,
   appDirectory,
-  fileFolder,
-  fileName,
 }: {
   displayName: string;
   description?: string;
   appDirectory: string;
-  fileFolder?: string;
-  fileName: string;
 }) => {
-  const content = `import { defineApplication } from 'twenty-sdk';
-import { DEFAULT_ROLE_UNIVERSAL_IDENTIFIER } from 'src/roles/default-role';
+  const content = `import { defineApp } from 'twenty-sdk';
+import { DEFAULT_FUNCTION_ROLE_UNIVERSAL_IDENTIFIER } from './default-function.role';
 
-export default defineApplication({
+export default defineApp({
   universalIdentifier: '${v4()}',
   displayName: '${displayName}',
   description: '${description ?? ''}',
-  defaultRoleUniversalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+  functionRoleUniversalIdentifier: DEFAULT_FUNCTION_ROLE_UNIVERSAL_IDENTIFIER,
 });
 `;
 
-  await fs.ensureDir(join(appDirectory, fileFolder ?? ''));
-  await fs.writeFile(join(appDirectory, fileFolder ?? '', fileName), content);
+  await fs.writeFile(join(appDirectory, 'application.config.ts'), content);
 };
 
 const createPackageJson = async ({
@@ -261,18 +156,23 @@ const createPackageJson = async ({
     },
     packageManager: 'yarn@4.9.2',
     scripts: {
-      twenty: 'twenty',
+      'create-entity': 'twenty app add',
+      dev: 'twenty app dev',
+      generate: 'twenty app generate',
+      sync: 'twenty app sync',
+      logs: 'twenty app logs',
+      uninstall: 'twenty app uninstall',
+      help: 'twenty help',
+      auth: 'twenty auth login',
       lint: 'eslint',
-      'lint:fix': 'eslint --fix',
+      'lint-fix': 'eslint --fix',
     },
     dependencies: {
-      'twenty-sdk': 'latest',
+      'twenty-sdk': '0.3.1',
     },
     devDependencies: {
       typescript: '^5.9.3',
       '@types/node': '^24.7.2',
-      '@types/react': '^18.2.0',
-      react: '^18.2.0',
       eslint: '^9.32.0',
       'typescript-eslint': '^8.50.0',
     },

packages/create-twenty-app/tsconfig.json

@@ -1,5 +1,4 @@
 {
-  "extends": "../../tsconfig.base.json",
   "compilerOptions": {
     "allowJs": false,
     "esModuleInterop": false,
@@ -9,18 +8,19 @@
     "noImplicitAny": true,
     "strictBindCallApply": false,
     "noEmit": true,
-    "types": ["jest", "node"],
     "paths": {
       "@/*": ["./src/*"]
-    },
-    "jsx": "react"
+    }
   },
-  "include": [
-    "src/**/*.ts",
-    "src/**/*.tsx",
-    "src/**/*.d.ts",
-    "**/__mocks__/**/*",
-    "vite.config.ts",
-    "jest.config.mjs"
-  ]
+  "files": [],
+  "include": [],
+  "references": [
+    {
+      "path": "./tsconfig.lib.json"
+    },
+    {
+      "path": "./tsconfig.spec.json"
+    }
+  ],
+  "extends": "../../tsconfig.base.json"
 }

packages/create-twenty-app/tsconfig.spec.json

@@ -0,0 +1,16 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "types": ["jest", "node"]
+  },
+  "include": [
+    "**/__mocks__/**/*",
+    "vite.config.ts",
+    "jest.config.mjs",
+    "src/**/*.d.ts",
+    "src/**/*.spec.ts",
+    "src/**/*.spec.tsx",
+    "src/**/*.test.ts",
+    "src/**/*.test.tsx"
+  ]
+}

packages/create-twenty-app/vite.config.ts

@@ -4,7 +4,6 @@ import { defineConfig } from 'vite';
 import dts from 'vite-plugin-dts';
 import tsconfigPaths from 'vite-tsconfig-paths';
 import packageJson from './package.json';
-import type { PackageJson } from 'type-fest';
 
 const moduleEntries = Object.keys((packageJson as any).exports || {})
   .filter(
@@ -71,23 +70,12 @@ export default defineConfig(() => {
       outDir: 'dist',
       lib: { entry: entries, name: 'create-twenty-app' },
       rollupOptions: {
-        external: (id: string) => {
-          if (/^node:/.test(id)) {
-            return true;
-          }
-
-          const builtins = ['path', 'fs', 'child_process', 'util'];
-
-          if (builtins.includes(id)) {
-            return true;
-          }
-
-          const deps = Object.keys(
-            (packageJson as PackageJson).dependencies || {},
-          );
-
-          return deps.some((dep) => id === dep || id.startsWith(dep + '/'));
-        },
+        external: [
+          ...Object.keys((packageJson as any).dependencies || {}),
+          'path',
+          'fs',
+          'child_process',
+        ],
         output: [
           {
             format: 'es',

packages/twenty-apps/.gitignore

@@ -1,2 +1 @@
 generated
-

packages/twenty-apps/community/activity-summary/.yarnrc.yml

@@ -1 +1,3 @@
+yarnPath: .yarn/releases/yarn-4.9.2.cjs
+
 nodeLinker: node-modules

packages/twenty-apps/community/ai-meeting-transcript/.yarnrc.yml

@@ -1 +1,3 @@
+yarnPath: .yarn/releases/yarn-4.9.2.cjs
+
 nodeLinker: node-modules

packages/twenty-apps/community/fireflies/.yarnrc.yml

@@ -1 +1,3 @@
+yarnPath: .yarn/releases/yarn-4.9.2.cjs
+
 nodeLinker: node-modules

packages/twenty-apps/community/fireflies/README.md

@@ -230,7 +230,7 @@ npm run test -- --watch
 npx twenty-cli app dev
 
 # Type checking
-npx tsgo --noEmit
+npx tsc --noEmit
 ```
 
 ## Testing

packages/twenty-apps/community/fireflies/project.json

@@ -24,7 +24,10 @@
       }
     },
     "typecheck": {
-      "dependsOn": ["^build"]
+      "executor": "nx:run-commands",
+      "options": {
+        "command": "tsc --noEmit --project {projectRoot}/tsconfig.json"
+      }
     },
     "lint": {
       "executor": "@nx/eslint:lint",

packages/twenty-apps/community/last-email-interaction/.yarnrc.yml

@@ -1 +1,3 @@
+yarnPath: .yarn/releases/yarn-4.9.2.cjs
+
 nodeLinker: node-modules

packages/twenty-apps/community/linkedin-browser-extension/application/.yarnrc.yml

@@ -1 +1,3 @@
+yarnPath: .yarn/releases/yarn-4.9.2.cjs
+
 nodeLinker: node-modules

packages/twenty-apps/community/linkedin-browser-extension/browser-extension/eslint.config.mjs

@@ -1,7 +1,7 @@
 import typescriptParser from '@typescript-eslint/parser';
 import path from 'path';
 import { fileURLToPath } from 'url';
-import reactConfig from '../../../../twenty-eslint-rules/eslint.config.react.mjs';
+import reactConfig from '../../../../../tools/eslint-rules/eslint.config.react.mjs';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);

packages/twenty-apps/community/linkedin-browser-extension/browser-extension/tsconfig.json

@@ -3,8 +3,9 @@
   "compilerOptions": {
     "jsx": "react-jsx",
     "jsxImportSource": "@emotion/react",
+    "baseUrl": "src",
     "paths": {
-      "@/*": ["./src/*"]
+      "@/*": ["*"]
     }
   }
 }

packages/twenty-apps/community/mailchimp-synchronizer/.yarnrc.yml

@@ -1 +1,3 @@
+yarnPath: .yarn/releases/yarn-4.9.2.cjs
+
 nodeLinker: node-modules

packages/twenty-apps/community/meeting-transcript/.yarnrc.yml

@@ -1 +1,3 @@
+yarnPath: .yarn/releases/yarn-4.9.2.cjs
+
 nodeLinker: node-modules

packages/twenty-apps/community/stripe-synchronizer/.yarnrc.yml

@@ -1 +1,3 @@
+yarnPath: .yarn/releases/yarn-4.9.2.cjs
+
 nodeLinker: node-modules

packages/twenty-apps/community/webmetic/.yarnrc.yml

@@ -1 +1,3 @@
+yarnPath: .yarn/releases/yarn-4.9.2.cjs
+
 nodeLinker: node-modules

packages/twenty-apps/hello-world/.yarnrc.yml

@@ -1 +1,3 @@
+yarnPath: .yarn/releases/yarn-4.9.2.cjs
+
 nodeLinker: node-modules

packages/twenty-apps/hello-world/src/application.config.ts

@@ -13,7 +13,7 @@ const config: ApplicationConfig = {
       isSecret: false,
     },
   },
-  defaultRoleUniversalIdentifier: 'b648f87b-1d26-4961-b974-0908fd991061',
+  functionRoleUniversalIdentifier: 'b648f87b-1d26-4961-b974-0908fd991061',
 };
 
 export default config;

packages/twenty-apps/hello-world/src/objects/postCard.ts

@@ -95,7 +95,7 @@ export class PostCard {
     label: 'Notes',
     icon: 'IconComment',
     inverseSideTargetUniversalIdentifier:
-      STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.note.universalIdentifier,
+      STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.note,
     onDelete: OnDeleteAction.CASCADE,
   })
   notes: Note[];

packages/twenty-apps/hello-world/src/roles/function-role.ts

@@ -14,7 +14,7 @@ export const functionRole: RoleConfig = {
   canBeAssignedToApiKeys: false,
   objectPermissions: [
     {
-      objectUniversalIdentifier: '9f9882af-170c-4879-b013-f9628b77c050',
+      objectNameSingular: 'postCard',
       canReadObjectRecords: true,
       canUpdateObjectRecords: true,
       canSoftDeleteObjectRecords: false,
@@ -23,8 +23,8 @@ export const functionRole: RoleConfig = {
   ],
   fieldPermissions: [
     {
-      objectUniversalIdentifier: '9f9882af-170c-4879-b013-f9628b77c050',
-      fieldUniversalIdentifier: 'b2c37dc0-8ae7-470e-96cd-1476b47dfaff',
+      objectNameSingular: 'postCard',
+      fieldName: 'content',
       canReadFieldValue: false,
       canUpdateFieldValue: false,
     },

packages/twenty-apps/internal/self-hosting/application.config.ts

@@ -0,0 +1,21 @@
+import { type ApplicationConfig } from 'twenty-sdk/application';
+
+const config: ApplicationConfig = {
+  universalIdentifier: '94f7db30-59e5-4b09-a5fe-64cd3d4a65b0',
+  displayName: 'Self Hosting',
+  description: 'Used to manage billing and telemetry of self-hosted instances',
+  applicationVariables: {
+    TWENTY_API_KEY: {
+      universalIdentifier: 'a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d',
+      description: 'Twenty API key for creating selfHostingUser records',
+      isSecret: true,
+    },
+    TWENTY_API_URL: {
+      universalIdentifier: 'b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e',
+      description: 'Twenty API URL (e.g., https://api.twenty.com)',
+      isSecret: false,
+    },
+  },
+};
+
+export default config;

packages/twenty-apps/internal/self-hosting/package.json

@@ -8,25 +8,8 @@
     "yarn": ">=4.0.2"
   },
   "packageManager": "yarn@4.9.2",
-  "scripts": {
-    "auth:login": "twenty auth login",
-    "auth:logout": "twenty auth logout",
-    "auth:status": "twenty auth status",
-    "auth:switch": "twenty auth switch",
-    "auth:list": "twenty auth list",
-    "app:dev": "twenty app dev",
-    "app:sync": "twenty app sync",
-    "entity:add": "twenty entity add",
-    "app:generate": "twenty app generate",
-    "function:logs": "twenty function logs",
-    "function:execute": "twenty function execute",
-    "app:uninstall": "twenty app uninstall",
-    "help": "twenty help",
-    "lint": "eslint",
-    "lint:fix": "eslint --fix"
-  },
   "dependencies": {
-    "twenty-sdk": "0.3.1"
+    "twenty-sdk": "0.0.4"
   },
   "devDependencies": {
     "@types/node": "^24.7.2"

packages/twenty-apps/internal/self-hosting/src/app/application.config.ts

@@ -1,19 +0,0 @@
-import { defineApp } from 'twenty-sdk';
-
-export default defineApp({
-  universalIdentifier: '94f7db30-59e5-4b09-a5fe-64cd3d4a65b0',
-  displayName: 'Self Hosting',
-  description: 'Used to manage billing and telemetry of self-hosted instances',
-  applicationVariables: {
-    TWENTY_API_KEY: {
-      universalIdentifier: 'a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d',
-      description: 'Twenty API key for creating selfHostingUser records',
-      isSecret: true,
-    },
-    TWENTY_API_URL: {
-      universalIdentifier: 'b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e',
-      description: 'Twenty API URL (e.g., https://api.twenty.com)',
-      isSecret: false,
-    },
-  },
-});

packages/twenty-apps/internal/self-hosting/src/app/selfHostingUser.object.ts

@@ -1,18 +0,0 @@
-import { FieldType, defineObject } from 'twenty-sdk';
-
-export default defineObject({
-  universalIdentifier: '06f3fb53-599e-4c6b-9df6-8f731973afd7',
-  nameSingular: 'selfHostingUser',
-  namePlural: 'selfHostingUsers',
-  labelSingular: 'Self Hosting User',
-  labelPlural: 'Self Hosting Users',
-  fields: [
-    {
-      type: FieldType.EMAILS,
-      name: 'email',
-      label: 'Email',
-      description: 'The email of the self hosting user',
-      universalIdentifier: 'a4b7892c-431a-4d44-973e-a5481652704f',
-    },
-  ],
-});

packages/twenty-apps/internal/self-hosting/src/app/telemetryWebhook.function.ts

@@ -1,132 +0,0 @@
-import { defineFunction } from 'twenty-sdk';
-import { createClient } from '../../generated';
-
-// TODO: import from twenty-sdk when 0.4.0 is deployed
-type ServerlessFunctionEvent<TBody = object> = {
-  headers: Record<string, string | undefined>;
-  queryStringParameters: Record<string, string | undefined>;
-  pathParameters: Record<string, string | undefined>;
-  body: TBody | null;
-  isBase64Encoded: boolean;
-  requestContext: {
-    http: {
-      method: string;
-      path: string;
-    };
-  };
-};
-
-type TelemetryEventPayload = {
-  action: string;
-  timestamp: string;
-  version: string;
-  payload: {
-    userId: string | null;
-    workspaceId: string | null;
-    payload?: {
-      events?: Array<{
-        userId?: string;
-        userEmail?: string;
-        userFirstName?: string;
-        userLastName?: string;
-        locale?: string;
-        serverUrl?: string;
-      }>;
-    };
-  };
-};
-
-export const main = async (
-  params: ServerlessFunctionEvent<TelemetryEventPayload>,
-): Promise<{ success: boolean; message: string; error?: string }> => {
-  try {
-    const { action, payload } = params.body || {};
-
-    if (action !== 'user_signup') {
-      return {
-        success: true,
-        message: `Event type '${action}' ignored`,
-      };
-    }
-
-    const userEmail =
-      payload?.payload?.events?.[0]?.userEmail ||
-      payload?.payload?.events?.[0]?.userId;
-
-    if (!userEmail) {
-      return {
-        success: false,
-        message: 'No email found in telemetry event',
-        error: 'Missing userEmail in payload',
-      };
-    }
-
-    if (
-      userEmail.toLowerCase().includes('example') ||
-      userEmail.toLowerCase().includes('test')
-    ) {
-      return {
-        success: true,
-        message: `Email '${userEmail}' ignored (contains test/example data)`,
-      };
-    }
-
-    const client = createClient({
-      url: `${process.env.TWENTY_API_URL}/graphql`,
-      headers: {
-        'Content-Type': 'application/json',
-        Authorization: `Bearer ${process.env.TWENTY_API_KEY}`,
-      },
-    });
-
-    // Create or update selfHostingUser record
-    const result = await client.mutation({
-      createSelfHostingUser: {
-        __args: {
-          data: {
-            name:
-              payload?.payload?.events?.[0]?.userFirstName +
-              ' ' +
-              payload?.payload?.events?.[0]?.userLastName,
-            email: {
-              primaryEmail: userEmail,
-              additionalEmails: null,
-            },
-          },
-          upsert: true,
-        },
-        id: true,
-        email: {
-          primaryEmail: true,
-        },
-      },
-    });
-
-    return {
-      success: true,
-      message: `Self hosting user created/updated: ${result.createSelfHostingUser?.id}`,
-    };
-  } catch (error) {
-    return {
-      success: false,
-      message: 'Failed to process telemetry event',
-      error: error instanceof Error ? error.message : String(error),
-    };
-  }
-};
-
-export default defineFunction({
-  universalIdentifier: '10104201-622b-4a5e-9f27-8f2af19b2a3c',
-  name: 'telemetry-webhook',
-  timeoutSeconds: 5,
-  handler: main,
-  triggers: [
-    {
-      universalIdentifier: '7c8e3f5a-9b4c-4d1e-8f2a-1b3c4d5e6f7a',
-      type: 'route',
-      path: '/webhook/telemetry',
-      httpMethod: 'POST',
-      isAuthRequired: false,
-    },
-  ],
-});

packages/twenty-apps/internal/self-hosting/src/selfHostingUser.ts

@@ -0,0 +1,18 @@
+import { FieldMetadata, FieldMetadataType, ObjectMetadata } from 'twenty-sdk/application';
+
+@ObjectMetadata({
+  universalIdentifier: '06f3fb53-599e-4c6b-9df6-8f731973afd7',
+  nameSingular: 'selfHostingUser',
+  namePlural: 'selfHostingUsers',
+  labelSingular: 'Self Hosting User',
+  labelPlural: 'Self Hosting Users',
+})
+export class SelfHostingUser {
+  @FieldMetadata({
+    type: FieldMetadataType.EMAILS,
+    label: 'Email',
+    description: 'The email of the self hosting user',
+    universalIdentifier: '06f3fb53-599e-4c6b-9df6-8f731973afd7',
+  })
+  email: object;
+}

packages/twenty-apps/internal/self-hosting/src/telemetryWebhook.ts

@@ -0,0 +1,114 @@
+import { type ServerlessFunctionConfig } from 'twenty-sdk/application';
+import { createClient } from '../generated';
+
+type TelemetryEventPayload = {
+  action: string;
+  timestamp: string;
+  version: string;
+  payload: {
+    userId: string | null;
+    workspaceId: string | null;
+    payload?: {
+      events?: Array<{
+        userId?: string;
+        userEmail?: string;
+        userFirstName?: string;
+        userLastName?: string;
+        locale?: string;
+        serverUrl?: string;
+      }>;
+    };
+  };
+};
+
+export const main = async (
+  params: TelemetryEventPayload,
+): Promise<{ success: boolean; message: string; error?: string }> => {
+  try {
+    const { action, payload } = params;
+
+    if (action !== 'user_signup') {
+      return {
+        success: true,
+        message: `Event type '${action}' ignored`,
+      };
+    }
+
+    const userEmail =
+      payload?.payload?.events?.[0]?.userEmail ||
+      payload?.payload?.events?.[0]?.userId;
+
+    if (!userEmail) {
+      return {
+        success: false,
+        message: 'No email found in telemetry event',
+        error: 'Missing userEmail in payload',
+      };
+    }
+
+    if (
+      userEmail.toLowerCase().includes('example') ||
+      userEmail.toLowerCase().includes('test')
+    ) {
+      return {
+        success: true,
+        message: `Email '${userEmail}' ignored (contains test/example data)`,
+      };
+    }
+
+    const client = createClient({
+      url: `${process.env.TWENTY_API_URL}/graphql`,
+      headers: {
+        'Content-Type': 'application/json',
+        Authorization: `Bearer ${process.env.TWENTY_API_KEY}`,
+      },
+    });
+
+    // Create or update selfHostingUser record
+    const result = await client.mutation({
+      createSelfHostingUser: {
+        __args: {
+          data: {
+            name: payload?.payload?.events?.[0]?.userFirstName + ' ' + payload?.payload?.events?.[0]?.userLastName,
+            email: {
+              primaryEmail: userEmail,
+              additionalEmails: null,
+            },
+          },
+          upsert: true,
+        },
+        id: true,
+        email: {
+          primaryEmail: true,
+        },
+      },
+    });
+
+    return {
+      success: true,
+      message: `Self hosting user created/updated: ${result.createSelfHostingUser?.id}`,
+    };
+  } catch (error) {
+    return {
+      success: false,
+      message: 'Failed to process telemetry event',
+      error: error instanceof Error ? error.message : String(error),
+    };
+  }
+};
+
+export const config: ServerlessFunctionConfig = {
+  universalIdentifier: '10104201-622b-4a5e-9f27-8f2af19b2a3c',
+  name: 'telemetry-webhook',
+  timeoutSeconds: 5,
+  triggers: [
+    {
+      universalIdentifier: '7c8e3f5a-9b4c-4d1e-8f2a-1b3c4d5e6f7a',
+      type: 'route',
+      path: '/webhook/telemetry',
+      httpMethod: 'POST',
+      isAuthRequired: false,
+    },
+  ],
+};
+

packages/twenty-apps/internal/self-hosting/tsconfig.json

@@ -20,11 +20,7 @@
     "lib": ["es2020", "dom"],
     "skipLibCheck": true,
     "skipDefaultLibCheck": true,
-    "resolveJsonModule": true,
-    "paths": {
-      "src/*": ["./src/*"],
-      "~/*": ["./*"]
-    }
+    "resolveJsonModule": true
   },
   "exclude": [
     "node_modules",

packages/twenty-docker/helm/twenty/templates/_helpers.tpl

@@ -42,50 +42,25 @@
 {{- regexFind "\\|(.+)$" . | trimPrefix "|" -}}
 {{- end -}}
 
-{{/* Check if using external secret for database password */}}
-{{- define "twenty.db.useExternalSecret" -}}
-{{- if and (not .Values.db.enabled) .Values.db.external.secretName .Values.db.external.passwordKey -}}
-true
-{{- else -}}
-false
-{{- end -}}
-{{- end -}}
-
-{{/* Database URL secret name */}}
-{{- define "twenty.dbUrl.secretName" -}}
-{{- printf "%s-db-url" (include "twenty.fullname" .) -}}
-{{- end -}}
-
-{{/* Database password secret name */}}
-{{- define "twenty.dbPassword.secretName" -}}
-{{- if eq (include "twenty.db.useExternalSecret" .) "true" -}}
-{{- .Values.db.external.secretName -}}
-{{- else -}}
-{{- include "twenty.dbUrl.secretName" . -}}
-{{- end -}}
-{{- end -}}
-
-{{/* Database password secret key */}}
-{{- define "twenty.dbPassword.secretKey" -}}
-{{- if eq (include "twenty.db.useExternalSecret" .) "true" -}}
-{{- .Values.db.external.passwordKey -}}
+{{/* Compose DB connection URL */}}
+{{- define "twenty.dbUrl" -}}
+{{- if .Values.server.env.PG_DATABASE_URL -}}
+{{- .Values.server.env.PG_DATABASE_URL -}}
 {{- else if .Values.db.enabled -}}
-appPassword
+{{- $host := printf "%s-db" (include "twenty.fullname" .) -}}
+{{- $user := .Values.db.internal.appUser | default "twenty_app_user" -}}
+{{- $pass := .Values.db.internal.appPassword | default (randAlphaNum 32) -}}
+{{- $db := .Values.db.internal.database | default "twenty" -}}
+{{- printf "postgres://%s:%s@%s.%s.svc.cluster.local/%s" $user $pass $host (include "twenty.namespace" .) $db -}}
 {{- else -}}
-password
-{{- end -}}
-{{- end -}}
-
-{{/* Database URL template for external secret (will be evaluated at runtime) */}}
-{{- define "twenty.dbUrl.template" -}}
-{{- if eq (include "twenty.db.useExternalSecret" .) "true" -}}
 {{- $scheme := "postgres" -}}
 {{- $host := .Values.db.external.host -}}
 {{- $port := .Values.db.external.port | default 5432 -}}
 {{- $user := .Values.db.external.user | default "postgres" -}}
+{{- $pass := .Values.db.external.password | default "postgres" -}}
 {{- $db := .Values.db.external.database | default "twenty" -}}
 {{- $qs := ternary "?sslmode=require" "" (eq .Values.db.external.ssl true) -}}
-{{- printf "%s://%s:$(DB_PASSWORD)@%s:%v/%s%s" $scheme $user $host $port $db $qs -}}
+{{- printf "%s://%s:%s@%s:%v/%s%s" $scheme $user $pass $host $port $db $qs -}}
 {{- end -}}
 {{- end -}}
 
@@ -103,11 +78,9 @@ password
 {{- end -}}
 {{- end -}}
 
-{{/* Compose Server URL from override, ingress, or service */}}
+{{/* Compose Server URL from ingress, else service */}}
 {{- define "twenty.serverUrl" -}}
-{{- if .Values.server.env.SERVER_URL -}}
-{{- .Values.server.env.SERVER_URL -}}
-{{- else if and .Values.server.ingress.enabled (gt (len .Values.server.ingress.hosts) 0) -}}
+{{- if and .Values.server.ingress.enabled (gt (len .Values.server.ingress.hosts) 0) -}}
 {{- $host := (index .Values.server.ingress.hosts 0).host -}}
 {{- $tls := gt (len .Values.server.ingress.tls) 0 -}}
 {{- $scheme := ternary "https" "http" $tls -}}

packages/twenty-docker/helm/twenty/templates/deployment-server.yaml

@@ -116,21 +116,11 @@ spec:
             - >-
               npx -y typeorm migration:run -d dist/database/typeorm/core/core.datasource
           env:
-            {{- if eq (include "twenty.db.useExternalSecret" .) "true" }}
-            - name: DB_PASSWORD
-              valueFrom:
-                secretKeyRef:
-                  name: {{ include "twenty.dbPassword.secretName" . }}
-                  key: {{ include "twenty.dbPassword.secretKey" . }}
-            - name: PG_DATABASE_URL
-              value: {{ include "twenty.dbUrl.template" . | quote }}
-            {{- else }}
             - name: PG_DATABASE_URL
               valueFrom:
                 secretKeyRef:
-                  name: {{ include "twenty.dbUrl.secretName" . }}
+                  name: {{ include "twenty.fullname" . }}-db-url
                   key: url
-            {{- end }}
       containers:
         - name: server
           {{- $img := include "twenty.server.image" . }}
@@ -139,21 +129,11 @@ spec:
           env:
             - name: SERVER_URL
               value: {{ include "twenty.serverUrl" . | quote }}
-            {{- if eq (include "twenty.db.useExternalSecret" .) "true" }}
-            - name: DB_PASSWORD
-              valueFrom:
-                secretKeyRef:
-                  name: {{ include "twenty.dbPassword.secretName" . }}
-                  key: {{ include "twenty.dbPassword.secretKey" . }}
-            - name: PG_DATABASE_URL
-              value: {{ include "twenty.dbUrl.template" . | quote }}
-            {{- else }}
             - name: PG_DATABASE_URL
               valueFrom:
                 secretKeyRef:
-                  name: {{ include "twenty.dbUrl.secretName" . }}
+                  name: {{ include "twenty.fullname" . }}-db-url
                   key: url
-            {{- end }}
             - name: REDIS_URL
               value: {{ include "twenty.redisUrl" . | quote }}
             - name: SIGN_IN_PREFILLED

packages/twenty-docker/helm/twenty/templates/deployment-worker.yaml

@@ -52,21 +52,11 @@ spec:
           env:
             - name: SERVER_URL
               value: {{ include "twenty.serverUrl" . | quote }}
-            {{- if eq (include "twenty.db.useExternalSecret" .) "true" }}
-            - name: DB_PASSWORD
-              valueFrom:
-                secretKeyRef:
-                  name: {{ include "twenty.dbPassword.secretName" . }}
-                  key: {{ include "twenty.dbPassword.secretKey" . }}
-            - name: PG_DATABASE_URL
-              value: {{ include "twenty.dbUrl.template" . | quote }}
-            {{- else }}
             - name: PG_DATABASE_URL
               valueFrom:
                 secretKeyRef:
-                  name: {{ include "twenty.dbUrl.secretName" . }}
+                  name: {{ include "twenty.fullname" . }}-db-url
                   key: url
-            {{- end }}
             - name: REDIS_URL
               value: {{ include "twenty.redisUrl" . | quote }}
             - name: STORAGE_TYPE

packages/twenty-docker/helm/twenty/templates/secret-db-url.yaml

@@ -1,5 +1,4 @@
 {{- $secretName := printf "%s-db-url" (include "twenty.fullname" .) -}}
-{{- if .Values.db.enabled -}}
 {{- $existingSecret := lookup "v1" "Secret" (include "twenty.namespace" .) $secretName -}}
 {{- $appPassword := "" -}}
 {{- if $existingSecret -}}
@@ -21,25 +20,3 @@ type: Opaque
 stringData:
   url: {{ printf "postgres://%s:%s@%s-db.%s.svc.cluster.local/%s" (urlquery $appUser) (urlquery $appPassword) (include "twenty.fullname" .) (include "twenty.namespace" .) (.Values.db.internal.database | default "twenty") | quote }}
   appPassword: {{ $appPassword | quote }}
-{{- else if not .Values.db.external.secretName -}}
-{{- $scheme := "postgres" -}}
-{{- $host := .Values.db.external.host -}}
-{{- $port := .Values.db.external.port | default 5432 -}}
-{{- $user := .Values.db.external.user | default "postgres" -}}
-{{- $pass := .Values.db.external.password | default "" -}}
-{{- $db := .Values.db.external.database | default "twenty" -}}
-{{- $qs := ternary "?sslmode=require" "" (eq .Values.db.external.ssl true) -}}
-apiVersion: v1
-kind: Secret
-metadata:
-  name: {{ $secretName }}
-  namespace: {{ include "twenty.namespace" . }}
-  labels:
-    app.kubernetes.io/name: {{ include "twenty.name" . }}
-    app.kubernetes.io/instance: {{ .Release.Name }}
-    app.kubernetes.io/component: server
-type: Opaque
-stringData:
-  url: {{ printf "%s://%s:%s@%s:%v/%s%s" $scheme (urlquery $user) (urlquery $pass) $host $port $db $qs | quote }}
-  password: {{ $pass | quote }}
-{{- end -}}

packages/twenty-docker/helm/twenty/values.schema.json

@@ -45,7 +45,6 @@
         "env": {
           "type": "object",
           "properties": {
-            "SERVER_URL": { "type": "string", "description": "Override for the server URL (e.g., https://crm.example.com). If not set, derived from ingress or service." },
             "NODE_PORT": { "type": "integer", "minimum": 1 },
             "PG_DATABASE_URL": { "type": "string" },
             "REDIS_URL": { "type": "string" },

packages/twenty-docker/helm/twenty/values.yaml

@@ -19,13 +19,8 @@ storage:
     bucket: ""
     region: ""
     endpoint: ""
-    # Option A: direct values
     accessKeyId: ""
     secretAccessKey: ""
-    # Option B: reference a Secret
-    # secretName: my-s3-creds
-    # accessKeyIdKey: accessKeyId
-    # secretAccessKeyKey: secretAccessKey
 
 # Auth tokens (random if not provided)
 secrets:
@@ -142,8 +137,6 @@ db:
     password: ""
     database: twenty
     ssl: false
-    secretName: ""
-    passwordKey: ""
 
 # Redis
 redisInternal:

packages/twenty-docker/twenty-website/Dockerfile

@@ -8,7 +8,7 @@ COPY ./yarn.lock .
 COPY ./.yarnrc.yml .
 COPY ./.yarn/releases /app/.yarn/releases
 COPY ./.yarn/patches /app/.yarn/patches
-COPY ./packages/twenty-eslint-rules /app/packages/twenty-eslint-rules
+COPY ./tools/eslint-rules /app/tools/eslint-rules
 COPY ./packages/twenty-ui/package.json /app/packages/twenty-ui/
 COPY ./packages/twenty-shared/package.json /app/packages/twenty-shared/
 COPY ./packages/twenty-website/package.json /app/packages/twenty-website/package.json

packages/twenty-docker/twenty/Dockerfile

@@ -14,7 +14,6 @@ COPY ./packages/twenty-server/patches /app/packages/twenty-server/patches
 COPY ./packages/twenty-ui/package.json /app/packages/twenty-ui/
 COPY ./packages/twenty-shared/package.json /app/packages/twenty-shared/
 COPY ./packages/twenty-front/package.json /app/packages/twenty-front/
-COPY ./packages/twenty-sdk/package.json /app/packages/twenty-sdk/
 
 # Install all dependencies
 RUN yarn && yarn cache clean && npx nx reset
@@ -40,7 +39,6 @@ ARG REACT_APP_SERVER_BASE_URL
 COPY ./packages/twenty-front /app/packages/twenty-front
 COPY ./packages/twenty-ui /app/packages/twenty-ui
 COPY ./packages/twenty-shared /app/packages/twenty-shared
-COPY ./packages/twenty-sdk /app/packages/twenty-sdk
 RUN npx nx build twenty-front
 
 

packages/twenty-docker/twenty/entrypoint.sh

@@ -17,10 +17,7 @@ setup_and_migrate_db() {
         yarn database:migrate:prod
     fi
 
-    yarn command:prod cache:flush
     yarn command:prod upgrade
-    yarn command:prod cache:flush
-
     echo "Successfully migrated DB!"
 }
 

packages/twenty-docs/developers/contribute/capabilities/local-setup.mdx

@@ -159,12 +159,6 @@ You should run all commands in the following steps from the root of the project.
       CREATE ROLE postgres WITH SUPERUSER LOGIN;
     ```
     This creates a superuser role named `postgres` with login access.
-      ```bash
-      Role name | Attributes  | Member of
-      -----------+-------------+-----------
-      postgres  | Superuser   | {}
-      john      | Superuser   | {}
-    ```
 
     **Option 2:** If you have docker installed:
     ```bash

packages/twenty-docs/developers/extend/capabilities/apps.mdx

@@ -9,13 +9,16 @@ Apps are currently in alpha testing. The feature is functional but still evolvin
 
 ## What Are Apps?
 
-Apps let you build and manage Twenty customizations **as code**. Instead of configuring everything through the UI, you define your data model and logic functions in code — making it faster to build, maintain, and roll out to multiple workspaces.
+Apps let you build and manage Twenty customizations **as code**. Instead of configuring everything through the UI, you define your data model and serverless functions in code — making it faster to build, maintain, and roll out to multiple workspaces.
 
 **What you can do today:**
 - Define custom objects and fields as code (managed data model)
-- Build logic functions with custom triggers
+- Build serverless functions with custom triggers
 - Deploy the same app across multiple workspaces
 
+**Coming soon:**
+- Custom UI layouts and components
+
 ## Prerequisites
 
 - Node.js 24+ and Yarn 4
@@ -30,37 +33,33 @@ Create a new app using the official scaffolder, then authenticate and start deve
 npx create-twenty-app@latest my-twenty-app
 cd my-twenty-app
 
-# If you don't use yarn@4
-corepack enable
-yarn install
-
 # Authenticate using your API key (you'll be prompted)
-yarn twenty auth:login
+yarn auth
 
 # Start dev mode: automatically syncs local changes to your workspace
-yarn twenty app:dev
+yarn dev
 ```
 
 From here you can:
 
 ```bash filename="Terminal"
 # Add a new entity to your application (guided)
-yarn twenty entity:add
+yarn create-entity
 
 # Generate a typed Twenty client and workspace entity types
-yarn twenty app:generate
+yarn generate
 
-# Watch your application's function logs
-yarn twenty function:logs
+# Run a one‑time sync (instead of watch mode)
+yarn sync
 
-# Execute a function by name
-yarn twenty function:execute -n my-function -p '{"name": "test"}'
+# Watch your application's functions logs
+yarn logs
 
 # Uninstall the application from the current workspace
-yarn twenty app:uninstall
+yarn uninstall
 
 # Display commands' help
-yarn twenty help
+yarn help
 ```
 
 See also: the CLI reference pages for [create-twenty-app](https://www.npmjs.com/package/create-twenty-app) and [twenty-sdk CLI](https://www.npmjs.com/package/twenty-sdk).
@@ -84,116 +83,121 @@ my-twenty-app/
   .nvmrc
   .yarnrc.yml
   .yarn/
+    releases/
+      yarn-4.9.2.cjs
     install-state.gz
   eslint.config.mjs
   tsconfig.json
   README.md
-  public/                           # Public assets folder (images, fonts, etc.)
   src/
-  ├── application-config.ts           # Required - main application configuration
-  ├── roles/
-  │   └── default-role.ts               # Default role for logic functions
-  ├── logic-functions/
-  │   └── hello-world.ts                # Example logic function
-  └── front-components/
-      └── hello-world.tsx               # Example front component
+    app/
+      application.config.ts     # Required - main application configuration
+      default-function.role.ts  # Default role for serverless functions
+      // your entities (*.object.ts, *.function.ts, *.role.ts)
+    utils/                      # Optional - handler implementations & utilities
+```
+
+### Convention-over-configuration
+
+Applications use a **convention-over-configuration** approach where entities are detected by their file suffix. This allows flexible organization within the `src/app/` folder:
+
+| File suffix | Entity type |
+|-------------|-------------|
+| `*.object.ts` | Custom object definitions |
+| `*.function.ts` | Serverless function definitions |
+| `*.role.ts` | Role definitions |
+
+### Supported folder organizations
+
+You can organize your entities in any of these patterns:
+
+**Traditional (by type):**
+```text
+src/app/
+├── application.config.ts
+├── objects/
+│   └── postCard.object.ts
+├── functions/
+│   └── createPostCard.function.ts
+└── roles/
+    └── admin.role.ts
+```
+
+**Feature-based:**
+```text
+src/app/
+├── application.config.ts
+└── post-card/
+    ├── postCard.object.ts
+    ├── createPostCard.function.ts
+    └── postCardAdmin.role.ts
+```
+
+**Flat:**
+```text
+src/app/
+├── application.config.ts
+├── postCard.object.ts
+├── createPostCard.function.ts
+└── admin.role.ts
 ```
 
 At a high level:
 
-- **package.json**: Declares the app name, version, engines (Node 24+, Yarn 4), and adds `twenty-sdk` plus a `twenty` script that delegates to the local `twenty` CLI. Run `yarn twenty help` to list all available commands.
+- **package.json**: Declares the app name, version, engines (Node 24+, Yarn 4), and adds `twenty-sdk` plus scripts like `dev`, `sync`, `generate`, `create-entity`, `logs`, `uninstall`, and `auth` that delegate to the local `twenty` CLI.
 - **.gitignore**: Ignores common artifacts such as `node_modules`, `.yarn`, `generated/` (typed client), `dist/`, `build/`, coverage folders, log files, and `.env*` files.
 - **yarn.lock**, **.yarnrc.yml**, **.yarn/**: Lock and configure the Yarn 4 toolchain used by the project.
 - **.nvmrc**: Pins the Node.js version expected by the project.
 - **eslint.config.mjs** and **tsconfig.json**: Provide linting and TypeScript configuration for your app's TypeScript sources.
 - **README.md**: A short README in the app root with basic instructions.
-- **public/**: A folder for storing public assets (images, fonts, static files) that will be served with your application. Files placed here are uploaded during sync and accessible at runtime.
-- **src/**: The main place where you define your application-as-code
-
-### Entity detection
-
-The SDK detects entities by parsing your TypeScript files for **`export default define<Entity>({...})`** calls. Each entity type has a corresponding helper function exported from `twenty-sdk`:
-
-| Helper function | Entity type |
-|-----------------|-------------|
-| `defineObject()` | Custom object definitions |
-| `defineLogicFunction()` | Logic function definitions |
-| `defineFrontComponent()` | Front component definitions |
-| `defineRole()` | Role definitions |
-| `defineField()` | Field extensions for existing objects |
-
-<Note>
-**File naming is flexible.** Entity detection is AST-based — the SDK scans your source files for the `export default define<Entity>({...})` pattern. You can organize your files and folders however you like. Grouping by entity type (e.g., `logic-functions/`, `roles/`) is just a convention for code organization, not a requirement.
-</Note>
-
-Example of a detected entity:
-```typescript
-// This file can be named anything and placed anywhere in src/
-import { defineObject, FieldType } from 'twenty-sdk';
-
-export default defineObject({
-  universalIdentifier: '...',
-  nameSingular: 'postCard',
-  // ... rest of config
-});
-```
+- **src/app/**: The main place where you define your application-as-code:
+  - `application.config.ts`: Global configuration for your app (metadata and runtime wiring). See "Application config" below.
+  - `*.role.ts`: Role definitions used by your serverless functions. See "Default function role" below.
+  - `*.object.ts`: Custom object definitions.
+  - `*.function.ts`: Serverless function definitions.
+- **src/utils/**: Optional folder for handler implementations and utilities.
 
 Later commands will add more files and folders:
 
-- `yarn twenty app:generate` will create a `generated/` folder (typed Twenty client + workspace types).
-- `yarn twenty entity:add` will add entity definition files under `src/` for your custom objects, functions, front components, or roles.
+- `yarn generate` will create a `generated/` folder (typed Twenty client + workspace types).
+- `yarn create-entity` will add entity definition files under `src/app/` for your custom objects, functions, or roles.
+
 
 ## Authentication
 
-The first time you run `yarn twenty auth:login`, you'll be prompted for:
+The first time you run `yarn auth`, you'll be prompted for:
 
 - API URL (defaults to http://localhost:3000 or your current workspace profile)
 - API key
 
-Your credentials are stored per-user in `~/.twenty/config.json`. You can maintain multiple profiles and switch between them.
+Your credentials are stored per-user in `~/.twenty/config.json`. You can maintain multiple profiles and switch using `--workspace <name>`.
 
-### Managing workspaces
+Examples:
 
 ```bash filename="Terminal"
 # Login interactively (recommended)
-yarn twenty auth:login
+yarn auth
 
-# Login to a specific workspace profile
-yarn twenty auth:login --workspace my-custom-workspace
-
-# List all configured workspaces
-yarn twenty auth:list
-
-# Switch the default workspace (interactive)
-yarn twenty auth:switch
-
-# Switch to a specific workspace
-yarn twenty auth:switch production
-
-# Check current authentication status
-yarn twenty auth:status
+# Use a specific workspace profile
+yarn auth --workspace my-custom-workspace
 ```
 
-Once you've switched workspaces with `yarn twenty auth:switch`, all subsequent commands will use that workspace by default. You can still override it temporarily with `--workspace <name>`.
-
 ## Use the SDK resources (types & config)
 
 The twenty-sdk provides typed building blocks and helper functions you use inside your app. Below are the key pieces you'll touch most often.
 
 ### Helper functions
 
-The SDK provides helper functions for defining your app entities. As described in [Entity detection](#entity-detection), you must use `export default define<Entity>({...})` for your entities to be detected:
+The SDK provides four helper functions with built-in validation for defining your app entities:
 
 | Function | Purpose |
 |----------|---------|
-| `defineApplication()` | Configure application metadata (required, one per app) |
+| `defineApp()` | Configure application metadata |
 | `defineObject()` | Define custom objects with fields |
-| `defineLogicFunction()` | Define logic functions with handlers |
-| `defineFrontComponent()` | Define front components for custom UI |
+| `defineFunction()` | Define serverless functions with handlers |
 | `defineRole()` | Configure role permissions and object access |
-| `defineField()` | Extend existing objects with additional fields |
 
-These functions validate your configuration at build time and provide IDE autocompletion and type safety.
+These functions validate your configuration at runtime and provide better IDE autocompletion and type safety.
 
 ### Defining objects
 
@@ -274,33 +278,80 @@ Key points:
 - The `universalIdentifier` must be unique and stable across deployments.
 - Each field requires a `name`, `type`, `label`, and its own stable `universalIdentifier`.
 - The `fields` array is optional — you can define objects without custom fields.
-- You can scaffold new objects using `yarn twenty entity:add`, which guides you through naming, fields, and relationships.
+- You can scaffold new objects using `yarn create-entity`, which guides you through naming, fields, and relationships.
 
 <Note>
-**Base fields are created automatically.** When you define a custom object, Twenty automatically adds standard fields
-  such as `id`, `name`, `createdAt`, `updatedAt`, `createdBy`, `updatedBy` and `deletedAt`.
-  You don't need to define these in your `fields` array — only add your custom fields.
-  You can override default fields by defining a field with the same name in your `fields` array,
-  but this is not recommended.
+**Base fields are created automatically.** When you define a custom object, Twenty automatically adds standard fields such as `name`, `createdAt`, `updatedAt`, `createdBy`, `position`, and `deletedAt`. You don't need to define these in your `fields` array — only add your custom fields.
 </Note>
 
+<Accordion title="Alternative: Decorator-based syntax">
+You can also define objects using TypeScript decorators. This approach uses class-based syntax with `@Object`, `@Field`, and `@Relation` decorators:
 
-### Application config (application-config.ts)
+```typescript
+import {
+  type AddressField,
+  Field,
+  FieldType,
+  type FullNameField,
+  Object,
+  OnDeleteAction,
+  Relation,
+  RelationType,
+  STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
+} from 'twenty-sdk';
+import { type Note } from '../../generated';
 
-Every app has a single `application-config.ts` file that describes:
+@Object({
+  universalIdentifier: '54b589ca-eeed-4950-a176-358418b85c05',
+  nameSingular: 'postCard',
+  namePlural: 'postCards',
+  labelSingular: 'Post card',
+  labelPlural: 'Post cards',
+  description: 'A post card object',
+  icon: 'IconMail',
+})
+export class PostCard {
+  @Field({
+    universalIdentifier: '58a0a314-d7ea-4865-9850-7fb84e72f30b',
+    type: FieldType.TEXT,
+    label: 'Content',
+    description: "Postcard's content",
+    icon: 'IconAbc',
+  })
+  content: string;
+
+  @Relation({
+    universalIdentifier: 'c9e2b4f4-b9ad-4427-9b42-9971b785edfe',
+    type: RelationType.ONE_TO_MANY,
+    label: 'Notes',
+    icon: 'IconComment',
+    inverseSideTargetUniversalIdentifier: STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.note,
+    onDelete: OnDeleteAction.CASCADE,
+  })
+  notes: Note[];
+}
+```
+
+Note: The decorator approach requires `experimentalDecorators` in your TypeScript config.
+</Accordion>
+
+
+### Application config (application.config.ts)
+
+Every app has a single `application.config.ts` file that describes:
 
 - **Who the app is**: identifiers, display name, and description.
 - **How its functions run**: which role they use for permissions.
 - **(Optional) variables**: key–value pairs exposed to your functions as environment variables.
 
-Use `defineApplication()` to define your application configuration:
+Use `defineApp()` to define your application configuration:
 
 ```typescript
-// src/application-config.ts
-import { defineApplication } from 'twenty-sdk';
-import { DEFAULT_ROLE_UNIVERSAL_IDENTIFIER } from 'src/roles/default-role';
+// src/app/application.config.ts
+import { defineApp } from 'twenty-sdk';
+import { DEFAULT_FUNCTION_ROLE_UNIVERSAL_IDENTIFIER } from './default-function.role';
 
-export default defineApplication({
+export default defineApp({
   universalIdentifier: '4ec0391d-18d5-411c-b2f3-266ddc1c3ef7',
   displayName: 'My Twenty App',
   description: 'My first Twenty app',
@@ -313,18 +364,18 @@ export default defineApplication({
       isSecret: false,
     },
   },
-  defaultRoleUniversalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+  functionRoleUniversalIdentifier: DEFAULT_FUNCTION_ROLE_UNIVERSAL_IDENTIFIER,
 });
 ```
 
 Notes:
 - `universalIdentifier` fields are deterministic IDs you own; generate them once and keep them stable across syncs.
 - `applicationVariables` become environment variables for your functions (for example, `DEFAULT_RECIPIENT_NAME` is available as `process.env.DEFAULT_RECIPIENT_NAME`).
-- `defaultRoleUniversalIdentifier` must match the role file (see below).
+- `functionRoleUniversalIdentifier` must match the role you define in your `*.role.ts` file (see below).
 
 #### Roles and permissions
 
-Applications can define roles that encapsulate permissions on your workspace's objects and actions. The field `defaultRoleUniversalIdentifier` in `application-config.ts` designates the default role used by your app's logic functions.
+Applications can define roles that encapsulate permissions on your workspace's objects and actions. The field `functionRoleUniversalIdentifier` in `application.config.ts` designates the default role used by your app's serverless functions.
 
 - The runtime API key injected as `TWENTY_API_KEY` is derived from this default function role.
 - The typed client will be restricted to the permissions granted to that role.
@@ -335,14 +386,14 @@ Applications can define roles that encapsulate permissions on your workspace's o
 When you scaffold a new app, the CLI also creates a default role file. Use `defineRole()` to define roles with built-in validation:
 
 ```typescript
-// src/roles/default-role.ts
+// src/app/default-function.role.ts
 import { defineRole, PermissionFlag } from 'twenty-sdk';
 
-export const DEFAULT_ROLE_UNIVERSAL_IDENTIFIER =
+export const DEFAULT_FUNCTION_ROLE_UNIVERSAL_IDENTIFIER =
   'b648f87b-1d26-4961-b974-0908fd991061';
 
 export default defineRole({
-  universalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+  universalIdentifier: DEFAULT_FUNCTION_ROLE_UNIVERSAL_IDENTIFIER,
   label: 'Default function role',
   description: 'Default role for function Twenty client',
   canReadAllObjectRecords: false,
@@ -355,7 +406,7 @@ export default defineRole({
   canBeAssignedToApiKeys: false,
   objectPermissions: [
     {
-      objectUniversalIdentifier: '9f9882af-170c-4879-b013-f9628b77c050',
+      objectNameSingular: 'postCard',
       canReadObjectRecords: true,
       canUpdateObjectRecords: true,
       canSoftDeleteObjectRecords: false,
@@ -364,8 +415,8 @@ export default defineRole({
   ],
   fieldPermissions: [
     {
-      objectUniversalIdentifier: '9f9882af-170c-4879-b013-f9628b77c050',
-      fieldUniversalIdentifier: 'b2c37dc0-8ae7-470e-96cd-1476b47dfaff',
+      objectNameSingular: 'postCard',
+      fieldName: 'content',
       canReadFieldValue: false,
       canUpdateFieldValue: false,
     },
@@ -374,10 +425,10 @@ export default defineRole({
 });
 ```
 
-The `universalIdentifier` of this role is then referenced in `application-config.ts` as `defaultRoleUniversalIdentifier`. In other words:
+The `universalIdentifier` of this role is then referenced in `application.config.ts` as `functionRoleUniversalIdentifier`. In other words:
 
 - **\*.role.ts** defines what the default function role can do.
-- **application-config.ts** points to that role so your functions inherit its permissions.
+- **application.config.ts** points to that role so your functions inherit its permissions.
 
 Notes:
 - Start from the scaffolded role, then progressively restrict it following least‑privilege.
@@ -385,20 +436,25 @@ Notes:
 - `permissionFlags` control access to platform-level capabilities. Keep them minimal; add only what you need.
 - See a working example in the Hello World app: [`packages/twenty-apps/hello-world/src/roles/function-role.ts`](https://github.com/twentyhq/twenty/blob/main/packages/twenty-apps/hello-world/src/roles/function-role.ts).
 
-### Logic function config and entrypoint
+### Serverless function config and entrypoint
 
-Each function file uses `defineLogicFunction()` to export a configuration with a handler and optional triggers.
+Each function file uses `defineFunction()` to export a configuration with a handler and optional triggers. Use the `*.function.ts` file suffix for automatic detection.
 
 ```typescript
-// src/app/createPostCard.logic-function.ts
-import { defineLogicFunction } from 'twenty-sdk';
-import type { DatabaseEventPayload, ObjectRecordCreateEvent, CronPayload, RoutePayload } from 'twenty-sdk';
-import Twenty, { type Person } from '~/generated';
+// src/app/createPostCard.function.ts
+import { defineFunction } from 'twenty-sdk';
+import type { DatabaseEventPayload, ObjectRecordCreateEvent, CronPayload } from 'twenty-sdk';
+import Twenty, { type Person } from '../../generated';
 
-const handler = async (params: RoutePayload) => {
+const handler = async (
+  params:
+    | { name?: string }
+    | DatabaseEventPayload<ObjectRecordCreateEvent<Person>>
+    | CronPayload,
+) => {
   const client = new Twenty(); // generated typed client
-  const name = 'name' in params.queryStringParameters
-    ? params.queryStringParameters.name ?? process.env.DEFAULT_RECIPIENT_NAME ?? 'Hello world'
+  const name = 'name' in params
+    ? params.name ?? process.env.DEFAULT_RECIPIENT_NAME ?? 'Hello world'
     : 'Hello world';
 
   const result = await client.mutation({
@@ -411,7 +467,7 @@ const handler = async (params: RoutePayload) => {
   return result;
 };
 
-export default defineLogicFunction({
+export default defineFunction({
   universalIdentifier: 'e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf',
   name: 'create-new-post-card',
   timeoutSeconds: 2,
@@ -426,18 +482,17 @@ export default defineLogicFunction({
       isAuthRequired: false,
     },
     // Cron trigger (CRON pattern)
-    // {
-    //   universalIdentifier: 'dd802808-0695-49e1-98c9-d5c9e2704ce2',
-    //   type: 'cron',
-    //   pattern: '0 0 1 1 *',
-    // },
+    {
+      universalIdentifier: 'dd802808-0695-49e1-98c9-d5c9e2704ce2',
+      type: 'cron',
+      pattern: '0 0 1 1 *',
+    },
     // Database event trigger
-    // {
-    //   universalIdentifier: '203f1df3-4a82-4d06-a001-b8cf22a31156',
-    //   type: 'databaseEvent',
-    //   eventName: 'person.updated',
-    //   updatedFields: ['name'],
-    // },
+    {
+      universalIdentifier: '203f1df3-4a82-4d06-a001-b8cf22a31156',
+      type: 'databaseEvent',
+      eventName: 'person.created',
+    },
   ],
 });
 ```
@@ -446,223 +501,32 @@ Common trigger types:
 - **route**: Exposes your function on an HTTP path and method **under the `/s/` endpoint**:
 > e.g. `path: '/post-card/create',` -> call on `<APP_URL>/s/post-card/create`
 - **cron**: Runs your function on a schedule using a CRON expression.
-- **databaseEvent**: Runs on workspace object lifecycle events. When the event operation is `updated`, specific fields to listen to can be specified in the `updatedFields` array. If left undefined or empty, any update will trigger the function.
-> e.g. `person.updated`
+- **databaseEvent**: Runs on workspace object lifecycle events
+> e.g. `person.created`
 
 Notes:
 - The `triggers` array is optional. Functions without triggers can be used as utility functions called by other functions.
 - You can mix multiple trigger types in a single function.
 
-### Route trigger payload
-
-<Warning>
-**Breaking change (v1.16, January 2026):** The route trigger payload format has changed. Prior to v1.16, query parameters, path parameters, and body were sent directly as the payload. Starting with v1.16, they are nested inside a structured `RoutePayload` object.
-
-**Before v1.16:**
-```typescript
-const handler = async (params) => {
-  const { param1, param2 } = params; // Direct access
-};
-```
-
-**After v1.16:**
-```typescript
-const handler = async (event: RoutePayload) => {
-  const { param1, param2 } = event.body; // Access via .body
-  const { queryParam } = event.queryStringParameters;
-  const { id } = event.pathParameters;
-};
-```
-
-**To migrate existing functions:** Update your handler to destructure from `event.body`, `event.queryStringParameters`, or `event.pathParameters` instead of directly from the params object.
-</Warning>
-
-When a route trigger invokes your logic function, it receives a `RoutePayload` object that follows the AWS HTTP API v2 format. Import the type from `twenty-sdk`:
-
-```typescript
-import { defineLogicFunction, type RoutePayload } from 'twenty-sdk';
-
-const handler = async (event: RoutePayload) => {
-  // Access request data
-  const { headers, queryStringParameters, pathParameters, body } = event;
-
-  // HTTP method and path are available in requestContext
-  const { method, path } = event.requestContext.http;
-
-  return { message: 'Success' };
-};
-```
-
-The `RoutePayload` type has the following structure:
-
-| Property | Type | Description |
-|----------|------|-------------|
-| `headers` | `Record<string, string \| undefined>` | HTTP headers (only those listed in `forwardedRequestHeaders`) |
-| `queryStringParameters` | `Record<string, string \| undefined>` | Query string parameters (multiple values joined with commas) |
-| `pathParameters` | `Record<string, string \| undefined>` | Path parameters extracted from the route pattern (e.g., `/users/:id` → `{ id: '123' }`) |
-| `body` | `object \| null` | Parsed request body (JSON) |
-| `isBase64Encoded` | `boolean` | Whether the body is base64 encoded |
-| `requestContext.http.method` | `string` | HTTP method (GET, POST, PUT, PATCH, DELETE) |
-| `requestContext.http.path` | `string` | Raw request path |
-
-### Forwarding HTTP headers
-
-By default, HTTP headers from incoming requests are **not** passed to your logic function for security reasons. To access specific headers, explicitly list them in the `forwardedRequestHeaders` array:
-
-```typescript
-export default defineLogicFunction({
-  universalIdentifier: 'e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf',
-  name: 'webhook-handler',
-  handler,
-  triggers: [
-    {
-      universalIdentifier: 'c9f84c8d-b26d-40d1-95dd-4f834ae5a2c6',
-      type: 'route',
-      path: '/webhook',
-      httpMethod: 'POST',
-      isAuthRequired: false,
-      forwardedRequestHeaders: ['x-webhook-signature', 'content-type'],
-    },
-  ],
-});
-```
-
-In your handler, you can then access these headers:
-
-```typescript
-const handler = async (event: RoutePayload) => {
-  const signature = event.headers['x-webhook-signature'];
-  const contentType = event.headers['content-type'];
-
-  // Validate webhook signature...
-  return { received: true };
-};
-```
-
-<Note>
-  Header names are normalized to lowercase. Access them using lowercase keys (for example, `event.headers['content-type']`).
-</Note>
-
 You can create new functions in two ways:
 
-- **Scaffolded**: Run `yarn twenty entity:add` and choose the option to add a new logic function. This generates a starter file with a handler and config.
-- **Manual**: Create a new `*.logic-function.ts` file and use `defineLogicFunction()`, following the same pattern.
-
-### Marking a logic function as a tool
-
-Logic functions can be exposed as **tools** for AI agents and workflows. When a function is marked as a tool, it becomes discoverable by Twenty's AI features and can be selected as a step in workflow automations.
-
-To mark a logic function as a tool, set `isTool: true` and provide a `toolInputSchema` describing the expected input parameters using [JSON Schema](https://json-schema.org/):
-
-```typescript
-// src/logic-functions/enrich-company.logic-function.ts
-import { defineLogicFunction } from 'twenty-sdk';
-import Twenty from '~/generated';
-
-const handler = async (params: { companyName: string; domain?: string }) => {
-  const client = new Twenty();
-
-  const result = await client.mutation({
-    createTask: {
-      __args: {
-        data: {
-          title: `Enrich data for ${params.companyName}`,
-          body: `Domain: ${params.domain ?? 'unknown'}`,
-        },
-      },
-      id: true,
-    },
-  });
-
-  return { taskId: result.createTask.id };
-};
-
-export default defineLogicFunction({
-  universalIdentifier: 'f47ac10b-58cc-4372-a567-0e02b2c3d479',
-  name: 'enrich-company',
-  description: 'Enrich a company record with external data',
-  timeoutSeconds: 10,
-  handler,
-  isTool: true,
-  toolInputSchema: {
-    type: 'object',
-    properties: {
-      companyName: {
-        type: 'string',
-        description: 'The name of the company to enrich',
-      },
-      domain: {
-        type: 'string',
-        description: 'The company website domain (optional)',
-      },
-    },
-    required: ['companyName'],
-  },
-});
-```
-
-Key points:
-
-- **`isTool`** (`boolean`, default: `false`): When set to `true`, the function is registered as a tool and becomes available to AI agents and workflow automations.
-- **`toolInputSchema`** (`object`, optional): A JSON Schema object that describes the parameters your function accepts. AI agents use this schema to understand what inputs the tool expects and to validate calls. If omitted, the schema defaults to `{ type: 'object', properties: {} }` (no parameters).
-- Functions with `isTool: false` (or unset) are **not** exposed as tools. They can still be executed directly or called by other functions, but will not appear in tool discovery.
-- **Tool naming**: When exposed as a tool, the function name is automatically normalized to `logic_function_<name>` (lowercased, non-alphanumeric characters replaced with underscores). For example, `enrich-company` becomes `logic_function_enrich_company`.
-- You can combine `isTool` with triggers — a function can be both a tool (callable by AI agents) and triggered by events (cron, database events, routes) at the same time.
-
-<Note>
-**Write a good `description`.** AI agents rely on the function's `description` field to decide when to use the tool. Be specific about what the tool does and when it should be called.
-</Note>
-
-### Front components
-
-Front components let you build custom React components that render within Twenty's UI. Use `defineFrontComponent()` to define components with built-in validation:
-
-```typescript
-// src/my-widget.front-component.tsx
-import { defineFrontComponent } from 'twenty-sdk';
-
-const MyWidget = () => {
-  return (
-    <div style={{ padding: '20px', fontFamily: 'sans-serif' }}>
-      <h1>My Custom Widget</h1>
-      <p>This is a custom front component for Twenty.</p>
-    </div>
-  );
-};
-
-export default defineFrontComponent({
-  universalIdentifier: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
-  name: 'my-widget',
-  description: 'A custom widget component',
-  component: MyWidget,
-});
-```
-
-Key points:
-- Front components are React components that render in isolated contexts within Twenty.
-- Use the `*.front-component.tsx` file suffix for automatic detection.
-- The `component` field references your React component.
-- Components are built and synced automatically during `yarn twenty app:dev`.
-
-You can create new front components in two ways:
-
-- **Scaffolded**: Run `yarn twenty entity:add` and choose the option to add a new front component.
-- **Manual**: Create a new `*.front-component.tsx` file and use `defineFrontComponent()`.
+- **Scaffolded**: Run `yarn create-entity` and choose the option to add a new function. This generates a starter file with a handler and config.
+- **Manual**: Create a new `*.function.ts` file and use `defineFunction()`, following the same pattern.
 
 ### Generated typed client
 
-Run `yarn twenty app:generate` to create a local typed client in `generated/` based on your workspace schema. Use it in your functions:
+Run yarn generate to create a local typed client in generated/ based on your workspace schema. Use it in your functions:
 
 ```typescript
-import Twenty from '~/generated';
+import Twenty from './generated';
 
 const client = new Twenty();
 const { me } = await client.query({ me: { id: true, displayName: true } });
 ```
 
-The client is re-generated by `yarn twenty app:generate`. Re-run after changing your objects or when onboarding to a new workspace.
+The client is re-generated by `yarn generate`. Re-run after changing your objects and `yarn sync` or when onboarding to a new workspace.
 
-#### Runtime credentials in logic functions
+#### Runtime credentials in serverless functions
 
 When your function runs on Twenty, the platform injects credentials as environment variables before your code executes:
 
@@ -671,39 +535,46 @@ When your function runs on Twenty, the platform injects credentials as environme
 
 Notes:
 - You do not need to pass URL or API key to the generated client. It reads `TWENTY_API_URL` and `TWENTY_API_KEY` from process.env at runtime.
-- The API key's permissions are determined by the role referenced in your `application-config.ts` via `defaultRoleUniversalIdentifier`. This is the default role used by logic functions of your application.
-- Applications can define roles to follow least‑privilege. Grant only the permissions your functions need, then point `defaultRoleUniversalIdentifier` to that role's universal identifier.
+- The API key's permissions are determined by the role referenced in your `application.config.ts` via `functionRoleUniversalIdentifier`. This is the default role used by serverless functions of your application.
+- Applications can define roles to follow least‑privilege. Grant only the permissions your functions need, then point `functionRoleUniversalIdentifier` to that role's universal identifier.
 
 
 ### Hello World example
 
-Explore a minimal, end-to-end example that demonstrates objects, logic functions, front components, and multiple triggers [here](https://github.com/twentyhq/twenty/tree/main/packages/twenty-apps/hello-world):
+Explore a minimal, end-to-end example that demonstrates objects, functions, and multiple triggers [here](https://github.com/twentyhq/twenty/tree/main/packages/twenty-apps/hello-world):
 
 ## Manual setup (without the scaffolder)
 
-While we recommend using `create-twenty-app` for the best getting-started experience, you can also set up a project manually. Do not install the CLI globally. Instead, add `twenty-sdk` as a local dependency and wire a single script in your package.json:
+While we recommend using `create-twenty-app` for the best getting-started experience, you can also set up a project manually. Do not install the CLI globally. Instead, add `twenty-sdk` as a local dependency and wire scripts in your package.json:
 
 ```bash filename="Terminal"
 yarn add -D twenty-sdk
 ```
 
-Then add a `twenty` script:
+Then add scripts like these:
 
 ```json filename="package.json"
 {
   "scripts": {
-    "twenty": "twenty"
+    "auth": "twenty auth login",
+    "generate": "twenty app generate",
+    "dev": "twenty app dev",
+    "sync": "twenty app sync",
+    "uninstall": "twenty app uninstall",
+    "logs": "twenty app logs",
+    "create-entity": "twenty app add",
+    "help": "twenty --help"
   }
 }
 ```
 
-Now you can run all commands via `yarn twenty <command>`, e.g. `yarn twenty app:dev`, `yarn twenty app:generate`, `yarn twenty help`, etc.
+Now you can run the same commands via Yarn, e.g. `yarn dev`, `yarn sync`, etc.
 
 ## Troubleshooting
 
-- Authentication errors: run `yarn twenty auth:login` and ensure your API key has the required permissions.
+- Authentication errors: run `yarn auth` and ensure your API key has the required permissions.
 - Cannot connect to server: verify the API URL and that the Twenty server is reachable.
-- Types or client missing/outdated: run `yarn twenty app:generate`.
-- Dev mode not syncing: ensure `yarn twenty app:dev` is running and that changes are not ignored by your environment.
+- Types or client missing/outdated: run `yarn generate` and then `yarn dev`.
+- Dev mode not syncing: ensure `yarn dev` is running and that changes are not ignored by your environment.
 
 Discord Help Channel: https://discord.com/channels/1130383047699738754/1130386664812982322

packages/twenty-docs/developers/self-host/capabilities/setup.mdx

@@ -288,44 +288,3 @@ yarn command:prod cron:workflow:automated-cron-trigger
 <Warning>
 **Environment-only mode:** If you set `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, add these variables to your `.env` file instead.
 </Warning>
-
-## Logic Functions
-
-Twenty supports logic functions for workflows and custom logic. The execution environment is configured via the `SERVERLESS_TYPE` environment variable.
-
-<Warning>
-**Security Notice:** The local driver (`SERVERLESS_TYPE=LOCAL`) runs code directly on the host in a Node.js process with no sandboxing. It should only be used for trusted code in development. For production deployments handling untrusted code, we highly recommend using `SERVERLESS_TYPE=LAMBDA` or `SERVERLESS_TYPE=DISABLED`.
-</Warning>
-
-### Available Drivers
-
-| Driver | Environment Variable | Use Case | Security Level |
-|--------|---------------------|----------|----------------|
-| Disabled | `SERVERLESS_TYPE=DISABLED` | Disable logic functions entirely | N/A |
-| Local | `SERVERLESS_TYPE=LOCAL` | Development and trusted environments | Low (no sandboxing) |
-| Lambda | `SERVERLESS_TYPE=LAMBDA` | Production with untrusted code | High (hardware-level isolation) |
-
-### Recommended Configuration
-
-**For development:**
-```bash
-SERVERLESS_TYPE=LOCAL  # default
-```
-
-**For production (AWS):**
-```bash
-SERVERLESS_TYPE=LAMBDA
-SERVERLESS_LAMBDA_REGION=us-east-1
-SERVERLESS_LAMBDA_ROLE=arn:aws:iam::123456789:role/your-lambda-role
-SERVERLESS_LAMBDA_ACCESS_KEY_ID=your-access-key
-SERVERLESS_LAMBDA_SECRET_ACCESS_KEY=your-secret-key
-```
-
-**To disable logic functions:**
-```bash
-SERVERLESS_TYPE=DISABLED
-```
-
-<Note>
-When using `SERVERLESS_TYPE=DISABLED`, any attempt to execute a logic function will return an error. This is useful if you want to run Twenty without logic function capabilities.
-</Note>