scripts-orchestrator 2.9.0 → 2.10.0

package/README.md

@@ -263,6 +263,9 @@ The orchestrator doesn't care what the commands do - it just ensures they run (i
 
    # Specify a custom log folder
    npm run scripts-orchestrator -- --logFolder ./custom-logs
+
+   # Force execution even if git state is unchanged
+   npm run scripts-orchestrator -- --force
    ```
 
 ### Starting from a Specific Phase
@@ -422,6 +425,21 @@ This feature is particularly useful in CI/CD pipelines where the same commit mig
 
 **Note**: The cache is only updated on successful execution. Failed runs will not update the cache, ensuring subsequent runs will retry.
 
+### Force Execution
+
+You can bypass the git cache check and force execution even when the git state is unchanged by using the `--force` flag:
+
+```bash
+# Force execution regardless of git state
+npm run scripts-orchestrator -- --force
+```
+
+This is useful when you want to:
+- Re-run commands without making code changes
+- Test configuration changes
+- Debug issues without modifying the codebase
+- Override the cache in CI/CD pipelines
+
 ## Exit Codes
 
 - `0`: All commands executed successfully

package/index.js

@@ -35,6 +35,10 @@ const argv = yargs(hideBin(process.argv))
     type: 'boolean',
     description: 'Run all commands sequentially instead of in parallel (for low CPU machines)',
   })
+  .option('force', {
+    type: 'boolean',
+    description: 'Force execution even if git state is unchanged',
+  })
   .help()
   .alias('h', 'help')
   .parse();
@@ -46,6 +50,7 @@ let startPhase = argv.phase;
 let logFolder = argv.logFolder;
 const phases = argv.phases ? argv.phases.split(',').map(p => p.trim()) : null;
 const sequential = argv.sequential || false;
+const force = argv.force || false;
 
 // Validate config file exists
 if (!fs.existsSync(configPath)) {
@@ -75,7 +80,7 @@ if (logFolder) {
 }
 
 // Create and run the orchestrator
-const orchestrator = new Orchestrator(commandsConfig, startPhase, logFolder, phases, sequential);
+const orchestrator = new Orchestrator(commandsConfig, startPhase, logFolder, phases, sequential, force);
 
 // Enhanced signal handlers
 const handleSignal = async (signal) => {

package/lib/orchestrator.js

@@ -4,12 +4,13 @@ import { log } from './logger.js';
 import { GitCache } from './git-cache.js';
 
 export class Orchestrator {
-  constructor(config, startPhase = null, logFolder = null, phases = null, sequential = false) {
+  constructor(config, startPhase = null, logFolder = null, phases = null, sequential = false, force = false) {
     this.config = config;
     this.startPhase = startPhase;
     this.logFolder = logFolder;
     this.phases = phases;
     this.sequential = sequential;
+    this.force = force;
     this.processManager = processManager;
     this.healthCheck = healthCheck;
     this.logger = log;
@@ -240,11 +241,16 @@ export class Orchestrator {
 
   async run() {
     try {
-      // Check if we should skip execution based on git state
-      const shouldSkip = await this.gitCache.shouldSkipExecution();
-      if (shouldSkip) {
-        this.logger.success('🎉 No changes detected, skipping execution!');
-        process.exit(0);
+      // Check if we should skip execution based on git state (unless forced)
+      if (!this.force) {
+        const shouldSkip = await this.gitCache.shouldSkipExecution();
+        if (shouldSkip) {
+          this.logger.success('🎉 No changes detected, skipping execution!');
+          this.logger.info('💡 To force execution, use: --force');
+          process.exit(0);
+        }
+      } else {
+        this.logger.info('⚡ Force execution enabled, skipping git cache check');
       }
 
       let hasFailures = false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scripts-orchestrator",
-  "version": "2.9.0",
+  "version": "2.10.0",
   "description": "A powerful script orchestrator for running parallel commands with dependency management, background processes, and health checks",
   "main": "lib/index.js",
   "type": "module",