@lumenflow/core 1.3.3 → 1.3.5

package/dist/prompt-monitor.js

@@ -4,7 +4,7 @@
  * Monitors all prompts for token budget drift and hash changes.
  * Designed to run as a GitHub Actions cron job (nightly at 2 AM).
  *
- * Logs to .beacon/telemetry/prompt-nightly.ndjson and Axiom.
+ * Logs to .lumenflow/telemetry/prompt-nightly.ndjson and Axiom.
  * Alerts if:
  * - Any prompt ≥400 tokens (approaching cap)
  * - Any delta >50 tokens since yesterday
@@ -17,14 +17,14 @@ import { readFile, writeFile, mkdir, appendFile, access } from 'node:fs/promises
 import { resolve, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { glob } from 'glob';
-import { EXIT_CODES, STRING_LITERALS } from './wu-constants.js';
+import { EXIT_CODES, STRING_LITERALS, LUMENFLOW_PATHS } from './wu-constants.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const ROOT_DIR = resolve(__dirname, '../..');
 // Paths
-const YESTERDAY_METRICS_PATH = resolve(ROOT_DIR, '.beacon/telemetry/prompt-metrics-yesterday.json');
-const TODAY_METRICS_PATH = resolve(ROOT_DIR, '.beacon/telemetry/prompt-metrics.json');
-const NDJSON_LOG_PATH = resolve(ROOT_DIR, '.beacon/telemetry/prompt-nightly.ndjson');
+const YESTERDAY_METRICS_PATH = resolve(ROOT_DIR, LUMENFLOW_PATHS.TELEMETRY, 'prompt-metrics-yesterday.json');
+const TODAY_METRICS_PATH = resolve(ROOT_DIR, LUMENFLOW_PATHS.TELEMETRY, 'prompt-metrics.json');
+const NDJSON_LOG_PATH = resolve(ROOT_DIR, LUMENFLOW_PATHS.TELEMETRY, 'prompt-nightly.ndjson');
 // Alert thresholds
 const WARN_THRESHOLD = 400;
 const DELTA_THRESHOLD = 50;

package/dist/rebase-artifact-cleanup.d.ts

@@ -23,7 +23,7 @@
  * lane branch itself) should NOT be cleaned - this was the WU-1816 bug.
  *
  * Checks for:
- * 1. Stamp files (.beacon/stamps/WU-{id}.done) that exist on origin/main
+ * 1. Stamp files (.lumenflow/stamps/WU-{id}.done) that exist on origin/main
  * 2. WU YAML with status=done that also has status=done on origin/main
  *
  * @param {string} worktreePath - Path to the worktree directory

package/dist/rebase-artifact-cleanup.js

@@ -134,7 +134,7 @@ function writeMarkdownFile(filePath, frontmatter, lines) {
  * lane branch itself) should NOT be cleaned - this was the WU-1816 bug.
  *
  * Checks for:
- * 1. Stamp files (.beacon/stamps/WU-{id}.done) that exist on origin/main
+ * 1. Stamp files (.lumenflow/stamps/WU-{id}.done) that exist on origin/main
  * 2. WU YAML with status=done that also has status=done on origin/main
  *
  * @param {string} worktreePath - Path to the worktree directory

package/dist/spawn-recovery.d.ts

@@ -9,7 +9,7 @@
  * 2. Stale lock (>2h) -> auto-release, mark spawn timeout
  * 3. Active lock + no checkpoint in 1h -> mark stuck, escalate
  *
- * All recovery actions are logged to .beacon/recovery/ for audit.
+ * All recovery actions are logged to .lumenflow/recovery/ for audit.
  *
  * Library-First Note: This is project-specific spawn recovery code for
  * PatientPath's custom spawn-registry.jsonl, lane-lock, and memory-store.
