Add pipeline simulation with simulate CLI command

.changeset/smooth-cows-doubt.md

@@ -0,0 +1,27 @@
+---
+"@noxify/gitlab-ci-builder": minor
+---
+
+Added pipeline simulation feature and improved remote extends handling
+
+**Simulation Features:**
+
+- Added `simulate` CLI command to simulate GitLab CI pipeline execution
+- Added `PipelineSimulator` class for rule evaluation and job filtering
+- Support for branch, tag, and merge request pipeline simulation
+- Multiple output formats: summary, table, JSON, YAML, and text
+- Predefined CI variables automatically set based on context
+- Comprehensive integration and E2E test coverage
+
+**Remote Extends Improvements:**
+
+- Added `mergeRemoteExtends` global option to control remote extends resolution
+- Fixed remote extends resolution for accurate pipeline simulation
+- Better handling of remote includes and templates
+
+**Documentation & Testing:**
+
+- Enhanced CLI documentation with predefined variables table
+- Added error handling documentation for remote includes
+- Added "Common Pitfalls & Best Practices" section
+- Improved JSDoc coverage for all public APIs

.github/copilot-instructions.md

@@ -30,8 +30,7 @@
   1. Types first
   2. React/Next.js/Expo (if applicable)
   3. Third-party modules
-  4. @vorsteh-queue packages
-  5. Relative imports (~/,../, ./)
+  4. Relative imports (~/,../, ./)
 
 ## Code Generation Guidelines
 

.github/workflows/ci.yml

@@ -80,6 +80,9 @@ jobs:
       - name: Integration Tests
         run: pnpm test:integration
 
+      - name: E2E Tests
+        run: pnpm test:e2e
+
   pkg-new-release:
     needs: [lint, format, typecheck]
     if: github.event_name == 'pull_request'