@lumenflow/core 2.10.0 → 2.11.0

package/dist/agent-patterns-registry.js

@@ -12,6 +12,7 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import * as os from 'node:os';
+import { LUMENFLOW_PATHS } from './wu-constants.js';
 /** Default agent branch patterns (narrow: just agent/*) */
 export const DEFAULT_AGENT_PATTERNS = ['agent/*'];
 /** Remote registry URL */
@@ -34,9 +35,10 @@ let memoryCacheTime = 0;
 export function getCacheDir() {
     const lumenflowHome = process.env.LUMENFLOW_HOME;
     if (lumenflowHome) {
-        return path.join(lumenflowHome, 'cache');
+        return path.join(lumenflowHome, LUMENFLOW_PATHS.HOME_CACHE);
     }
-    return path.join(os.homedir(), '.lumenflow', 'cache');
+    // WU-1430: Compose home cache path from centralized constants
+    return path.join(os.homedir(), LUMENFLOW_PATHS.BASE, LUMENFLOW_PATHS.HOME_CACHE);
 }
 /**
  * Validate registry response

package/dist/arg-parser.js

@@ -317,6 +317,11 @@ export const WU_OPTIONS = {
         description: 'Acceptance criterion (repeatable, use multiple times)',
         isRepeatable: true,
     },
+    notes: {
+        name: 'notes',
+        flags: '--notes <text>',
+        description: 'Implementation notes or context (optional)',
+    },
     codePaths: {
         name: 'codePaths',
         flags: '--code-paths <paths>',

package/dist/constants/linter-constants.d.ts

@@ -10,7 +10,7 @@ export declare const LINTER_CONFIG: {
     WATCHDOG_TIMEOUT_MS: number;
     /**
      * Maximum allowed glass surfaces in UI components.
-     * Per Beacon spec glass cap artifacts rule.
+     * Per design system glass cap artifacts rule.
      */
     MAX_GLASS_SURFACES: number;
 };

package/dist/constants/linter-constants.js

@@ -10,7 +10,7 @@ export const LINTER_CONFIG = {
     WATCHDOG_TIMEOUT_MS: 55000,
     /**
      * Maximum allowed glass surfaces in UI components.
-     * Per Beacon spec glass cap artifacts rule.
+     * Per design system glass cap artifacts rule.
      */
     MAX_GLASS_SURFACES: 6,
 };

package/dist/docs-path-validator.js

@@ -22,7 +22,7 @@
  */
 import path from 'node:path';
 import { WU_EVENTS_FILE_NAME } from './wu-state-store.js';
