Chore/nx agents ci

.cz-config.js

@@ -20,7 +20,6 @@ module.exports = {
             description: 'AutoMapper classes strategy',
         },
         { name: 'pojos', description: 'AutoMapper pojos strategy' },
-        { name: 'zod', description: 'AutoMapper zod strategy' },
         {
             name: 'nestjs',
             description: 'AutoMapper nestjs integration))',

.eslintrc.json

@@ -1,12 +1,12 @@
 {
     "root": true,
     "ignorePatterns": ["**/*"],
-    "plugins": ["@nrwl/nx"],
+    "plugins": ["@nx"],
     "overrides": [
         {
             "files": ["*.ts", "*.tsx", "*.js", "*.jsx"],
             "rules": {
-                "@nrwl/nx/enforce-module-boundaries": [
+                "@nx/enforce-module-boundaries": [
                     "error",
                     {
                         "enforceBuildableLibDependency": true,
@@ -23,13 +23,19 @@
         },
         {
             "files": ["*.ts", "*.tsx"],
-            "extends": ["plugin:@nrwl/nx/typescript"],
+            "extends": ["plugin:@nx/typescript"],
             "rules": {}
         },
         {
             "files": ["*.js", "*.jsx"],
-            "extends": ["plugin:@nrwl/nx/javascript"],
+            "extends": ["plugin:@nx/javascript"],
             "rules": {}
+        },
+        {
+            "files": ["**/vitest.config.ts", "vitest.shared.ts"],
+            "rules": {
+                "@nx/enforce-module-boundaries": "off"
+            }
         }
     ]
 }

.github/workflows/ci.yml

@@ -2,20 +2,81 @@ name: CI
 
 on:
     push:
-        branches:
-            - main
+        branches: [main]
     pull_request:
 
+env:
+    NX_VERBOSE_LOGGING: 'true'
+    NX_CLOUD_CONTINUOUS_ASSIGNMENT: 'true'
+
+concurrency:
+    group: ${{ github.workflow }}-${{ github.ref }}
+    cancel-in-progress: true
+
 jobs:
-    main:
-        name: Nx Cloud - Main Job
-        uses: nrwl/ci/.github/workflows/nx-cloud-main.yml@v0.8
-        with:
-            parallel-commands-on-agents: |
-                pnpm exec nx affected --target=test --parallel=3 --ci --code-coverage
-    #                pnpm exec nx affected --target=package --parallel=2
-    agents:
-        name: Nx Cloud - Agents
-        uses: nrwl/ci/.github/workflows/nx-cloud-agents.yml@v0.8
-        with:
-            number-of-agents: 3
+    verify:
+        name: sync · lint · typecheck · build · test (node ${{ matrix.node }})
+        runs-on: ubuntu-latest
+        strategy:
+            fail-fast: false
+            matrix:
+                node: ['20', '22']
+        env:
+            NX_CI_EXECUTION_ENV: 'node ${{ matrix.node }}'
+        steps:
+            - uses: actions/checkout@v4
+              with:
+                  fetch-depth: 0
+                  filter: tree:0
+            - uses: actions/setup-node@v4
+              with:
+                  node-version: ${{ matrix.node }}
+            - run: corepack enable
+            - run: pnpm install --frozen-lockfile
+            - name: Start Nx Agents
+              run: >-
+                  pnpm nx start-ci-run
+                  --distribute-on="3 linux-medium-node${{ matrix.node }}"
+                  --stop-agents-after=lint,typecheck,package,test
+            # fail fast if tsconfig project references drift from the graph
+            - run: pnpm nx record -- nx sync:check
+            - run: pnpm nx run-many -t lint,typecheck,package,test
+
+    package-contract:
+        name: publint + attw
+        runs-on: ubuntu-latest
+        env:
+            NX_CI_EXECUTION_ENV: 'publint + attw'
+        steps:
+            - uses: actions/checkout@v4
+            - uses: actions/setup-node@v4
+              with:
+                  node-version: '22'
+            - run: corepack enable
+            - run: pnpm install --frozen-lockfile
+            - run: pnpm run package
+            - run: pnpm nx record -- pnpm run check:packages
+
+    # The main verify job runs against nestjs 11 (the installed version). This job
+    # certifies the lower bound of @automapper/nestjs's `^10 || ^11` peer range by
+    # downgrading the @nestjs runtime to v10 and running the DI integration specs.
+    nestjs-compat:
+        name: nestjs 10 compat
+        runs-on: ubuntu-latest
+        env:
+            NX_CI_EXECUTION_ENV: 'nestjs-compat'
+        steps:
+            - uses: actions/checkout@v4
+            - uses: actions/setup-node@v4
+              with:
+                  node-version: '22'
+            - run: corepack enable
+            - run: pnpm install --frozen-lockfile
+            # downgrade only the @nestjs runtime; rxjs/reflect-metadata span both majors
+            - run: pnpm --config.prefer-workspace-packages=true add -w @nestjs/common@^10 @nestjs/core@^10 @nestjs/testing@^10 @nestjs/platform-express@^10
+            - name: Start Nx Agents
+              run: >-
+                  pnpm nx start-ci-run
+                  --distribute-on="3 linux-medium-node22"
+                  --stop-agents-after=test
+            - run: pnpm nx run integration-test:test

.github/workflows/docusaurus.yml

@@ -17,25 +17,22 @@
     build-docs:
         runs-on: ubuntu-latest
         steps:
-            - uses: actions/checkout@v2
+            - uses: actions/checkout@v4
               with:
                   persist-credentials: false
                   fetch-depth: 0 # otherwise, you will failed to push refs to dest repo
 
-            - uses: pnpm/action-setup@v2.1.0
+            - uses: actions/setup-node@v4
               with:
-                  version: latest
-                  run_install: false
+                  node-version: '20'
 
-            - uses: actions/setup-node@v2
-              with:
-                  node-version: '16'
-                  cache: 'pnpm'
+            - run: corepack enable
 
+            # docs are not a workspace member (the workspace is scoped to the
+            # publishable libs), so install them standalone.
             - name: Install dependencies
-              run: |
-                  pnpm install
-                  pnpm --filter "./packages/documentations" install
+              working-directory: packages/documentations
+              run: pnpm install --ignore-workspace
 
             - name: Create local build artifacts
               run: |
@@ -52,7 +49,7 @@
                   git commit -m "docs: build docs" -a
 
             - name: Push changes
               uses: ad-m/github-push-action@master
               with:
                   github_token: ${{ secrets.GITHUB_TOKEN }}
                   branch: docs

.github/workflows/release.yml

@@ -0,0 +1,59 @@
+name: Release
+
+on:
+    workflow_dispatch:
+        inputs:
+            first-release:
+                description: 'First release using the {projectName}@{version} tag scheme (no prior tags to diff against)'
+                type: boolean
+                default: false
+            dry-run:
+                description: 'Compute versions/changelogs without writing, tagging, or publishing'
+                type: boolean
+                default: false
+
+concurrency:
+    group: release
+    cancel-in-progress: false
+
+permissions:
+    contents: write # push version-bump commit + tags, create GitHub releases
+    id-token: write # npm provenance / OIDC trusted publishing
+
+jobs:
+    release:
+        name: nx release (alpha)
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v4
+              with:
+                  fetch-depth: 0 # full history is required for conventional-commit version analysis
+            - uses: actions/setup-node@v4
+              with:
+                  node-version: '22'
+                  registry-url: 'https://registry.npmjs.org'
+            - run: corepack enable
+            - run: pnpm install --frozen-lockfile
+
+            # 1. bump versions, write changelogs, tag, create GitHub releases — but do not publish yet
+            - name: Version + changelog + tag
+              run: >-
+                  pnpm exec nx release
+                  ${{ inputs.first-release && '--first-release' || '' }}
+                  ${{ inputs.dry-run && '--dry-run' || '' }}
+                  --skip-publish --yes
+              env:
+                  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+            # 2. build the dist artifacts with the freshly-bumped versions
+            - name: Build packages
+              if: ${{ !inputs.dry-run }}
+              run: pnpm run package
+
+            # 3. publish the built dist to npm under the alpha dist-tag with provenance
+            - name: Publish (alpha, provenance)
+              if: ${{ !inputs.dry-run }}
+              run: pnpm exec nx release publish --tag=alpha
+              env:
+                  NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+                  NPM_CONFIG_PROVENANCE: true

.gitignore

@@ -6,7 +6,9 @@
 /out-tsc
 
 # dependencies
-/node_modules
+node_modules
+# per-package dist (per-package builds / workspace)
+packages/*/dist
 
 # IDEs and editors
 /.idea
@@ -40,3 +42,13 @@ Thumbs.db
 
 old
 .env
+
+.nx/cache
+.nx/workspace-data
+.claude/worktrees
+.nx/polygraph
+.nx/self-healing
+
+# local agent planning and visual brainstorming artifacts
+.superpowers/
+docs/superpowers/

.npmrc

@@ -0,0 +1 @@
+public-hoist-pattern[]=@nestjs/platform-express

.nvmrc

@@ -0,0 +1 @@
+22

.nx/workflows/agents.yaml

@@ -0,0 +1,30 @@
+launch-templates:
+    linux-medium-node20:
+        resource-class: 'docker_linux_amd64/medium'
+        image: 'ubuntu22.04-node24.14-v1'
+        init-steps:
+            - name: Checkout
+              uses: 'nrwl/nx-cloud-workflows/v6/workflow-steps/checkout/main.yaml'
+
+            - name: Install Node 20
+              uses: 'nrwl/nx-cloud-workflows/v6/workflow-steps/install-node/main.yaml'
+              inputs:
+                  node_version: '20'
+
+            - name: Install Node Nodules
+              uses: 'nrwl/nx-cloud-workflows/v4/workflow-steps/install-node-modules/main.yaml'
+
+    linux-medium-node22:
+        resource-class: 'docker_linux_amd64/medium'
+        image: 'ubuntu22.04-node24.14-v1'
+        init-steps:
+            - name: Checkout
+              uses: 'nrwl/nx-cloud-workflows/v6/workflow-steps/checkout/main.yaml'
+
+            - name: Install Node 22
+              uses: 'nrwl/nx-cloud-workflows/v6/workflow-steps/install-node/main.yaml'
+              inputs:
+                  node_version: '22'
+
+            - name: Install Node Nodules
+              uses: 'nrwl/nx-cloud-workflows/v4/workflow-steps/install-node-modules/main.yaml'

.prettierignore

@@ -2,3 +2,7 @@
 
 /dist
 /coverage
+
+/.nx/cache
+/.nx/workspace-data
+.nx/self-healing