feat: release v5-beta with major engine redesign and migration behavior updates

New major version:
- Released major version after runtime model, CSV behavior, and file pipeline redesign.
- Breaking change: standalone Node.js/module execution removed; use `sf sfdmu run`.
- Breaking change: `--verbose`, `--concise`, and `--usesf` runtime effect removed.
  These flags are now legacy compatibility no-op flags.
- Breaking CSV behavior: relationship `__r` columns are now generated consistently.
  `excludeIdsFromCSVFiles` removes raw `Id` and lookup `...Id` columns.
- Breaking file migration update: transfer was centralized in `core:ExportFiles`.
  This now covers `org -> org`, `org -> csvfile`, and `csvfile -> org`.
- Breaking runtime defaults: `--filelog` default changed to `0`.
  `--diagnostic` is now the recommended mode for full troubleshooting output.
- Validation hardening: default `apiVersion` moved to `65.0`.
  Script/object/operation validation is stricter and fails faster on invalid configs.
- Major refactor: engine rebuilt into API/CSV/mapping/logging modular layers.
  Added dedicated Bulk v1, Bulk v2, and REST execution engines.
- Major add-on platform update: custom add-on interfaces moved to `custom-addon-sdk`.
  Added template scaffolding and updated runtime adapters.

New features:
- Added Data Loader-oriented CSV and file workflow in the new engine.
  Includes unified handling for `ContentVersion`, `ContentDocumentLink`,
  `Attachment`, and `Note`.
- Added expanded `core:ExportFiles` behavior for all migration directions.
  Improved binary-path handling for org and csvfile flows.
- Added explicit CSV controls: `csvFileDelimiter`, `csvFileEncoding`,
  `csvInsertNulls`, `csvUseEuropeanDateFormat`,
  `csvWriteUpperCaseHeaders`, `csvUseUtf8Bom`.
- Added `--anonymise` flag for `.log` files with deterministic per-run hashes.
  Helps share diagnostics without exposing secrets, domains, emails, paths.

Deprecations/Removed features:
- Deprecated `csvReadFileDelimiter` and `csvWriteFileDelimiter`.
  Use `csvFileDelimiter` for current configurations.
- Removed standalone Node.js/module execution mode.
  Migration runs through `sf sfdmu run`.
- Deprecated runtime effect of `--verbose`, `--concise`, and `--usesf`.
  These flags are now legacy no-op compatibility flags.

Fixes:
- Fixed CSV id/reference edge cases by tightening `Id`, lookup-id, and `__r`.
  Reduced broken parent and lookup resolution during migration.
- Fixed file pipeline consistency by centralizing processing in `core:ExportFiles`.
  Reduced format drift between org and csvfile paths.

Improvements:
- Improved validation behavior with `apiVersion=65.0` and stricter checks.
  Invalid configs fail earlier and more predictably.
- Changed diagnostic defaults: `--filelog` now defaults to `0`.
  `--diagnostic` is the recommended troubleshooting mode.
- Improved support workflow security with complete `--anonymise` docs.
  Added full masking matrix of what is hashed and what stays unchanged.

Author: hknokh2

.eslintignore

@@ -0,0 +1 @@
+*.cjs/

.eslintrc.cjs

@@ -0,0 +1,8 @@
+module.exports = {
+  extends: ['eslint-config-salesforce-typescript', 'plugin:sf-plugin/recommended'],
+  root: true,
+  rules: {
+    header: 'off',
+    'no-underscore-dangle': 'off',
+  },
+};

.github/ISSUE_TEMPLATE/critical-runtime--errors-report.md

