@lumenflow/core 1.3.6 → 1.5.0

package/dist/micro-worktree.js

@@ -40,6 +40,18 @@ import { BRANCHES, REMOTES, GIT_REFS, PKG_MANAGER, SCRIPTS, PRETTIER_FLAGS, STDI
  * concurrently. Each retry fetches latest main and rebases.
  */
 export const MAX_MERGE_RETRIES = 3;
+/**
+ * Environment variable name for LUMENFLOW_FORCE bypass
+ *
+ * WU-1081: Exported for use in micro-worktree push operations.
+ */
+export const LUMENFLOW_FORCE_ENV = 'LUMENFLOW_FORCE';
+/**
+ * Environment variable name for LUMENFLOW_FORCE_REASON audit trail
+ *
+ * WU-1081: Exported for use in micro-worktree push operations.
+ */
+export const LUMENFLOW_FORCE_REASON_ENV = 'LUMENFLOW_FORCE_REASON';
 /**
  * Default log prefix for micro-worktree operations
  *
@@ -344,6 +356,51 @@ export async function mergeWithRetry(tempBranchName, microWorktreePath, logPrefi
         }
     }
 }
+/**
+ * Push using refspec with LUMENFLOW_FORCE to bypass pre-push hooks
+ *
+ * WU-1081: Micro-worktree pushes to origin/main need to bypass pre-push hooks
+ * because they operate from temp branches in /tmp directories, which would
+ * otherwise be blocked by hook validation.
+ *
+ * Sets LUMENFLOW_FORCE=1 and LUMENFLOW_FORCE_REASON during the push,
+ * then restores original environment values (even on error).
+ *
+ * @param {GitAdapter} gitAdapter - GitAdapter instance to use for push
+ * @param {string} remote - Remote name (e.g., 'origin')
+ * @param {string} localRef - Local ref to push (e.g., 'tmp/wu-claim/wu-123')
+ * @param {string} remoteRef - Remote ref to update (e.g., 'main')
+ * @param {string} reason - Audit reason for the LUMENFLOW_FORCE bypass
+ * @returns {Promise<void>}
+ * @throws {Error} If push fails (env vars still restored)
+ */
+export async function pushRefspecWithForce(gitAdapter, remote, localRef, remoteRef, reason) {
+    // Save original env values
+    const originalForce = process.env[LUMENFLOW_FORCE_ENV];
+    const originalReason = process.env[LUMENFLOW_FORCE_REASON_ENV];
+    try {
+        // Set LUMENFLOW_FORCE for the push
+        process.env[LUMENFLOW_FORCE_ENV] = '1';
+        process.env[LUMENFLOW_FORCE_REASON_ENV] = reason;
+        // Perform the push
+        await gitAdapter.pushRefspec(remote, localRef, remoteRef);
+    }
+    finally {
+        // Restore original env values
+        if (originalForce === undefined) {
+            delete process.env[LUMENFLOW_FORCE_ENV];
+        }
+        else {
+            process.env[LUMENFLOW_FORCE_ENV] = originalForce;
+        }
+        if (originalReason === undefined) {
+            delete process.env[LUMENFLOW_FORCE_REASON_ENV];
+        }
+        else {
+            process.env[LUMENFLOW_FORCE_REASON_ENV] = originalReason;
+        }
+    }
+}
 /**
  * Execute an operation in a micro-worktree with full isolation
  *
@@ -401,8 +458,9 @@ export async function withMicroWorktree(options) {
         // Step 6: Push to origin (different paths for pushOnly vs standard)
         if (pushOnly) {
             // WU-1435: Push directly to origin/main without touching local main
+            // WU-1081: Use LUMENFLOW_FORCE to bypass pre-push hooks for micro-worktree pushes
             console.log(`${logPrefix} Pushing directly to ${REMOTES.ORIGIN}/${BRANCHES.MAIN} (push-only)...`);
-            await gitWorktree.pushRefspec(REMOTES.ORIGIN, tempBranchName, BRANCHES.MAIN);
+            await pushRefspecWithForce(gitWorktree, REMOTES.ORIGIN, tempBranchName, BRANCHES.MAIN, `micro-worktree push for ${operation} (automated)`);
             console.log(`${logPrefix} ✅ Pushed to ${REMOTES.ORIGIN}/${BRANCHES.MAIN}`);
             // Fetch to update remote tracking ref (FETCH_HEAD)
             console.log(`${logPrefix} Fetching ${REMOTES.ORIGIN}/${BRANCHES.MAIN}...`);

package/dist/wu-done-preflight.js

@@ -2,6 +2,7 @@
  * Preflight validation helpers for wu:done.
  */
 import { execSync as execSyncImport } from 'node:child_process';
+import { existsSync } from 'node:fs';
 import { validatePreflight } from './wu-preflight-validators.js';
 import { LOG_PREFIX, EMOJI, STDIO } from './wu-constants.js';
 /**
@@ -164,8 +165,14 @@ export function validateAllPreCommitHooks(id, worktreePath = null, options = {})
         if (worktreePath) {
             execOptions.cwd = worktreePath;
         }
+        // WU-1086: Check for .mjs extension first, fall back to .js for backwards compatibility
+        const basePath = worktreePath || '.';
+        const mjsPath = `${basePath}/tools/gates-pre-commit.mjs`;
+        const gateScript = existsSync(mjsPath)
+            ? 'tools/gates-pre-commit.mjs'
+            : 'tools/gates-pre-commit.js';
         // Run the gates-pre-commit script that contains all validation gates
-        execSyncFn('node tools/gates-pre-commit.js', execOptions);
+        execSyncFn(`node ${gateScript}`, execOptions);
         console.log(`${LOG_PREFIX.DONE} ${EMOJI.SUCCESS} All pre-commit hooks passed`);
         return { valid: true, errors: [] };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/core",
-  "version": "1.3.6",
+  "version": "1.5.0",
   "description": "Core WU lifecycle tools for LumenFlow workflow framework",
   "keywords": [
     "lumenflow",
@@ -66,6 +66,7 @@
     "README.md"
   ],
   "dependencies": {
+    "chalk": "^5.6.2",
     "change-case": "^5.4.4",
     "cli-progress": "^3.12.0",
     "cli-table3": "^0.6.5",
@@ -91,15 +92,11 @@
     "vitest": "^4.0.17"
   },
   "peerDependencies": {
-    "@lumenflow/memory": "1.3.6",
-    "@lumenflow/initiatives": "1.3.6"
+    "@lumenflow/memory": "1.5.0"
   },
   "peerDependenciesMeta": {
     "@lumenflow/memory": {
       "optional": true
-    },
-    "@lumenflow/initiatives": {
-      "optional": true
     }
   },
   "engines": {