-import { BEACON_PATHS, DIRECTORIES, FILE_EXTENSIONS, STRING_LITERALS } from './wu-constants.js';
+import { LUMENFLOW_PATHS, DIRECTORIES, FILE_EXTENSIONS, STRING_LITERALS } from './wu-constants.js';
 const POSIX = path.posix;
 const DOCS_ONLY_PREFIXES = Object.freeze([
     DIRECTORIES.DOCS,
@@ -31,8 +31,8 @@ const DOCS_ONLY_PREFIXES = Object.freeze([
     DIRECTORIES.MEMORY_BANK,
 ]);
 const TOOLS_TESTS_PREFIX = `${POSIX.join(DIRECTORIES.TOOLS, '__tests__')}${STRING_LITERALS.SLASH}`;
-const STAMPS_PREFIX = `${BEACON_PATHS.STAMPS_DIR}${STRING_LITERALS.SLASH}`;
-const WU_EVENTS_PATH = POSIX.join(BEACON_PATHS.STATE_DIR, WU_EVENTS_FILE_NAME);
+const STAMPS_PREFIX = `${LUMENFLOW_PATHS.STAMPS_DIR}${STRING_LITERALS.SLASH}`;
+const WU_EVENTS_PATH = POSIX.join(LUMENFLOW_PATHS.STATE_DIR, WU_EVENTS_FILE_NAME);
 /**
  * Check if a file path is allowed for docs-only WUs
  * @param {string} filePath - The file path to validate

package/dist/domain/context.schemas.d.ts

@@ -41,10 +41,10 @@ export declare const LocationType: {
  * Schema for location types
  */
 export declare const LocationTypeSchema: z.ZodEnum<{
-    unknown: "unknown";
     main: "main";
     worktree: "worktree";
     detached: "detached";
+    unknown: "unknown";
 }>;
 /**
  * Schema for location context
@@ -53,10 +53,10 @@ export declare const LocationTypeSchema: z.ZodEnum<{
  */
 export declare const LocationContextSchema: z.ZodObject<{
     type: z.ZodEnum<{
-        unknown: "unknown";
         main: "main";
         worktree: "worktree";
         detached: "detached";
+        unknown: "unknown";
     }>;
     cwd: z.ZodString;
     gitRoot: z.ZodString;
@@ -112,10 +112,10 @@ export declare const SessionStateSchema: z.ZodObject<{
 export declare const WuContextSchema: z.ZodObject<{
     location: z.ZodObject<{
         type: z.ZodEnum<{
-            unknown: "unknown";
             main: "main";
             worktree: "worktree";
             detached: "detached";
+            unknown: "unknown";
         }>;
         cwd: z.ZodString;
         gitRoot: z.ZodString;

package/dist/domain/orchestration.constants.d.ts

@@ -96,7 +96,7 @@ export type MandatoryAgentName = (typeof MANDATORY_AGENT_NAMES)[number];
  *
  * Example application-specific triggers (configure in your project):
  * - security-auditor: supabase/migrations/**, auth/**, rls/**
- * - beacon-guardian: prompts/**, llm/**
+ * - llm-reviewer: prompts/**, llm/**
  *
  * Usage:
  * ```typescript

package/dist/domain/orchestration.constants.js

@@ -99,7 +99,7 @@ export const MANDATORY_AGENT_NAMES = [];
  *
  * Example application-specific triggers (configure in your project):
  * - security-auditor: supabase/migrations/**, auth/**, rls/**
- * - beacon-guardian: prompts/**, llm/**
+ * - llm-reviewer: prompts/**, llm/**
  *
  * Usage:
  * ```typescript

package/dist/domain/orchestration.types.d.ts

@@ -51,7 +51,7 @@ export type AgentMetric = z.infer<typeof AgentMetricSchema>;
  *   title: 'LLM Classification Feature',
  *   dodProgress: 8,
  *   dodTotal: 11,
- *   agents: { 'beacon-guardian': 'pass', 'code-reviewer': 'pending' },
+ *   agents: { 'llm-reviewer': 'pass', 'code-reviewer': 'pending' },
  *   headline: 'Blocked on code-reviewer - awaiting approval',
  * };
  */
@@ -102,7 +102,7 @@ export type Suggestion = z.infer<typeof SuggestionSchema>;
  * const plan: ExecutionPlan = {
  *   wuId: 'WU-1234',
  *   steps: [
- *     { order: 1, agent: 'beacon-guardian', status: 'pending' },
+ *     { order: 1, agent: 'llm-reviewer', status: 'pending' },
  *     { order: 2, action: 'gates', status: 'pending' },
  *   ],
  *   estimatedTokens: 5000,

package/dist/domain/validation.schemas.d.ts

@@ -21,8 +21,8 @@ export declare const VALIDATION_ERROR_CODE_VALUES: readonly ["WRONG_LOCATION", "
  * Schema for validation error codes
  */
 export declare const ValidationErrorCodeSchema: z.ZodEnum<{
-    WU_NOT_FOUND: "WU_NOT_FOUND";
     WRONG_LOCATION: "WRONG_LOCATION";
+    WU_NOT_FOUND: "WU_NOT_FOUND";
     WU_ALREADY_EXISTS: "WU_ALREADY_EXISTS";
     WRONG_WU_STATUS: "WRONG_WU_STATUS";
     LANE_OCCUPIED: "LANE_OCCUPIED";
@@ -51,8 +51,8 @@ export declare const PredicateSeveritySchema: z.ZodEnum<{
  */
 export declare const ValidationErrorSchema: z.ZodObject<{
     code: z.ZodEnum<{
-        WU_NOT_FOUND: "WU_NOT_FOUND";
         WRONG_LOCATION: "WRONG_LOCATION";
+        WU_NOT_FOUND: "WU_NOT_FOUND";
         WU_ALREADY_EXISTS: "WU_ALREADY_EXISTS";
         WRONG_WU_STATUS: "WRONG_WU_STATUS";
         LANE_OCCUPIED: "LANE_OCCUPIED";
@@ -84,8 +84,8 @@ export declare const ValidationResultSchema: z.ZodObject<{
     valid: z.ZodBoolean;
     errors: z.ZodArray<z.ZodObject<{
         code: z.ZodEnum<{
-            WU_NOT_FOUND: "WU_NOT_FOUND";
             WRONG_LOCATION: "WRONG_LOCATION";
+            WU_NOT_FOUND: "WU_NOT_FOUND";
             WU_ALREADY_EXISTS: "WU_ALREADY_EXISTS";
             WRONG_WU_STATUS: "WRONG_WU_STATUS";
             LANE_OCCUPIED: "LANE_OCCUPIED";
@@ -129,10 +129,10 @@ export declare const CommandDefinitionConfigSchema: z.ZodObject<{
     name: z.ZodString;
     description: z.ZodString;
     requiredLocation: z.ZodNullable<z.ZodEnum<{
-        unknown: "unknown";
         main: "main";
         worktree: "worktree";
         detached: "detached";
+        unknown: "unknown";
     }>>;
     requiredWuStatus: z.ZodNullable<z.ZodString>;
     predicateIds: z.ZodArray<z.ZodString>;

package/dist/hardcoded-strings.js

@@ -160,7 +160,7 @@ export function classifyPath(pathStr) {
  * Remediation messages for each path type
  */
 const REMEDIATION_MESSAGES = Object.freeze({
-    [PATH_TYPES.ROUTE]: 'Route path - use an endpoint constant or config (e.g., BEACON_API_ENDPOINT, API_ROUTES.ASSISTANT)',
+    [PATH_TYPES.ROUTE]: 'Route path - use an endpoint constant or config (e.g., API_ENDPOINT, API_ROUTES.ASSISTANT)',
     [PATH_TYPES.FILESYSTEM]: 'File path - use path.join() with constants',
     [PATH_TYPES.UNKNOWN]: 'Path string - use a constant or configuration value',
 });

package/dist/index.d.ts

@@ -7,7 +7,6 @@ export * from './arg-parser.js';
 export * from './date-utils.js';
 export * from './error-handler.js';
 export * from './retry-strategy.js';
-export * from './beacon-migration.js';
 export * from './cycle-detector.js';
 export { DEFAULT_DOMAIN, inferDefaultDomain, normalizeToEmail, isValidEmail, } from './user-normalizer.js';
 export * from './git-adapter.js';
@@ -52,7 +51,7 @@ export * from './branch-check.js';
 export * from './agent-patterns-registry.js';
 export * from './lumenflow-home.js';
 export * from './force-bypass-audit.js';
-export { LUMENFLOW_PATHS, BEACON_PATHS } from './wu-constants.js';
+export { LUMENFLOW_PATHS } from './wu-constants.js';
 export { STREAM_ERRORS, EXIT_CODES } from './wu-constants.js';
 export * from './stream-error-handler.js';
 export * from './color-support.js';
@@ -84,3 +83,4 @@ export { loadManifest, loadTemplate, loadTemplatesWithOverrides, assembleTemplat
 export { tryAssembleSpawnTemplates, buildTemplateContext } from './wu-spawn.js';
 export * from './patrol-loop.js';
 export { resolvePolicy, getDefaultPolicy, MethodologyConfigSchema, MethodologyOverridesSchema, TestingMethodologySchema, ArchitectureMethodologySchema, CoverageModeSchema, TESTING_METHODOLOGY, ARCHITECTURE_METHODOLOGY, COVERAGE_MODE, type ResolvedPolicy, type ResolvePolicyOptions, type MethodologyConfig, type MethodologyOverrides, type TestingMethodology, type ArchitectureMethodology, type CoverageMode, } from './resolve-policy.js';
+export { listWUs, type WUListEntry, type ListWUsOptions } from './wu-list.js';

package/dist/index.js

@@ -9,8 +9,6 @@ export * from './arg-parser.js';
 export * from './date-utils.js';
 export * from './error-handler.js';
 export * from './retry-strategy.js';
-// Migration utilities (WU-1075)
-export * from './beacon-migration.js';
 // Cycle detection (WU-1088 - extracted from initiatives to break circular dependency)
 export * from './cycle-detector.js';
 // User normalizer (explicit exports to avoid conflicts)
@@ -85,7 +83,7 @@ export * from './lumenflow-home.js';
 // WU-1070: Force bypass audit logging
 export * from './force-bypass-audit.js';
 // WU-1075: LumenFlow directory paths (exported from wu-constants)
-export { LUMENFLOW_PATHS, BEACON_PATHS } from './wu-constants.js';
+export { LUMENFLOW_PATHS } from './wu-constants.js';
 // WU-1233: Stream error handling (EPIPE protection)
 export { STREAM_ERRORS, EXIT_CODES } from './wu-constants.js';
 export * from './stream-error-handler.js';
@@ -157,3 +155,5 @@ export { tryAssembleSpawnTemplates, buildTemplateContext } from './wu-spawn.js';
 export * from './patrol-loop.js';
 // WU-1259: Methodology policy resolution
 export { resolvePolicy, getDefaultPolicy, MethodologyConfigSchema, MethodologyOverridesSchema, TestingMethodologySchema, ArchitectureMethodologySchema, CoverageModeSchema, TESTING_METHODOLOGY, ARCHITECTURE_METHODOLOGY, COVERAGE_MODE, } from './resolve-policy.js';
+// WU-1411: WU list helper for MCP server and other tools
+export { listWUs } from './wu-list.js';

package/dist/invariants/check-automated-tests.js

@@ -18,6 +18,7 @@ import { existsSync, readdirSync, readFileSync } from 'node:fs';
 import path from 'node:path';
 import { parseYAML } from '../wu-yaml.js';
 import { validateAutomatedTestRequirement, isCodeFile } from '../manual-test-validator.js';
+import { DIRECTORIES } from '../wu-constants.js';
 /**
  * Invariant metadata
  */
@@ -31,8 +32,9 @@ export const INVARIANT_TYPE = 'wu-automated-tests';
 const ACTIVE_STATUSES = Object.freeze(['in_progress', 'blocked']);
 /**
  * Default path to WU YAML files relative to base directory.
+ * WU-1430: Use centralized constant instead of hardcoded path.
  */
-const WU_YAML_PATH = 'docs/04-operations/tasks/wu';
+const WU_YAML_PATH = DIRECTORIES.WU_DIR;
 /**
  * Check a single WU YAML file for automated test requirement.
  *

package/dist/lumenflow-config-schema.d.ts

@@ -126,9 +126,9 @@ export declare const DirectoriesSchema: z.ZodObject<{
     onboardingDir: z.ZodDefault<z.ZodString>;
 }, z.core.$strip>;
 /**
- * Beacon paths configuration (.lumenflow directory structure)
+ * State paths configuration (.lumenflow directory structure)
  */
-export declare const BeaconPathsSchema: z.ZodObject<{
+export declare const StatePathsSchema: z.ZodObject<{
     base: z.ZodDefault<z.ZodString>;
     stateDir: z.ZodDefault<z.ZodString>;
     archiveDir: z.ZodDefault<z.ZodString>;
@@ -619,7 +619,7 @@ export declare const LumenFlowConfigSchema: z.ZodObject<{
         templatesDir: z.ZodDefault<z.ZodString>;
         onboardingDir: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
-    beacon: z.ZodDefault<z.ZodObject<{
+    state: z.ZodDefault<z.ZodObject<{
         base: z.ZodDefault<z.ZodString>;
         stateDir: z.ZodDefault<z.ZodString>;
         archiveDir: z.ZodDefault<z.ZodString>;
@@ -876,7 +876,7 @@ export declare const LumenFlowConfigSchema: z.ZodObject<{
  * TypeScript types inferred from schemas
  */
 export type Directories = z.infer<typeof DirectoriesSchema>;
-export type BeaconPaths = z.infer<typeof BeaconPathsSchema>;
+export type StatePaths = z.infer<typeof StatePathsSchema>;
 export type PushRetryConfig = z.infer<typeof PushRetryConfigSchema>;
 export type GitConfig = z.infer<typeof GitConfigSchema>;
 export type WuConfig = z.infer<typeof WuConfigSchema>;
@@ -928,7 +928,7 @@ export declare function validateConfig(data: unknown): z.ZodSafeParseResult<{
         templatesDir: string;
         onboardingDir: string;
     };
-    beacon: {
+    state: {
         base: string;
         stateDir: string;
         archiveDir: string;

package/dist/lumenflow-config-schema.js

@@ -164,10 +164,10 @@ export const DirectoriesSchema = z.object({
     onboardingDir: z.string().default('docs/04-operations/_frameworks/lumenflow/agent/onboarding'),
 });
 /**
- * Beacon paths configuration (.lumenflow directory structure)
+ * State paths configuration (.lumenflow directory structure)
  */
-export const BeaconPathsSchema = z.object({
-    /** Base beacon directory (default: '.lumenflow') */
+export const StatePathsSchema = z.object({
+    /** Base state directory (default: '.lumenflow') */
     base: z.string().default('.lumenflow'),
     /** State directory (default: '.lumenflow/state') */
     stateDir: z.string().default('.lumenflow/state'),
@@ -847,8 +847,8 @@ export const LumenFlowConfigSchema = z.object({
     version: z.string().default('1.0.0'),
     /** Directory paths */
     directories: DirectoriesSchema.default(() => DirectoriesSchema.parse({})),
-    /** Beacon paths */
-    beacon: BeaconPathsSchema.default(() => BeaconPathsSchema.parse({})),
+    /** State paths (.lumenflow directory structure) */
+    state: StatePathsSchema.default(() => StatePathsSchema.parse({})),
     /** Git configuration */
     git: GitConfigSchema.default(() => GitConfigSchema.parse({})),
     /** WU configuration */

package/dist/lumenflow-config.d.ts

@@ -95,5 +95,5 @@ export declare function validateConfigFile(configPath: string): {
 export declare function createSampleConfig(outputPath: string, options?: {
     includeComments?: boolean;
 }): void;
-export type { LumenFlowConfig, Directories, BeaconPaths, PushRetryConfig, GitConfig, WuConfig, GatesConfig, MemoryConfig, UiConfig, YamlConfig, } from './lumenflow-config-schema.js';
+export type { LumenFlowConfig, Directories, StatePaths, PushRetryConfig, GitConfig, WuConfig, GatesConfig, MemoryConfig, UiConfig, YamlConfig, } from './lumenflow-config-schema.js';
 export { getDefaultConfig } from './lumenflow-config-schema.js';

package/dist/lumenflow-config.js

@@ -139,8 +139,8 @@ export function getResolvedPaths(options = {}) {
         backlogPath: path.join(projectRoot, config.directories.backlogPath),
         statusPath: path.join(projectRoot, config.directories.statusPath),
         worktrees: path.join(projectRoot, config.directories.worktrees),
-        stampsDir: path.join(projectRoot, config.beacon.stampsDir),
-        stateDir: path.join(projectRoot, config.beacon.stateDir),
+        stampsDir: path.join(projectRoot, config.state.stampsDir),
+        stateDir: path.join(projectRoot, config.state.stateDir),
         skillsDir: path.join(projectRoot, config.directories.skillsDir),
         agentsDir: path.join(projectRoot, config.directories.agentsDir),
         memoryBank: path.join(projectRoot, config.directories.memoryBank),
@@ -215,11 +215,11 @@ directories:
   # Onboarding directory
   onboardingDir: "${defaultConfig.directories.onboardingDir}"
 
-# Beacon paths (.lumenflow directory structure)
-beacon:
-  base: "${defaultConfig.beacon.base}"
-  stampsDir: "${defaultConfig.beacon.stampsDir}"
-  stateDir: "${defaultConfig.beacon.stateDir}"
+# State paths (.lumenflow directory structure)
+state:
+  base: "${defaultConfig.state.base}"
+  stampsDir: "${defaultConfig.state.stampsDir}"
+  stateDir: "${defaultConfig.state.stateDir}"
 
 # Git configuration
 git:

package/dist/micro-worktree.d.ts

@@ -348,7 +348,7 @@ export declare function mergeWithRetry(tempBranchName: string, microWorktreePath
  * @param {string} logPrefix - Log prefix for console output
  * @throws {Error} If push fails after all retries
  */
-export declare function pushWithRetry(mainGit: GitAdapter, worktreeGit: GitAdapter, remote: string, branch: string, tempBranchName: string, logPrefix?: string): Promise<void>;
+export declare function pushWithRetry(mainGit: GitAdapter, worktreeGit: GitAdapter, remote: string, branch: string, tempBranchName: string, logPrefix?: string, operation?: string): Promise<void>;
 /**
  * WU-1332: Push to origin with configurable retry using p-retry
  *
@@ -374,7 +374,7 @@ export declare function pushWithRetry(mainGit: GitAdapter, worktreeGit: GitAdapt
  * @param {PushRetryConfig} config - Push retry configuration
  * @throws {Error} If push fails after all retries or if retry is disabled
  */
-export declare function pushWithRetryConfig(mainGit: GitAdapter, worktreeGit: GitAdapter, remote: string, branch: string, tempBranchName: string, logPrefix?: string, config?: PushRetryConfig): Promise<void>;
+export declare function pushWithRetryConfig(mainGit: GitAdapter, worktreeGit: GitAdapter, remote: string, branch: string, tempBranchName: string, logPrefix?: string, config?: PushRetryConfig, operation?: string): Promise<void>;
 /**
  * Push using refspec with LUMENFLOW_FORCE to bypass pre-push hooks
  *

package/dist/micro-worktree.js

@@ -597,42 +597,59 @@ export async function mergeWithRetry(tempBranchName, microWorktreePath, logPrefi
  * @param {string} logPrefix - Log prefix for console output
  * @throws {Error} If push fails after all retries
  */
-export async function pushWithRetry(mainGit, worktreeGit, remote, branch, tempBranchName, logPrefix = DEFAULT_LOG_PREFIX) {
+export async function pushWithRetry(mainGit, worktreeGit, remote, branch, tempBranchName, logPrefix = DEFAULT_LOG_PREFIX, operation) {
     const maxRetries = MAX_PUSH_RETRIES;
-    for (let attempt = 1; attempt <= maxRetries; attempt++) {
-        try {
-            console.log(`${logPrefix} Pushing to ${remote}/${branch} (attempt ${attempt}/${maxRetries})...`);
-            await mainGit.push(remote, branch);
-            console.log(`${logPrefix} ✅ Pushed to ${remote}/${branch}`);
-            return;
+    // WU-1418: Save original LUMENFLOW_WU_TOOL value
+    const originalWuTool = process.env[LUMENFLOW_WU_TOOL_ENV];
+    try {
+        // WU-1418: Set LUMENFLOW_WU_TOOL to allow pre-push hook to recognize this as an automated operation
+        if (operation) {
+            process.env[LUMENFLOW_WU_TOOL_ENV] = operation;
         }
-        catch (pushErr) {
-            if (attempt < maxRetries) {
-                console.log(`${logPrefix} ⚠️  Push failed (origin moved). Fetching and rebasing before retry...`);
-                // WU-1348: Do NOT reset main checkout - preserve micro-worktree isolation
-                // Instead, fetch latest remote state and rebase the temp branch
-                // Step 1: Fetch latest origin/main
-                console.log(`${logPrefix} Fetching ${remote}/${branch}...`);
-                await mainGit.fetch(remote, branch);
-                // Step 2: Rebase temp branch onto updated origin/main
-                console.log(`${logPrefix} Rebasing temp branch onto ${remote}/${branch}...`);
-                await worktreeGit.rebase(`${remote}/${branch}`);
-                // Step 3: Re-merge temp branch to local main (ff-only)
-                // This updates local main to include the rebased commits
-                console.log(`${logPrefix} Re-merging temp branch to ${branch}...`);
-                await mainGit.merge(tempBranchName, { ffOnly: true });
+        for (let attempt = 1; attempt <= maxRetries; attempt++) {
+            try {
+                console.log(`${logPrefix} Pushing to ${remote}/${branch} (attempt ${attempt}/${maxRetries})...`);
+                await mainGit.push(remote, branch);
+                console.log(`${logPrefix} ✅ Pushed to ${remote}/${branch}`);
+                return;
             }
-            else {
-                const errMsg = pushErr instanceof Error ? pushErr.message : String(pushErr);
-                throw new Error(`Push failed after ${maxRetries} attempts. ` +
-                    `Origin ${branch} may have significant traffic.\n\n` +
-                    `Suggestions:\n` +
-                    `  - Wait a few seconds and retry the operation\n` +
-                    `  - Check if another agent is rapidly pushing changes\n` +
-                    `Error: ${errMsg}`);
+            catch (pushErr) {
+                if (attempt < maxRetries) {
+                    console.log(`${logPrefix} ⚠️  Push failed (origin moved). Fetching and rebasing before retry...`);
+                    // WU-1348: Do NOT reset main checkout - preserve micro-worktree isolation
+                    // Instead, fetch latest remote state and rebase the temp branch
+                    // Step 1: Fetch latest origin/main
+                    console.log(`${logPrefix} Fetching ${remote}/${branch}...`);
+                    await mainGit.fetch(remote, branch);
+                    // Step 2: Rebase temp branch onto updated origin/main
+                    console.log(`${logPrefix} Rebasing temp branch onto ${remote}/${branch}...`);
+                    await worktreeGit.rebase(`${remote}/${branch}`);
+                    // Step 3: Re-merge temp branch to local main (ff-only)
+                    // This updates local main to include the rebased commits
+                    console.log(`${logPrefix} Re-merging temp branch to ${branch}...`);
+                    await mainGit.merge(tempBranchName, { ffOnly: true });
+                }
+                else {
+                    const errMsg = pushErr instanceof Error ? pushErr.message : String(pushErr);
+                    throw new Error(`Push failed after ${maxRetries} attempts. ` +
+                        `Origin ${branch} may have significant traffic.\n\n` +
+                        `Suggestions:\n` +
+                        `  - Wait a few seconds and retry the operation\n` +
+                        `  - Check if another agent is rapidly pushing changes\n` +
+                        `Error: ${errMsg}`);
+                }
             }
         }
     }
+    finally {
+        // WU-1418: Restore original LUMENFLOW_WU_TOOL value
+        if (originalWuTool === undefined) {
+            Reflect.deleteProperty(process.env, LUMENFLOW_WU_TOOL_ENV);
+        }
+        else {
+            process.env[LUMENFLOW_WU_TOOL_ENV] = originalWuTool;
+        }
+    }
 }
 /**
  * WU-1332: Push to origin with configurable retry using p-retry
@@ -659,56 +676,73 @@ export async function pushWithRetry(mainGit, worktreeGit, remote, branch, tempBr
  * @param {PushRetryConfig} config - Push retry configuration
  * @throws {Error} If push fails after all retries or if retry is disabled
  */
-export async function pushWithRetryConfig(mainGit, worktreeGit, remote, branch, tempBranchName, logPrefix = DEFAULT_LOG_PREFIX, config = DEFAULT_PUSH_RETRY_CONFIG) {
-    // If retry is disabled, just try once and throw on failure
-    if (!config.enabled) {
-        console.log(`${logPrefix} Pushing to ${remote}/${branch} (retry disabled)...`);
-        await mainGit.push(remote, branch);
-        console.log(`${logPrefix} ✅ Pushed to ${remote}/${branch}`);
-        return;
-    }
-    let attemptNumber = 0;
-    await pRetry(async () => {
-        attemptNumber++;
-        console.log(`${logPrefix} Pushing to ${remote}/${branch} (attempt ${attemptNumber}/${config.retries})...`);
-        try {
+export async function pushWithRetryConfig(mainGit, worktreeGit, remote, branch, tempBranchName, logPrefix = DEFAULT_LOG_PREFIX, config = DEFAULT_PUSH_RETRY_CONFIG, operation) {
+    // WU-1418: Save original LUMENFLOW_WU_TOOL value
+    const originalWuTool = process.env[LUMENFLOW_WU_TOOL_ENV];
+    try {
+        // WU-1418: Set LUMENFLOW_WU_TOOL to allow pre-push hook to recognize this as an automated operation
+        if (operation) {
+            process.env[LUMENFLOW_WU_TOOL_ENV] = operation;
+        }
+        // If retry is disabled, just try once and throw on failure
+        if (!config.enabled) {
+            console.log(`${logPrefix} Pushing to ${remote}/${branch} (retry disabled)...`);
             await mainGit.push(remote, branch);
             console.log(`${logPrefix} ✅ Pushed to ${remote}/${branch}`);
+            return;
         }
-        catch (pushErr) {
-            console.log(`${logPrefix} ⚠️  Push failed (origin moved). Fetching and rebasing before retry...`);
-            // WU-1348: Do NOT reset main checkout - preserve micro-worktree isolation
-            // Instead, fetch latest remote state and rebase the temp branch
-            // Fetch latest origin/main
-            console.log(`${logPrefix} Fetching ${remote}/${branch}...`);
-            await mainGit.fetch(remote, branch);
-            // Rebase temp branch onto updated origin/main
-            console.log(`${logPrefix} Rebasing temp branch onto ${remote}/${branch}...`);
-            await worktreeGit.rebase(`${remote}/${branch}`);
-            // Re-merge temp branch to local main (ff-only)
-            // This updates local main to include the rebased commits
-            console.log(`${logPrefix} Re-merging temp branch to ${branch}...`);
-            await mainGit.merge(tempBranchName, { ffOnly: true });
-            // Re-throw to trigger p-retry
-            throw pushErr;
+        let attemptNumber = 0;
+        await pRetry(async () => {
+            attemptNumber++;
+            console.log(`${logPrefix} Pushing to ${remote}/${branch} (attempt ${attemptNumber}/${config.retries})...`);
+            try {
+                await mainGit.push(remote, branch);
+                console.log(`${logPrefix} ✅ Pushed to ${remote}/${branch}`);
+            }
+            catch (pushErr) {
+                console.log(`${logPrefix} ⚠️  Push failed (origin moved). Fetching and rebasing before retry...`);
+                // WU-1348: Do NOT reset main checkout - preserve micro-worktree isolation
+                // Instead, fetch latest remote state and rebase the temp branch
+                // Fetch latest origin/main
+                console.log(`${logPrefix} Fetching ${remote}/${branch}...`);
+                await mainGit.fetch(remote, branch);
+                // Rebase temp branch onto updated origin/main
+                console.log(`${logPrefix} Rebasing temp branch onto ${remote}/${branch}...`);
+                await worktreeGit.rebase(`${remote}/${branch}`);
+                // Re-merge temp branch to local main (ff-only)
+                // This updates local main to include the rebased commits
+                console.log(`${logPrefix} Re-merging temp branch to ${branch}...`);
+                await mainGit.merge(tempBranchName, { ffOnly: true });
+                // Re-throw to trigger p-retry
+                throw pushErr;
+            }
+        }, {
+            retries: config.retries - 1, // p-retry counts retries after first attempt
+            minTimeout: config.min_delay_ms,
+            maxTimeout: config.max_delay_ms,
+            randomize: config.jitter,
+            onFailedAttempt: () => {
+                // Logging is handled in the try/catch above
+            },
+        }).catch(() => {
+            // p-retry exhausted all retries, throw descriptive error
+            throw new Error(`Push failed after ${config.retries} attempts. ` +
+                `Origin ${branch} may have significant traffic.\n\n` +
+                `Suggestions:\n` +
+                `  - Wait a few seconds and retry the operation\n` +
+                `  - Increase git.push_retry.retries in .lumenflow.config.yaml\n` +
+                `  - Check if another agent is rapidly pushing changes`);
+        });
+    }
+    finally {
+        // WU-1418: Restore original LUMENFLOW_WU_TOOL value
+        if (originalWuTool === undefined) {
+            Reflect.deleteProperty(process.env, LUMENFLOW_WU_TOOL_ENV);
         }
-    }, {
-        retries: config.retries - 1, // p-retry counts retries after first attempt
-        minTimeout: config.min_delay_ms,
-        maxTimeout: config.max_delay_ms,
-        randomize: config.jitter,
-        onFailedAttempt: () => {
-            // Logging is handled in the try/catch above
-        },
-    }).catch(() => {
-        // p-retry exhausted all retries, throw descriptive error
-        throw new Error(`Push failed after ${config.retries} attempts. ` +
-            `Origin ${branch} may have significant traffic.\n\n` +
-            `Suggestions:\n` +
-            `  - Wait a few seconds and retry the operation\n` +
-            `  - Increase git.push_retry.retries in .lumenflow.config.yaml\n` +
-            `  - Check if another agent is rapidly pushing changes`);
-    });
+        else {
+            process.env[LUMENFLOW_WU_TOOL_ENV] = originalWuTool;
+        }
+    }
 }
 /**
  * Push using refspec with LUMENFLOW_FORCE to bypass pre-push hooks
@@ -921,7 +955,8 @@ export async function withMicroWorktree(options) {
             await mergeWithRetry(tempBranchName, microWorktreePath, logPrefix);
             // WU-1179: Use pushWithRetry to handle race conditions
             // On push failure, rollback local main and retry with rebase
-            await pushWithRetry(mainGit, gitWorktree, REMOTES.ORIGIN, BRANCHES.MAIN, tempBranchName, logPrefix);
+            // WU-1418: Pass operation name to set LUMENFLOW_WU_TOOL for pre-push hook bypass
+            await pushWithRetry(mainGit, gitWorktree, REMOTES.ORIGIN, BRANCHES.MAIN, tempBranchName, logPrefix, operation);
             return { ...result, ref: BRANCHES.MAIN };
         }
     }

package/dist/orchestration-rules.js

@@ -127,7 +127,7 @@ const AGENT_TRIGGER_DESCRIPTIONS = {
 // No mandatory agent triggers for LumenFlow framework development.
 // Example for application-specific triggers:
 // 'security-auditor': 'supabase/migrations/**, auth/**, rls/**',
-// 'beacon-guardian': 'prompts/**, llm/**',
+// 'llm-reviewer': 'prompts/**, llm/**',
 };
 /**
  * WU-1542: Build a formatted error message for mandatory agent enforcement failures.