@@ -0,0 +1,35 @@
+---
+name: Feature Request
+about: Suggest a user-facing improvement for SFDMU.
+title: '[FEATURE REQUEST] - Replace this placeholder with a short and specific title.'
+labels: feature-request
+assignees: hknokh
+---
+
+**Feature title**  
+Use a short and specific title that clearly describes the requested feature.  
+-- Add your title here --
+
+**Problem statement**  
+Describe the current limitation or pain point this feature should solve.  
+-- Add your problem statement here --
+
+**Proposed solution**  
+Describe the behavior you want SFDMU to support.  
+-- Add your proposed solution here --
+
+**Expected user impact**  
+Describe how this feature improves migration results, reliability, or usability.  
+-- Add expected user impact here --
+
+**Configuration example (if applicable)**  
+Provide a concrete `export.json` or command example for the proposed behavior.  
+-- Add your configuration example here --
+
+**Alternatives considered**  
+Describe any workarounds or alternatives you tried and why they are insufficient.  
+-- Add alternatives here --
+
+**Additional context**  
+Add references, screenshots, links, or related issues.  
+-- Add additional context here --

.github/ISSUE_TEMPLATE/feature-request.md

@@ -0,0 +1,41 @@
+---
+name: Issue Report
+about: Report an issue with required diagnostic artifacts for investigation.
+title: '[ISSUE] - Replace this placeholder with a short and specific title.'
+labels: bug
+assignees: hknokh
+---
+
+**Issue title**  
+Use a short and specific title that clearly describes the problem.
+-- Add your title here --
+
+**Issue summary**  
+Describe what failed, what operation you ran, and the exact error message.
+-- Add your issue summary here --
+
+**Steps to reproduce**  
+List exact steps and command line used.
+-- Add steps to reproduce here --
+
+**Expected behavior**  
+Describe what you expected to happen.
+-- Add expected behavior here --
+
+**Actual behavior**  
+Describe what actually happened.
+-- Add actual behavior here --
+
+**Log file (required)**  
+Before submitting this issue, run SFDMU with `--diagnostic --anonymise` to generate a shareable log file.  
+Example command: `sf sfdmu run --sourceusername source@name.com --targetusername target@name.com --diagnostic --anonymise`  
+Attach your full generated **.log** file from that run.  
+If `--diagnostic` was not used or the full `.log` file is missing, **we cannot review this issue**.  
+`--anonymise` is required before sharing logs to hash sensitive values.  
+Reference (what is hashed and what is not): https://help.sfdmu.com/full-documentation/reports/the-execution-log#what-is-masked-and-what-is-not  
+-- Add your log file here (attach the .log file or link to it) --
+
+**\_target.csv file (if relevant)**  
+If there are failed rows, attach a dump of the **\_target.csv** file with error messages (include at least 1-2 full relevant rows).  
+Reference: https://help.sfdmu.com/full-documentation/reports/the-target-csv-files
+-- Add your \_target.csv file here (attach the file or link to it) --

.github/ISSUE_TEMPLATE/issue-report.md

@@ -0,0 +1,34 @@
+---
+name: Question
+about: Ask a question about SFDMU behavior or usage.
+title: '[QUESTION] - Replace this placeholder with a short and specific title.'
+labels: help-wanted
+assignees: hknokh
+---
+
+**Question title**  
+Use a short and specific title that clearly describes your question.  
+-- Add your title here --
+
+**Question summary**  
+Describe what you are trying to do and what is unclear.  
+-- Add your question summary here --
+
+**Current setup**  
+Share the relevant command, flags, and the related `export.json` fragment.  
+-- Add your setup details here --
+
+**What you already checked**  
+List docs/articles you already read and what did not answer your case.  
+-- Add what you already checked here --
+
+**Expected clarification**  
+Describe what exact answer or guidance you need.  
+-- Add expected clarification here --
+
+**Log file (optional, recommended for runtime/migration questions)**  
+For better understanding of your question, if it is related to an actual migration run,  
+run SFDMU with `--diagnostic --anonymise` and attach the full `.log` file.  
+Example command: `sf sfdmu run --sourceusername source@name.com --targetusername target@name.com --diagnostic --anonymise`  
+Reference (what is hashed and what is not): https://help.sfdmu.com/full-documentation/reports/the-execution-log#what-is-masked-and-what-is-not  
+-- Add your log file here (attach the .log file or link to it) --