@@ -60,7 +60,7 @@ export declare const NO_CHECKPOINT_THRESHOLD_MS: number;
  * }
  */
 export interface RecoverStuckSpawnOptions {
-    /** Base directory for .beacon/ */
+    /** Base directory for .lumenflow/ */
     baseDir?: string;
 }
 export declare function recoverStuckSpawn(spawnId: any, options?: RecoverStuckSpawnOptions): Promise<{

package/dist/spawn-recovery.js

@@ -9,7 +9,7 @@
  * 2. Stale lock (>2h) -> auto-release, mark spawn timeout
  * 3. Active lock + no checkpoint in 1h -> mark stuck, escalate
  *
- * All recovery actions are logged to .beacon/recovery/ for audit.
+ * All recovery actions are logged to .lumenflow/recovery/ for audit.
  *
  * Library-First Note: This is project-specific spawn recovery code for
  * PatientPath's custom spawn-registry.jsonl, lane-lock, and memory-store.
@@ -24,7 +24,7 @@ import path from 'node:path';
 import { SpawnRegistryStore } from './spawn-registry-store.js';
 import { SpawnStatus } from './spawn-registry-schema.js';
 import { isZombieLock, isLockStale, readLockMetadata, getLockFilePath, releaseLaneLock, } from './lane-lock.js';
-import { toKebab } from './wu-constants.js';
+import { toKebab, LUMENFLOW_PATHS } from './wu-constants.js';
 // Optional import from @lumenflow/memory
 let loadMemory = null;
 try {
@@ -90,10 +90,10 @@ function laneToKebab(lane) {
  * Gets the recovery directory path
  *
  * @param {string} baseDir - Base directory
- * @returns {string} Path to .beacon/recovery/
+ * @returns {string} Path to .lumenflow/recovery/
  */
 function getRecoveryDir(baseDir) {
-    return path.join(baseDir, '.beacon', RECOVERY_DIR_NAME);
+    return path.join(baseDir, LUMENFLOW_PATHS.BASE, RECOVERY_DIR_NAME);
 }
 /**
  * Creates an audit log entry
@@ -123,7 +123,7 @@ async function getLastCheckpoint(baseDir, wuId) {
     if (!loadMemory) {
         return null;
     }
-    const memoryDir = path.join(baseDir, '.beacon', 'state');
+    const memoryDir = path.join(baseDir, LUMENFLOW_PATHS.STATE_DIR);
     try {
         const memory = await loadMemory(memoryDir, wuId);
         if (!memory) {
@@ -162,7 +162,7 @@ function isCheckpointRecent(checkpointTimestamp) {
 }
 export async function recoverStuckSpawn(spawnId, options = {}) {
     const { baseDir = process.cwd() } = options;
-    const registryDir = path.join(baseDir, '.beacon', 'state');
+    const registryDir = path.join(baseDir, LUMENFLOW_PATHS.STATE_DIR);
     // Load spawn registry
     const store = new SpawnRegistryStore(registryDir);
     try {

package/dist/spawn-registry-store.d.ts

@@ -2,7 +2,7 @@
  * Spawn Registry Store (WU-1944)
  *
  * Event-sourced state store for tracking sub-agent spawns.
- * Stores events in .beacon/state/spawn-registry.jsonl (append-only, git-friendly).
+ * Stores events in .lumenflow/state/spawn-registry.jsonl (append-only, git-friendly).
  *
  * Features:
  * - Event sourcing with replay for current state
@@ -30,7 +30,7 @@ export declare class SpawnRegistryStore {
     private readonly byParent;
     private readonly byTarget;
     /**
-     * @param {string} baseDir - Directory containing .beacon/state/
+     * @param {string} baseDir - Directory containing .lumenflow/state/
      */
     constructor(baseDir: string);
     /**

package/dist/spawn-registry-store.js

@@ -2,7 +2,7 @@
  * Spawn Registry Store (WU-1944)
  *
  * Event-sourced state store for tracking sub-agent spawns.
- * Stores events in .beacon/state/spawn-registry.jsonl (append-only, git-friendly).
+ * Stores events in .lumenflow/state/spawn-registry.jsonl (append-only, git-friendly).
  *
  * Features:
  * - Event sourcing with replay for current state
@@ -32,7 +32,7 @@ export class SpawnRegistryStore {
     byParent;
     byTarget;
     /**
-     * @param {string} baseDir - Directory containing .beacon/state/
+     * @param {string} baseDir - Directory containing .lumenflow/state/
      */
     constructor(baseDir) {
         this.baseDir = baseDir;

package/dist/spawn-tree.d.ts

@@ -75,7 +75,7 @@ export declare function formatSpawnTree(tree: any): string;
  * @returns {Promise<import('./spawn-registry-schema.js').SpawnEvent[]>} Array of spawn events
  *
  * @example
- * const spawns = await getSpawnsByWU('WU-1000', '.beacon/state');
+ * const spawns = await getSpawnsByWU('WU-1000', '.lumenflow/state');
  */
 export declare function getSpawnsByWU(wuId: any, baseDir: any): Promise<any[]>;
 /**
@@ -90,7 +90,7 @@ export declare function getSpawnsByWU(wuId: any, baseDir: any): Promise<any[]>;
  * @returns {Promise<import('./spawn-registry-schema.js').SpawnEvent[]>} Array of spawn events
  *
  * @example
- * const spawns = await getSpawnsByInitiative('INIT-001', '.beacon/state', 'docs/04-operations/tasks/wu');
+ * const spawns = await getSpawnsByInitiative('INIT-001', '.lumenflow/state', 'docs/04-operations/tasks/wu');
  */
 export declare function getSpawnsByInitiative(initiativeId: any, registryDir: any, wuDir: any): Promise<{
     id: string;

package/dist/spawn-tree.js

@@ -153,7 +153,7 @@ export function formatSpawnTree(tree) {
  * @returns {Promise<import('./spawn-registry-schema.js').SpawnEvent[]>} Array of spawn events
  *
  * @example
- * const spawns = await getSpawnsByWU('WU-1000', '.beacon/state');
+ * const spawns = await getSpawnsByWU('WU-1000', '.lumenflow/state');
  */
 export async function getSpawnsByWU(wuId, baseDir) {
     const store = new SpawnRegistryStore(baseDir);
@@ -205,7 +205,7 @@ export async function getSpawnsByWU(wuId, baseDir) {
  * @returns {Promise<import('./spawn-registry-schema.js').SpawnEvent[]>} Array of spawn events
  *
  * @example
- * const spawns = await getSpawnsByInitiative('INIT-001', '.beacon/state', 'docs/04-operations/tasks/wu');
+ * const spawns = await getSpawnsByInitiative('INIT-001', '.lumenflow/state', 'docs/04-operations/tasks/wu');
  */
 export async function getSpawnsByInitiative(initiativeId, registryDir, wuDir) {
     // Get all WUs belonging to initiative

package/dist/stamp-utils.d.ts

@@ -6,7 +6,7 @@
  *
  * WU-2242: Added format validation for corrupted stamp detection
  *
- * Stamp files (.beacon/stamps/WU-{id}.done) serve as completion markers
+ * Stamp files (.lumenflow/stamps/WU-{id}.done) serve as completion markers
  * Used by wu:done, wu:recovery, and validation tools
  */
 /**

package/dist/stamp-utils.js

@@ -6,7 +6,7 @@
  *
  * WU-2242: Added format validation for corrupted stamp detection
  *
- * Stamp files (.beacon/stamps/WU-{id}.done) serve as completion markers
+ * Stamp files (.lumenflow/stamps/WU-{id}.done) serve as completion markers
  * Used by wu:done, wu:recovery, and validation tools
  */
 /* eslint-disable security/detect-non-literal-fs-filename */

package/dist/telemetry.d.ts

@@ -69,7 +69,7 @@ export declare function emitLLMClassificationComplete(data: any, logPath?: strin
  */
 export declare function emitLLMClassificationError(data: any, logPath?: string): void;
 /**
- * Emit WU flow telemetry event to .beacon/flow.log
+ * Emit WU flow telemetry event to .lumenflow/flow.log
  *
  * Used by wu-claim, wu-done, wu-unblock for workflow tracking.
  * Centralized from duplicated emitTelemetry() functions (WU-1256).

package/dist/telemetry.js

@@ -188,7 +188,7 @@ export function emitLLMClassificationError(data, logPath = LLM_CLASSIFICATION_LO
     emit(logPath, event);
 }
 /**
- * Emit WU flow telemetry event to .beacon/flow.log
+ * Emit WU flow telemetry event to .lumenflow/flow.log
  *
  * Used by wu-claim, wu-done, wu-unblock for workflow tracking.
  * Centralized from duplicated emitTelemetry() functions (WU-1256).

package/dist/wu-checkpoint.js

@@ -16,14 +16,14 @@
 import { existsSync, readFileSync, writeFileSync, unlinkSync, mkdirSync } from 'node:fs';
 import path from 'node:path';
 import crypto from 'node:crypto';
-import { LOG_PREFIX, EMOJI } from './wu-constants.js';
+import { LOG_PREFIX, EMOJI, LUMENFLOW_PATHS } from './wu-constants.js';
 /**
  * Schema version for checkpoint files
  * Increment when checkpoint format changes
  */
 export const CHECKPOINT_SCHEMA_VERSION = 1;
 /**
- * Checkpoint directory within .beacon
+ * Checkpoint directory within .lumenflow
  */
 const CHECKPOINT_DIR = 'checkpoints';
 /**
@@ -39,7 +39,7 @@ const CHECKPOINT_MAX_AGE_MS = 24 * 60 * 60 * 1000;
  */
 function getCheckpointPath(wuId, options = {}) {
     const baseDir = options.baseDir || process.cwd();
-    return path.join(baseDir, '.beacon', CHECKPOINT_DIR, `${wuId}.checkpoint.json`);
+    return path.join(baseDir, LUMENFLOW_PATHS.BASE, CHECKPOINT_DIR, `${wuId}.checkpoint.json`);
 }
 /**
  * Ensure checkpoint directory exists
@@ -48,7 +48,7 @@ function getCheckpointPath(wuId, options = {}) {
  */
 function ensureCheckpointDir(options = {}) {
     const baseDir = options.baseDir || process.cwd();
-    const checkpointDir = path.join(baseDir, '.beacon', CHECKPOINT_DIR);
+    const checkpointDir = path.join(baseDir, LUMENFLOW_PATHS.BASE, CHECKPOINT_DIR);
     if (!existsSync(checkpointDir)) {
         mkdirSync(checkpointDir, { recursive: true });
     }

package/dist/wu-constants.d.ts

@@ -1102,7 +1102,7 @@ export declare const GIT_COMMAND_STRINGS: {
 export declare const PATH_PATTERNS: {
     /** Matches WU YAML paths in both legacy and current locations */
     WU_YAML: RegExp;
-    /** Matches stamp file paths */
+    /** Matches stamp file paths (supports both .beacon and .lumenflow for migration) */
     STAMP: RegExp;
 };
 /**
@@ -1208,12 +1208,57 @@ export declare const ERROR_CODES: {
     ETIMEDOUT: string;
 };
 /**
- * Beacon directory paths
+ * LumenFlow directory paths
  *
- * Centralized paths for .beacon directory structure to eliminate hardcoded strings.
- * Used by telemetry, agent-session, agent-incidents, and commands-logger modules.
+ * Centralized paths for .lumenflow directory structure to eliminate hardcoded strings.
+ * Used by telemetry, agent-session, agent-incidents, memory, and commands-logger modules.
+ *
+ * @since 1.4.0 Renamed from BEACON_PATHS (WU-1075)
+ */
+export declare const LUMENFLOW_PATHS: {
+    /** Base directory for all LumenFlow runtime data */
+    BASE: string;
+    /** WU state store directory */
+    STATE_DIR: string;
+    /** Stamp directory (WU completion markers) */
+    STAMPS_DIR: string;
+    /** Merge lock file (runtime coordination, WU-1747) */
+    MERGE_LOCK: string;
+    /** Base telemetry directory */
+    TELEMETRY: string;
+    /** Flow log file (WU flow events) */
+    FLOW_LOG: string;
+    /** Agent sessions directory */
+    SESSIONS: string;
+    /** Agent incidents directory */
+    INCIDENTS: string;
+    /** Git commands log file */
+    COMMANDS_LOG: string;
+    /** Memory layer directory */
+    MEMORY_DIR: string;
+    /** Memory layer JSONL file */
+    MEMORY_JSONL: string;
+    /** Audit log for tool calls */
+    AUDIT_LOG: string;
+    /** Feedback drafts directory */
+    FEEDBACK_DRAFTS: string;
+    /** Feedback index file */
+    FEEDBACK_INDEX: string;
+    /** Current session file */
+    SESSION_CURRENT: string;
+    /** WU events log */
+    WU_EVENTS: string;
+    /** Lock files directory */
+    LOCKS_DIR: string;
+    /** Force bypass audit log */
+    FORCE_BYPASSES: string;
+};
+/**
+ * @deprecated Use LUMENFLOW_PATHS instead. Will be removed in v2.0.
  */
 export declare const BEACON_PATHS: {
+    /** Base directory for all LumenFlow runtime data */
+    BASE: string;
     /** WU state store directory */
     STATE_DIR: string;
     /** Stamp directory (WU completion markers) */
@@ -1230,6 +1275,24 @@ export declare const BEACON_PATHS: {
     INCIDENTS: string;
     /** Git commands log file */
     COMMANDS_LOG: string;
+    /** Memory layer directory */
+    MEMORY_DIR: string;
+    /** Memory layer JSONL file */
+    MEMORY_JSONL: string;
+    /** Audit log for tool calls */
+    AUDIT_LOG: string;
+    /** Feedback drafts directory */
+    FEEDBACK_DRAFTS: string;
+    /** Feedback index file */
+    FEEDBACK_INDEX: string;
+    /** Current session file */
+    SESSION_CURRENT: string;
+    /** WU events log */
+    WU_EVENTS: string;
+    /** Lock files directory */
+    LOCKS_DIR: string;
+    /** Force bypass audit log */
+    FORCE_BYPASSES: string;
 };
 /**
  * File extensions

package/dist/wu-constants.js

@@ -1145,8 +1145,8 @@ export const GIT_COMMAND_STRINGS = {
 export const PATH_PATTERNS = {
     /** Matches WU YAML paths in both legacy and current locations */
     WU_YAML: /(?:memory-bank|docs\/04-operations)\/tasks\/wu\/(WU-\d+)\.ya?ml$/i,
-    /** Matches stamp file paths */
-    STAMP: /\.beacon\/stamps\/(WU-\d+)\.done$/i,
+    /** Matches stamp file paths (supports both .beacon and .lumenflow for migration) */
+    STAMP: /\.(?:beacon|lumenflow)\/stamps\/(WU-\d+)\.done$/i,
 };
 /**
  * Common shell commands
@@ -1251,29 +1251,55 @@ export const ERROR_CODES = {
     ETIMEDOUT: 'ETIMEDOUT',
 };
 /**
- * Beacon directory paths
+ * LumenFlow directory paths
  *
- * Centralized paths for .beacon directory structure to eliminate hardcoded strings.
- * Used by telemetry, agent-session, agent-incidents, and commands-logger modules.
+ * Centralized paths for .lumenflow directory structure to eliminate hardcoded strings.
+ * Used by telemetry, agent-session, agent-incidents, memory, and commands-logger modules.
+ *
+ * @since 1.4.0 Renamed from BEACON_PATHS (WU-1075)
  */
-export const BEACON_PATHS = {
+export const LUMENFLOW_PATHS = {
+    /** Base directory for all LumenFlow runtime data */
+    BASE: '.lumenflow',
     /** WU state store directory */
-    STATE_DIR: '.beacon/state',
+    STATE_DIR: '.lumenflow/state',
     /** Stamp directory (WU completion markers) */
-    STAMPS_DIR: '.beacon/stamps',
+    STAMPS_DIR: '.lumenflow/stamps',
     /** Merge lock file (runtime coordination, WU-1747) */
-    MERGE_LOCK: '.beacon/merge.lock',
+    MERGE_LOCK: '.lumenflow/merge.lock',
     /** Base telemetry directory */
-    TELEMETRY: '.beacon/telemetry',
+    TELEMETRY: '.lumenflow/telemetry',
     /** Flow log file (WU flow events) */
-    FLOW_LOG: '.beacon/flow.log',
+    FLOW_LOG: '.lumenflow/flow.log',
     /** Agent sessions directory */
-    SESSIONS: '.beacon/sessions',
+    SESSIONS: '.lumenflow/sessions',
     /** Agent incidents directory */
-    INCIDENTS: '.beacon/incidents',
+    INCIDENTS: '.lumenflow/incidents',
     /** Git commands log file */
-    COMMANDS_LOG: '.beacon/commands.log',
-};
+    COMMANDS_LOG: '.lumenflow/commands.log',
+    /** Memory layer directory */
+    MEMORY_DIR: '.lumenflow/memory',
+    /** Memory layer JSONL file */
+    MEMORY_JSONL: '.lumenflow/memory/memory.jsonl',
+    /** Audit log for tool calls */
+    AUDIT_LOG: '.lumenflow/telemetry/tools.ndjson',
+    /** Feedback drafts directory */
+    FEEDBACK_DRAFTS: '.lumenflow/feedback-drafts',
+    /** Feedback index file */
+    FEEDBACK_INDEX: '.lumenflow/feedback-index.ndjson',
+    /** Current session file */
+    SESSION_CURRENT: '.lumenflow/sessions/current.json',
+    /** WU events log */
+    WU_EVENTS: '.lumenflow/state/wu-events.jsonl',
+    /** Lock files directory */
+    LOCKS_DIR: '.lumenflow/locks',
+    /** Force bypass audit log */
+    FORCE_BYPASSES: '.lumenflow/force-bypasses.log',
+};
+/**
+ * @deprecated Use LUMENFLOW_PATHS instead. Will be removed in v2.0.
+ */
+export const BEACON_PATHS = LUMENFLOW_PATHS;
 /**
  * File extensions
  *

package/dist/wu-done-branch-only.js

@@ -17,7 +17,7 @@ import path from 'node:path';
 import { defaultBranchFrom, branchExists, generateCommitMessage, updateMetadataFiles, stageAndFormatMetadata, } from './wu-done-validators.js';
 import { getGitForCwd } from './git-adapter.js';
 import { readWU } from './wu-yaml.js';
-import { BRANCHES, REMOTES, LOG_PREFIX, EMOJI, STRING_LITERALS } from './wu-constants.js';
+import { BRANCHES, REMOTES, LOG_PREFIX, EMOJI, STRING_LITERALS, LUMENFLOW_PATHS, } from './wu-constants.js';
 import { RECOVERY } from './wu-done-messages.js';
 import { die, createError, ErrorCodes } from './error-handler.js';
 import { validateWU, validateDoneWU } from './wu-schema.js';
@@ -78,7 +78,7 @@ export async function executeBranchOnlyCompletion(context) {
     const metadataWUPath = path.join(metadataBasePath, 'docs', '04-operations', 'tasks', 'wu', `${id}.yaml`);
     const metadataStatusPath = path.join(metadataBasePath, 'docs', '04-operations', 'tasks', 'status.md');
     const metadataBacklogPath = path.join(metadataBasePath, 'docs', '04-operations', 'tasks', 'backlog.md');
-    const metadataStampsDir = path.join(metadataBasePath, '.beacon', 'stamps');
+    const metadataStampsDir = path.join(metadataBasePath, LUMENFLOW_PATHS.STAMPS_DIR);
     const metadataStampPath = path.join(metadataStampsDir, `${id}.done`);
     // Step 3: Read WU YAML and validate current state
     const docForUpdate = readWU(metadataWUPath, id);

package/dist/wu-done-inputs.js

@@ -36,7 +36,7 @@ export function validateInputs(argv) {
             '    • A separate WU exists to fix those failures (specify with --fix-wu)\n' +
             '    • Your WU work is genuinely complete\n\n' +
             '  NEVER use --skip-gates for failures introduced by your WU!\n' +
-            '  All skip-gates events are logged to .beacon/skip-gates-audit.log\n\n' +
+            '  All skip-gates events are logged to .lumenflow/skip-gates-audit.log\n\n' +
             '📝 WU VALIDATOR:\n' +
             '  Automatically scans code_paths for:\n' +
             '    • TODO/FIXME/HACK/XXX comments (fails validation unless --allow-todo)\n' +

package/dist/wu-done-validation.js

@@ -260,7 +260,7 @@ const DOCS_ONLY_ALLOWED_PATTERNS = [
     /^memory-bank\//i,
     /^docs\//i,
     /\.md$/i,
-    /^\.beacon\/stamps\//i,
+    /^\.(?:beacon|lumenflow)\/stamps\//i, // Support both legacy .beacon and .lumenflow
     /^\.claude\//i,
     /^ai\//i,
     /^README\.md$/i,
@@ -332,7 +332,7 @@ Allowed paths for documentation WUs:
   - ai/
   - .claude/
   - memory-bank/
-  - .beacon/stamps/
+  - .lumenflow/stamps/ (or legacy .beacon/stamps/)
   - *.md files
 
 After fixing, retry: pnpm wu:done --id ${id}

package/dist/wu-done-worktree.js

@@ -115,7 +115,7 @@ export async function executeWorktreeCompletion(context) {
             console.log(`${BOX.SIDE}  4. Return to main and retry wu:done`);
             console.log(BOX.SIDE);
             console.log(`${BOX.SIDE}  Or reset the recovery counter:`);
-            console.log(`${BOX.SIDE}  rm .beacon/recovery/${id}.recovery`);
+            console.log(`${BOX.SIDE}  rm .lumenflow/recovery/${id}.recovery`);
             console.log(BOX.BOT);
             throw createRecoveryError(`Recovery loop detected for ${id} after ${attemptCount} attempts. Manual intervention required.`, { wuId: id, attemptCount, maxAttempts: MAX_RECOVERY_ATTEMPTS });
         }
@@ -232,7 +232,7 @@ export async function executeWorktreeCompletion(context) {
         // WU-2310: Capture file state before transaction commit
         // This allows rollback if git commit fails AFTER files are written
         // Note: We use the relative paths since we're already chdir'd into the worktree
-        const workingEventsPath = path.join('.beacon', 'state', WU_EVENTS_FILE_NAME);
+        const workingEventsPath = path.join('.lumenflow', 'state', WU_EVENTS_FILE_NAME);
         const pathsToSnapshot = [
             workingWUPath,
             workingStatusPath,
@@ -571,12 +571,12 @@ export async function checkBranchDrift(branch) {
  */
 const APPEND_ONLY_FILES = [
     // State store events file (append-only by design)
-    path.join('.beacon', 'state', WU_EVENTS_FILE_NAME),
+    path.join('.lumenflow', 'state', WU_EVENTS_FILE_NAME),
     // Status and backlog are generated from state store but may conflict during rebase
     WU_PATHS.STATUS(),
     WU_PATHS.BACKLOG(),
 ];
-const WU_EVENTS_PATH = path.join('.beacon', 'state', WU_EVENTS_FILE_NAME);
+const WU_EVENTS_PATH = path.join('.lumenflow', 'state', WU_EVENTS_FILE_NAME);
 function normalizeEventForKey(event) {
     const normalized = {};
     for (const key of Object.keys(event).sort()) {

package/dist/wu-paths.js

@@ -19,7 +19,7 @@ const PATH_DEPTHS = {
     STATUS: 4,
     /** WU YAML files are 5 levels deep: docs/04-operations/tasks/wu/{id}.yaml */
     WU_YAML: 5,
-    /** State store is 3 levels deep: .beacon/state/wu-events.jsonl */
+    /** State store is 3 levels deep: .lumenflow/state/wu-events.jsonl */
     STATE_STORE: 3,
 };
 /**

package/dist/wu-recovery.d.ts

@@ -23,7 +23,7 @@ export declare const MAX_RECOVERY_ATTEMPTS: 4;
  * WU-1335: Get the path to the recovery marker file for a WU
  *
  * @param {string} id - WU ID
- * @param {string} [baseDir=process.cwd()] - Base directory for .beacon
+ * @param {string} [baseDir=process.cwd()] - Base directory for .lumenflow
  * @returns {string} Path to recovery marker file
  */
 export declare function getRecoveryMarkerPath(id: any, baseDir?: string): string;
@@ -31,7 +31,7 @@ export declare function getRecoveryMarkerPath(id: any, baseDir?: string): string
  * WU-1335: Get the current recovery attempt count for a WU
  *
  * @param {string} id - WU ID
- * @param {string} [baseDir=process.cwd()] - Base directory for .beacon
+ * @param {string} [baseDir=process.cwd()] - Base directory for .lumenflow
  * @returns {number} Current attempt count (0 if no marker exists)
  */
 export declare function getRecoveryAttemptCount(id: any, baseDir?: string): any;
@@ -39,7 +39,7 @@ export declare function getRecoveryAttemptCount(id: any, baseDir?: string): any;
  * WU-1335: Increment recovery attempt count for a WU
  *
  * @param {string} id - WU ID
- * @param {string} [baseDir=process.cwd()] - Base directory for .beacon
+ * @param {string} [baseDir=process.cwd()] - Base directory for .lumenflow
  * @returns {number} New attempt count
  */
 export declare function incrementRecoveryAttempt(id: any, baseDir?: string): any;
@@ -47,7 +47,7 @@ export declare function incrementRecoveryAttempt(id: any, baseDir?: string): any
  * WU-1335: Clear recovery attempts for a WU (called on successful recovery)
  *
  * @param {string} id - WU ID
- * @param {string} [baseDir=process.cwd()] - Base directory for .beacon
+ * @param {string} [baseDir=process.cwd()] - Base directory for .lumenflow
  */
 export declare function clearRecoveryAttempts(id: any, baseDir?: string): void;
 /**

package/dist/wu-recovery.js

@@ -25,7 +25,7 @@ import { moveWUToDoneBacklog } from './wu-backlog-updater.js';
 import { getGitForCwd } from './git-adapter.js';
 import { createError, ErrorCodes } from './error-handler.js';
 import { rollbackFiles } from './rollback-utils.js';
-import { LOG_PREFIX, EMOJI, WU_STATUS, getProjectRoot } from './wu-constants.js';
+import { LOG_PREFIX, EMOJI, WU_STATUS, getProjectRoot, LUMENFLOW_PATHS, } from './wu-constants.js';
 import { RETRY_PRESETS } from './retry-strategy.js';
 /**
  * WU-1335: Maximum number of recovery attempts before escalating to manual intervention
@@ -33,24 +33,24 @@ import { RETRY_PRESETS } from './retry-strategy.js';
  */
 export const MAX_RECOVERY_ATTEMPTS = RETRY_PRESETS.recovery.maxAttempts;
 /**
- * WU-1335: Recovery marker subdirectory within .beacon
+ * WU-1335: Recovery marker subdirectory within .lumenflow
  */
 const RECOVERY_MARKER_DIR = 'recovery';
 /**
  * WU-1335: Get the path to the recovery marker file for a WU
  *
  * @param {string} id - WU ID
- * @param {string} [baseDir=process.cwd()] - Base directory for .beacon
+ * @param {string} [baseDir=process.cwd()] - Base directory for .lumenflow
  * @returns {string} Path to recovery marker file
  */
 export function getRecoveryMarkerPath(id, baseDir = process.cwd()) {
-    return join(baseDir, '.beacon', RECOVERY_MARKER_DIR, `${id}.recovery`);
+    return join(baseDir, LUMENFLOW_PATHS.BASE, RECOVERY_MARKER_DIR, `${id}.recovery`);
 }
 /**
  * WU-1335: Get the current recovery attempt count for a WU
  *
  * @param {string} id - WU ID
- * @param {string} [baseDir=process.cwd()] - Base directory for .beacon
+ * @param {string} [baseDir=process.cwd()] - Base directory for .lumenflow
  * @returns {number} Current attempt count (0 if no marker exists)
  */
 export function getRecoveryAttemptCount(id, baseDir = process.cwd()) {
@@ -71,12 +71,12 @@ export function getRecoveryAttemptCount(id, baseDir = process.cwd()) {
  * WU-1335: Increment recovery attempt count for a WU
  *
  * @param {string} id - WU ID
- * @param {string} [baseDir=process.cwd()] - Base directory for .beacon
+ * @param {string} [baseDir=process.cwd()] - Base directory for .lumenflow
  * @returns {number} New attempt count
  */
 export function incrementRecoveryAttempt(id, baseDir = process.cwd()) {
     const markerPath = getRecoveryMarkerPath(id, baseDir);
-    const markerDir = join(baseDir, '.beacon', RECOVERY_MARKER_DIR);
+    const markerDir = join(baseDir, LUMENFLOW_PATHS.BASE, RECOVERY_MARKER_DIR);
     // Ensure directory exists
     if (!existsSync(markerDir)) {
         mkdirSync(markerDir, { recursive: true });
@@ -95,7 +95,7 @@ export function incrementRecoveryAttempt(id, baseDir = process.cwd()) {
  * WU-1335: Clear recovery attempts for a WU (called on successful recovery)
  *
  * @param {string} id - WU ID
- * @param {string} [baseDir=process.cwd()] - Base directory for .beacon
+ * @param {string} [baseDir=process.cwd()] - Base directory for .lumenflow
  */
 export function clearRecoveryAttempts(id, baseDir = process.cwd()) {
     const markerPath = getRecoveryMarkerPath(id, baseDir);