Add repository guidelines, update github actions to include lint-core and lint-dashboard, update node version requirement on all packages to 22+ and added .nvmrc for nvm to read node version

.github/workflows/build-and-push.yml

@@ -3,8 +3,8 @@ name: Build and Push Docker Images
 on:
   push:
     branches:
-      - main
       - master
+      - development
     paths:
       - 'dashboard/**'
       - 'src/**'
@@ -13,8 +13,8 @@ on:
       - 'v*.*.*'
   pull_request:
     branches:
-      - main
       - master
+      - development
     paths:
       - 'dashboard/**'
       - 'src/**'
@@ -32,21 +32,78 @@ env:
   DASHBOARD_IMAGE_NAME: ${{ github.repository_owner }}/simplens-dashboard
 
 jobs:
+  # ============================================
+  # Lint: simplens-core
+  # ============================================
+  lint-core:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22.x'
+          cache: 'npm'
+
+      - name: Verify Node.js version
+        run: node --version
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run core lint
+        run: npm run lint:core
+
+  # ============================================
+  # Lint: simplens-dashboard
+  # ============================================
+  lint-dashboard:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22.x'
+          cache: 'npm'
+
+      - name: Verify Node.js version
+        run: node --version
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Install dashboard dependencies
+        run: npm ci --prefix dashboard
+
+      - name: Run dashboard lint
+        run: npm run lint:dashboard
+
   # ============================================
   # Test: simplens-core
   # ============================================
   test-core:
     runs-on: ubuntu-latest
+    needs:
+      - lint-core
+      - lint-dashboard
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
 
       - name: Set up Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '22'
+          node-version: '22.x'
           cache: 'npm'
 
+      - name: Verify Node.js version
+        run: node --version
+
       - name: Install dependencies
         run: npm ci
 
@@ -108,6 +165,7 @@ jobs:
   # ============================================
   build-dashboard:
     runs-on: ubuntu-latest
+    needs: test-core
     permissions:
       contents: read
       packages: write

.nvmrc

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

AGENTS.md

@@ -0,0 +1,35 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+`src/` contains the TypeScript core service. HTTP routes live in `src/api/`, background execution in `src/workers/` and `src/processors/`, channel integrations in `src/plugins/`, and shared infrastructure in `src/config/`, `src/database/`, and `src/utils/`.
+
+Tests are split between `tests/unit` and `tests/integration`, with helpers in `tests/testutil` and setup in `tests/setup.ts`. The Next.js admin UI lives in `dashboard/`. Docs and assets are in `api-docs/`, `architecture/`, and `assets/`.
+
+## Build, Test, and Development Commands
+Install dependencies with `npm install` and `npm install --prefix dashboard`.
+
+- `npm run dev` starts the core API with `tsx` and `nodemon`.
+- `npm run worker:dev`, `npm run processor:dev`, `npm run delayed-processor:dev`, and `npm run recovery:dev` start background services.
+- `npm run build` compiles `src/` to `dist/` and rewrites path aliases.
+- `npm run start` runs the compiled API from `dist/api/server.js`.
+- `npm run test`, `npm run test:unit`, `npm run test:integration`, and `npm run test:coverage` run tests.
+- `npm run lint:core` checks the core codebase; `npm run lint:dashboard` checks the dashboard.
+- `npm run dev --prefix dashboard` starts the dashboard on port `3002`.
+
+## Coding Style & Naming Conventions
+Use TypeScript with strict typing and existing `@src/*` path aliases. Match current style: 2-space indentation, camelCase for variables and functions, PascalCase for types, classes, and React components, and filenames such as `notification.controller.test.ts`.
+
+Plan changes before writing code. Follow low-level design principles: single responsibility, clear interfaces, useful dependency inversion, and explicit error handling. Do not duplicate logic; extract shared behavior into focused utilities, services, or test helpers.
+
+## Testing Guidelines
+Vitest is the test runner. Integration tests also use `supertest`, `mongodb-memory-server`, and Redis mocks. Name test files with `.test.ts`, for example `tests/unit/plugins/loader.test.ts`.
+
+Every new feature or code path must include matching tests in `tests/`. Add unit suites for isolated logic and integration suites for API, persistence, plugin, processor, or worker behavior.
+
+## Commit & Pull Request Guidelines
+Use short Conventional Commit style messages such as `feat: add email retry policy`, `fix: handle missing template`, or `docs: update setup notes`. Keep commits focused.
+
+PRs should include a summary, linked issue when applicable, test evidence, and screenshots or GIFs for `dashboard/` UI changes. Husky `pre-push` runs both lint commands.
+
+## Security & Configuration Tips
+Do not commit secrets. Use `.env.example` as the template for `.env`, and update it when adding configuration. For local full-stack work, prefer `docker-compose.dev.yaml`; for core-only work, start infrastructure with `docker compose -f docker-compose.infra.yaml up -d`.