.github/ISSUE_TEMPLATE/question.md

@@ -1,20 +1,47 @@
 version: 2
 updates:
-- package-ecosystem: npm
-  directory: "/"
-  schedule:
-    interval: daily
-    time: "07:00"
-  allow:
-      - dependency-type: "direct" # Optional: Focus on direct dependencies
-  open-pull-requests-limit: 10
-  versioning-strategy: increase
-  ignore:
-      - dependency-name: "csv-parse" 
-      - dependency-name: "globby" 
-      - dependency-name: "madge"  
-      - dependency-name: "mocha"
-      - dependency-name: "nyc"
-      - dependency-name: "@oclif/*"    
-      - dependency-name: "soql-parser-js" 
-      - dependency-name: "@babel/*"   
+  - package-ecosystem: npm
+    directory: '/'
+    schedule:
+      interval: weekly
+      day: monday
+      time: '07:00'
+      timezone: 'UTC'
+    open-pull-requests-limit: 10
+    versioning-strategy: increase
+    rebase-strategy: auto
+    groups:
+      sf-cli-and-oclif:
+        patterns:
+          - '@salesforce/*'
+          - '@oclif/*'
+          - 'oclif'
+      third-party-runtime:
+        patterns:
+          - 'soql-parser-js'
+          - 'alasql'
+          - 'casual'
+          - 'class-transformer'
+          - 'csv-parse'
+          - 'csv-writer'
+          - 'es6-shim'
+          - 'glob'
+          - 'promise-parallel-throttle'
+          - 'reflect-metadata'
+      build-and-test-tooling:
+        patterns:
+          - '@jsforce/jsforce-node'
+          - 'typescript'
+          - 'ts-node'
+          - 'eslint*'
+          - 'mocha'
+          - 'nyc'
+  - package-ecosystem: github-actions
+    directory: '/'
+    schedule:
+      interval: weekly
+      day: monday
+      time: '07:30'
+      timezone: 'UTC'
+    open-pull-requests-limit: 5
+    rebase-strategy: auto

.github/dependabot.yml

@@ -1,26 +1,73 @@
+# -- CLEAN
+tmp/
+# use yarn by default, so ignore npm
+package-lock.json
+
+# never checkin npm config
+.npmrc
+
+# debug logs
+npm-error.log
+yarn-error.log
+
+
+# compile source
+lib
+
+# test artifacts
+*xunit.xml
+*checkstyle.xml
+*unitcoverage
+.nyc_output
+coverage
+test_session*
+
+# generated docs
+docs
+
+# ignore sfdx-trust files
+*.tgz
+*.sig
+package.json.bak.
+
+
+npm-shrinkwrap.json
+oclif.manifest.json
+oclif.lock
+
+# -- CLEAN ALL
+*.tsbuildinfo
+.eslintcache
+.wireit
+node_modules
+
+# --
+# put files here you don't want cleaned with sf-clean
+
+# os specific files
+.DS_Store
+.idea
+
+# Project-specific rules from .gitignore-new
+custom-addon-sdk/dist
+custom-addon-sdk/custom-modules/**/dist
+custom-addon-sdk/custom-modules/**/*
+!custom-addon-sdk/custom-modules/.gitkeep
+!custom-addon-sdk/custom-modules/demo/
+!custom-addon-sdk/custom-modules/demo/**
+custom-addon-sdk/custom-modules/demo/dist
+custom-addon-sdk/custom-modules/demo/dist/**
+
+tmp*
 *-debug.log
 *-error.log
-/.nyc_output
-/dist
-/dist2
-/lib
-/package-lock.json
-/tmp
-node_modules
 /export*.json
 ._*
-.DS_Store
 /logs
 /source
 /target
-/development
-/documentation
-/src/addons/modules/sfdmu-run/custom-addons/TestModule*
-typedoc-sfdmu-run-addons.json
-/temp
 *-private*
 /.vscode
-/.images
+/development
+CHANGELOG-DEV.md
 AGENTS.md
-
-