CONTRIBUTING.md

@@ -138,7 +138,7 @@ Notes:
 ## Contribution Workflow
 
 1. Look into the open issues on [simplens-core issues](https://github.com/SimpleNotificationSystem/simplens-core/issues) and choose an issue you like to solve.
-2. Create a new branch (`<type_of_issue>-<name>`) from the `master` branch.
+2. Create a new branch (`<type_of_issue>-<name>`) from the `development` branch.
 3. Solve or complete the feature/bug mentioned in the issue.
 4. Add or update tests for behavior changes.
 5. Run lint + tests locally.

dashboard/package.json

@@ -2,6 +2,9 @@
   "name": "dashboard",
   "version": "1.2.1",
   "private": true,
+  "engines": {
+    "node": ">=22.0.0"
+  },
   "scripts": {
     "dev": "next dev -p 3002",
     "build": "NODE_ENV=production next build",

package.json

@@ -5,6 +5,9 @@
   "description": "Open-source plugin-based notification orchestration engine for developers who value control ",
   "main": "dist/api/server.js",
   "type": "module",
+  "engines": {
+    "node": ">=22.0.0"
+  },
   "scripts": {
     "test": "vitest run",
     "test:watch": "vitest",

packages/config-gen/package.json

@@ -3,6 +3,9 @@
     "version": "1.0.2",
     "description": "CLI tool to generate simplens.config.yaml from plugin manifests",
     "type": "module",
+    "engines": {
+        "node": ">=22.0.0"
+    },
     "bin": {
         "simplens-config": "./dist/index.js"
     },

packages/create-simplens-plugin/package.json

@@ -28,6 +28,9 @@
   ],
   "author": "",
   "license": "MIT",
+  "engines": {
+    "node": ">=22.0.0"
+  },
   "dependencies": {
     "@clack/prompts": "^1.0.0",
     "chalk": "^5.3.0",
@@ -44,9 +47,6 @@
     "typescript": "^5.0.0",
     "vitest": "^2.0.0"
   },
-  "engines": {
-    "node": ">=18.0.0"
-  },
   "files": [
     "dist",
     "README.md"

packages/mcp-server/package.json

@@ -4,6 +4,9 @@
   "description": "Remote MCP server for SimpleNS notification orchestration engine",
   "type": "module",
   "main": "dist/index.js",
+  "engines": {
+    "node": ">=22.0.0"
+  },
   "bin": {
     "simplens-mcp": "dist/index.js"
   },

packages/onboard/package.json

@@ -3,6 +3,9 @@
   "version": "1.0.11",
   "type": "module",
   "main": "dist/index.js",
+  "engines": {
+    "node": ">=22.0.0"
+  },
   "bin": {
     "simplens-onboard": "./dist/index.js"
   },

packages/sdk/package.json

@@ -5,6 +5,9 @@
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
     "type": "module",
+    "engines": {
+        "node": ">=22.0.0"
+    },
     "exports": {
         ".": {
             "types": "./dist/index.d.ts",

tsconfig.json

@@ -14,7 +14,7 @@
     "esModuleInterop": true,
     "skipLibCheck": true,
     "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true
+    "resolveJsonModule": true,
   },
   "include": ["src/**/*"],
   "exclude": ["node_modules", "dist"]