@lumenflow/core 1.3.3 → 1.3.5

package/dist/adapters/filesystem-metrics.adapter.d.ts

@@ -5,7 +5,7 @@
  * Implements MetricsCollector port by reading from filesystem:
  * - WU YAML files (docs/04-operations/tasks/wu/)
  * - status.md (active/blocked WUs)
- * - telemetry files (.beacon/telemetry/)
+ * - telemetry files (.lumenflow/telemetry/)
  *
  * Library-First Approach:
  * - fast-glob: File discovery

package/dist/adapters/filesystem-metrics.adapter.js

@@ -5,7 +5,7 @@
  * Implements MetricsCollector port by reading from filesystem:
  * - WU YAML files (docs/04-operations/tasks/wu/)
  * - status.md (active/blocked WUs)
- * - telemetry files (.beacon/telemetry/)
+ * - telemetry files (.lumenflow/telemetry/)
  *
  * Library-First Approach:
  * - fast-glob: File discovery

package/dist/beacon-migration.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @file beacon-migration.ts
+ * @description Migration utility for renaming .beacon directories to .lumenflow (WU-1075)
+ *
+ * This module provides a one-time migration function that renames the legacy
+ * .beacon directory to .lumenflow. It's safe to run multiple times - it will
+ * only migrate if .beacon exists and .lumenflow does not.
+ *
+ * @example
+ * ```typescript
+ * import { migrateBeaconToLumenflow } from '@lumenflow/core';
+ *
+ * // Run migration in project root
+ * const result = migrateBeaconToLumenflow();
+ * if (result.migrated) {
+ *   console.log('Successfully migrated .beacon/ → .lumenflow/');
+ * }
+ * ```
+ */
+/**
+ * Result of a migration attempt
+ */
+export interface MigrationResult {
+    /** Whether migration was performed */
+    migrated: boolean;
+    /** Reason for the result */
+    reason: 'migrated' | 'already_migrated' | 'no_legacy_dir' | 'both_exist';
+    /** Path that was migrated from (if migrated) */
+    fromPath?: string;
+    /** Path that was migrated to (if migrated) */
+    toPath?: string;
+    /** Error message if migration failed */
+    error?: string;
+}
+/**
+ * Migrate .beacon directory to .lumenflow
+ *
+ * This function safely renames the legacy .beacon directory to .lumenflow.
+ * It handles the following scenarios:
+ *
+ * - .beacon exists, .lumenflow does not → Migrate (rename)
+ * - .beacon does not exist, .lumenflow exists → Already migrated (no-op)
+ * - Neither exists → No legacy directory (no-op)
+ * - Both exist → Conflict, manual resolution needed
+ *
+ * @param {string} [baseDir=process.cwd()] - Base directory to check for migration
+ * @returns {MigrationResult} Result of the migration attempt
+ */
+export declare function migrateBeaconToLumenflow(baseDir?: string): MigrationResult;
+/**
+ * Check if migration is needed without performing it
+ *
+ * @param {string} [baseDir=process.cwd()] - Base directory to check
+ * @returns {boolean} True if .beacon exists and .lumenflow does not
+ */
+export declare function needsMigration(baseDir?: string): boolean;

package/dist/beacon-migration.js

@@ -0,0 +1,101 @@
+/**
+ * @file beacon-migration.ts
+ * @description Migration utility for renaming .beacon directories to .lumenflow (WU-1075)
+ *
+ * This module provides a one-time migration function that renames the legacy
+ * .beacon directory to .lumenflow. It's safe to run multiple times - it will
+ * only migrate if .beacon exists and .lumenflow does not.
+ *
+ * @example
+ * ```typescript
+ * import { migrateBeaconToLumenflow } from '@lumenflow/core';
+ *
+ * // Run migration in project root
+ * const result = migrateBeaconToLumenflow();
+ * if (result.migrated) {
+ *   console.log('Successfully migrated .beacon/ → .lumenflow/');
+ * }
+ * ```
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { LUMENFLOW_PATHS } from './wu-constants.js';
+/** Legacy directory name that was used before v1.5.0 */
+const LEGACY_BEACON_DIR = '.beacon';
+/**
+ * Migrate .beacon directory to .lumenflow
+ *
+ * This function safely renames the legacy .beacon directory to .lumenflow.
+ * It handles the following scenarios:
+ *
+ * - .beacon exists, .lumenflow does not → Migrate (rename)
+ * - .beacon does not exist, .lumenflow exists → Already migrated (no-op)
+ * - Neither exists → No legacy directory (no-op)
+ * - Both exist → Conflict, manual resolution needed
+ *
+ * @param {string} [baseDir=process.cwd()] - Base directory to check for migration
+ * @returns {MigrationResult} Result of the migration attempt
+ */
+export function migrateBeaconToLumenflow(baseDir = process.cwd()) {
+    const legacyPath = path.join(baseDir, LEGACY_BEACON_DIR);
+    const newPath = path.join(baseDir, LUMENFLOW_PATHS.BASE);
+    const legacyExists = fs.existsSync(legacyPath);
+    const newExists = fs.existsSync(newPath);
+    // Both exist - conflict
+    if (legacyExists && newExists) {
+        return {
+            migrated: false,
+            reason: 'both_exist',
+            fromPath: legacyPath,
+            toPath: newPath,
+            error: 'Both .beacon and .lumenflow directories exist. ' +
+                'Please manually resolve by removing or merging .beacon into .lumenflow.',
+        };
+    }
+    // Already migrated
+    if (!legacyExists && newExists) {
+        return {
+            migrated: false,
+            reason: 'already_migrated',
+            toPath: newPath,
+        };
+    }
+    // No legacy directory
+    if (!legacyExists && !newExists) {
+        return {
+            migrated: false,
+            reason: 'no_legacy_dir',
+        };
+    }
+    // Migrate: rename .beacon → .lumenflow
+    try {
+        fs.renameSync(legacyPath, newPath);
+        return {
+            migrated: true,
+            reason: 'migrated',
+            fromPath: legacyPath,
+            toPath: newPath,
+        };
+    }
+    catch (err) {
+        const error = err instanceof Error ? err.message : String(err);
+        return {
+            migrated: false,
+            reason: 'migrated',
+            fromPath: legacyPath,
+            toPath: newPath,
+            error: `Failed to rename: ${error}`,
+        };
+    }
+}
+/**
+ * Check if migration is needed without performing it
+ *
+ * @param {string} [baseDir=process.cwd()] - Base directory to check
+ * @returns {boolean} True if .beacon exists and .lumenflow does not
+ */
+export function needsMigration(baseDir = process.cwd()) {
+    const legacyPath = path.join(baseDir, LEGACY_BEACON_DIR);
+    const newPath = path.join(baseDir, LUMENFLOW_PATHS.BASE);
+    return fs.existsSync(legacyPath) && !fs.existsSync(newPath);
+}

package/dist/cleanup-lock.js

@@ -22,7 +22,7 @@
 import { existsSync, readFileSync, writeFileSync, unlinkSync, mkdirSync, openSync, closeSync, } 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';
 import { createError, ErrorCodes } from './error-handler.js';
 /**
  * Default timeout for waiting to acquire lock (ms)
@@ -35,7 +35,7 @@ export const CLEANUP_LOCK_TIMEOUT_MS = 30000; // 30 seconds
  * Cleanup is slower than merge, so longer timeout
  */
 export const CLEANUP_LOCK_STALE_MS = 5 * 60 * 1000; // 5 minutes
-/** Lock file name within .beacon directory */
+/** Lock file name within .lumenflow directory */
 const LOCK_FILE_NAME = 'cleanup.lock';
 /**
  * Polling interval for lock acquisition retries
@@ -49,7 +49,7 @@ const LOCK_POLL_INTERVAL_MS = 500;
  */
 function getLockPath(options = {}) {
     const baseDir = options.baseDir || process.cwd();
-    return path.join(baseDir, '.beacon', LOCK_FILE_NAME);
+    return path.join(baseDir, LUMENFLOW_PATHS.BASE, LOCK_FILE_NAME);
 }
 /**
  * Read lock file contents

package/dist/commands-logger.d.ts

@@ -3,7 +3,7 @@
  * Part of WU-630: Detective layer (Layer 3 of 4-layer defense)
  * Part of WU-1552: Complete logging integration with user/outcome tracking
  *
- * Logs all git commands to .beacon/commands.log for post-execution analysis.
+ * Logs all git commands to .lumenflow/commands.log for post-execution analysis.
  * Provides defense-in-depth even if git shim is bypassed.
  *
  * Log format (v2): timestamp | command | branch | worktree | user | outcome
@@ -43,7 +43,7 @@ export interface LogGitCommandOptions {
 /**
  * Log a git command to the commands log
  * @param {string[]} args - Git command arguments (e.g., ['status'], ['add', '.'])
- * @param {string} logPath - Path to log file (defaults to .beacon/commands.log)
+ * @param {string} logPath - Path to log file (defaults to .lumenflow/commands.log)
  * @param {LogGitCommandOptions} options - Additional logging options (WU-1552)
  */
 export declare function logGitCommand(args: any, logPath?: string, options?: LogGitCommandOptions): void;

package/dist/commands-logger.js

@@ -3,7 +3,7 @@
  * Part of WU-630: Detective layer (Layer 3 of 4-layer defense)
  * Part of WU-1552: Complete logging integration with user/outcome tracking
  *
- * Logs all git commands to .beacon/commands.log for post-execution analysis.
+ * Logs all git commands to .lumenflow/commands.log for post-execution analysis.
  * Provides defense-in-depth even if git shim is bypassed.
  *
  * Log format (v2): timestamp | command | branch | worktree | user | outcome
@@ -17,11 +17,11 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { getCurrentBranch, isMainWorktree } from './wu-helpers.js';
-import { BEACON_PATHS, GIT_FLAGS, STRING_LITERALS } from './wu-constants.js';
+import { GIT_FLAGS, STRING_LITERALS, LUMENFLOW_PATHS } from './wu-constants.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 // Default log path (can be overridden for testing)
-const DEFAULT_LOG_PATH = path.resolve(__dirname, '../..', BEACON_PATHS.COMMANDS_LOG);
+const DEFAULT_LOG_PATH = path.resolve(__dirname, '../..', LUMENFLOW_PATHS.COMMANDS_LOG);
 // Banned patterns (same as git shim)
 const BANNED_PATTERNS = [
     { command: 'reset', flags: [GIT_FLAGS.HARD] },
@@ -53,7 +53,7 @@ export const COMMAND_LOG = {
 /**
  * Log a git command to the commands log
  * @param {string[]} args - Git command arguments (e.g., ['status'], ['add', '.'])
- * @param {string} logPath - Path to log file (defaults to .beacon/commands.log)
+ * @param {string} logPath - Path to log file (defaults to .lumenflow/commands.log)
  * @param {LogGitCommandOptions} options - Additional logging options (WU-1552)
  */
 export function logGitCommand(args, logPath = DEFAULT_LOG_PATH, options = {}) {
@@ -75,7 +75,7 @@ export function logGitCommand(args, logPath = DEFAULT_LOG_PATH, options = {}) {
         const outcome = options.outcome || COMMAND_LOG.OUTCOME.ALLOWED;
         // New format (v2): timestamp | command | branch | worktree | user | outcome
         const logEntry = `${timestamp} | ${command} | ${branch} | ${worktree} | ${user} | ${outcome}\n`;
-        // Ensure .beacon directory exists
+        // Ensure .lumenflow directory exists
         const logDir = path.dirname(logPath);
         if (!fs.existsSync(logDir)) {
             fs.mkdirSync(logDir, { recursive: true });

package/dist/core/tool-runner.d.ts

@@ -6,7 +6,7 @@
  * - Input validation via Zod schemas (tool.schemas.ts)
  * - Worktree context detection (worktree-guard.mjs)
  * - Scope validation against code_paths (scope-checker.mjs)
- * - Audit logging for telemetry (.beacon/telemetry/tools.ndjson)
+ * - Audit logging for telemetry (.lumenflow/telemetry/tools.ndjson)
  * - Consistent error handling with agent-friendly messages
  *
  * Usage:

package/dist/core/tool-runner.js

@@ -6,7 +6,7 @@
  * - Input validation via Zod schemas (tool.schemas.ts)
  * - Worktree context detection (worktree-guard.mjs)
  * - Scope validation against code_paths (scope-checker.mjs)
- * - Audit logging for telemetry (.beacon/telemetry/tools.ndjson)
+ * - Audit logging for telemetry (.lumenflow/telemetry/tools.ndjson)
  * - Consistent error handling with agent-friendly messages
  *
  * Usage:
@@ -97,7 +97,7 @@ function createAuditLogger() {
     return (entry) => {
         // Write to NDJSON telemetry file
         // Implementation deferred - currently no-op for testing
-        // Will integrate with .beacon/telemetry/tools.ndjson in future WU
+        // Will integrate with .lumenflow/telemetry/tools.ndjson in future WU
         void entry;
     };
 }

package/dist/docs-path-validator.d.ts

@@ -11,8 +11,8 @@
  * - ai/**
  * - .claude/**
  * - *.md (markdown files anywhere)
- * - .beacon/stamps/**
- * - .beacon/state/wu-events.jsonl (tooling-managed metadata)
+ * - .lumenflow/stamps/**
+ * - .lumenflow/state/wu-events.jsonl (tooling-managed metadata)
  *
  * Forbidden paths:
  * - apps/**

package/dist/docs-path-validator.js

@@ -11,8 +11,8 @@
  * - ai/**
  * - .claude/**
  * - *.md (markdown files anywhere)
- * - .beacon/stamps/**
- * - .beacon/state/wu-events.jsonl (tooling-managed metadata)
+ * - .lumenflow/stamps/**
+ * - .lumenflow/state/wu-events.jsonl (tooling-managed metadata)
  *
  * Forbidden paths:
  * - apps/**
@@ -88,8 +88,8 @@ export function getAllowedPathsDescription() {
   - .claude/** (agent configuration and skills)
   - docs/** (technical documentation)
   - *.md (markdown files)
-  - .beacon/stamps/** (completion stamps)
-  - .beacon/state/${WU_EVENTS_FILE_NAME} (WU lifecycle event log)
+  - .lumenflow/stamps/** (completion stamps)
+  - .lumenflow/state/${WU_EVENTS_FILE_NAME} (WU lifecycle event log)
   - tools/__tests__/** (test files only)
   - packages/**/__tests__/** (test files only)`;
 }

package/dist/domain/orchestration.constants.js

@@ -91,7 +91,7 @@ export const FILESYSTEM_PATHS = {
     WU_DIR: 'docs/04-operations/tasks/wu',
     STATUS_FILE: 'docs/04-operations/tasks/status.md',
     BACKLOG_FILE: 'docs/04-operations/tasks/backlog.md',
-    TELEMETRY_DIR: '.beacon/telemetry',
-    STAMPS_DIR: '.beacon/stamps',
-    SESSION_FILE: '.beacon/sessions/current.json',
+    TELEMETRY_DIR: '.lumenflow/telemetry',
+    STAMPS_DIR: '.lumenflow/stamps',
+    SESSION_FILE: '.lumenflow/sessions/current.json',
 };

package/dist/force-bypass-audit.d.ts

@@ -2,12 +2,12 @@
  * WU-1070: Force Bypass Audit Logging
  *
  * Provides audit logging for LUMENFLOW_FORCE bypass usage.
- * All hooks log bypass events to .beacon/force-bypasses.log for accountability.
+ * All hooks log bypass events to .lumenflow/force-bypasses.log for accountability.
  *
  * Key principles:
  * - FAIL-OPEN: Audit logging must never block the bypass itself
  * - WARN ON MISSING REASON: stderr warning if LUMENFLOW_FORCE_REASON not set
- * - GIT-TRACKED: .beacon/force-bypasses.log is version controlled
+ * - GIT-TRACKED: .lumenflow/force-bypasses.log is version controlled
  *
  * Log format:
  *   ISO_TIMESTAMP | HOOK_NAME | GIT_USER | BRANCH | REASON | CWD

package/dist/force-bypass-audit.js

@@ -2,12 +2,12 @@
  * WU-1070: Force Bypass Audit Logging
  *
  * Provides audit logging for LUMENFLOW_FORCE bypass usage.
- * All hooks log bypass events to .beacon/force-bypasses.log for accountability.
+ * All hooks log bypass events to .lumenflow/force-bypasses.log for accountability.
  *
  * Key principles:
  * - FAIL-OPEN: Audit logging must never block the bypass itself
  * - WARN ON MISSING REASON: stderr warning if LUMENFLOW_FORCE_REASON not set
- * - GIT-TRACKED: .beacon/force-bypasses.log is version controlled
+ * - GIT-TRACKED: .lumenflow/force-bypasses.log is version controlled
  *
  * Log format:
  *   ISO_TIMESTAMP | HOOK_NAME | GIT_USER | BRANCH | REASON | CWD
@@ -18,6 +18,7 @@
 import { appendFileSync, existsSync, mkdirSync } from 'node:fs';
 import { execSync } from 'node:child_process';
 import { join } from 'node:path';
+import { LUMENFLOW_PATHS } from './wu-constants.js';
 /**
  * Environment variable names for force bypass
  */
@@ -26,7 +27,7 @@ export const FORCE_REASON_ENV_VAR = 'LUMENFLOW_FORCE_REASON';
 /**
  * Log file path relative to project root
  */
-const LOG_FILE_NAME = '.beacon/force-bypasses.log';
+const LOG_FILE_NAME = LUMENFLOW_PATHS.FORCE_BYPASSES;
 /**
  * Check if LUMENFLOW_FORCE bypass is active
  *
@@ -102,10 +103,10 @@ export function logForceBypass(hookName, projectRoot) {
     // Write to log file (fail-open)
     try {
         const logPath = getAuditLogPath(projectRoot);
-        const beaconDir = join(projectRoot, '.beacon');
-        // Ensure .beacon directory exists
-        if (!existsSync(beaconDir)) {
-            mkdirSync(beaconDir, { recursive: true });
+        const lumenflowDir = join(projectRoot, LUMENFLOW_PATHS.BASE);
+        // Ensure .lumenflow directory exists
+        if (!existsSync(lumenflowDir)) {
+            mkdirSync(lumenflowDir, { recursive: true });
         }
         appendFileSync(logPath, logLine);
     }

package/dist/index.d.ts

@@ -7,6 +7,7 @@ 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 { DEFAULT_DOMAIN, inferDefaultDomain, normalizeToEmail, isValidEmail, } from './user-normalizer.js';
 export * from './git-adapter.js';
 export * from './state-machine.js';
@@ -44,3 +45,4 @@ export * from './gates-config.js';
 export * from './branch-check.js';
 export * from './lumenflow-home.js';
 export * from './force-bypass-audit.js';
+export { LUMENFLOW_PATHS, BEACON_PATHS } from './wu-constants.js';

package/dist/index.js

@@ -9,6 +9,8 @@ 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';
 // User normalizer (explicit exports to avoid conflicts)
 export { DEFAULT_DOMAIN, inferDefaultDomain, normalizeToEmail, isValidEmail, } from './user-normalizer.js';
 // Git operations
@@ -67,3 +69,5 @@ export * from './branch-check.js';
 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';

package/dist/lane-lock.d.ts

@@ -9,7 +9,7 @@
  * which fails if the file already exists. This prevents the race condition where
  * parallel agents could both read status.md before either updates it.
  *
- * Lock file location: .beacon/locks/<lane-kebab>.lock
+ * Lock file location: .lumenflow/locks/<lane-kebab>.lock
  * Lock file format: JSON with wuId, timestamp, agentSession, pid
  *
  * @see WU-1603 - Race condition fix for wu:claim

package/dist/lane-lock.js

@@ -9,19 +9,18 @@
  * which fails if the file already exists. This prevents the race condition where
  * parallel agents could both read status.md before either updates it.
  *
- * Lock file location: .beacon/locks/<lane-kebab>.lock
+ * Lock file location: .lumenflow/locks/<lane-kebab>.lock
  * Lock file format: JSON with wuId, timestamp, agentSession, pid
  *
  * @see WU-1603 - Race condition fix for wu:claim
  */
 import { openSync, closeSync, writeFileSync, readFileSync, unlinkSync, existsSync, mkdirSync, } from 'node:fs';
 import path from 'node:path';
-import { toKebab } from './wu-constants.js';
-import { getProjectRoot } from './wu-constants.js';
+import { toKebab, LUMENFLOW_PATHS, getProjectRoot } from './wu-constants.js';
 /** Log prefix for lane-lock messages */
 const LOG_PREFIX = '[lane-lock]';
 /** Directory for lock files relative to project root */
-const LOCKS_DIR = '.beacon/locks';
+const LOCKS_DIR = LUMENFLOW_PATHS.LOCKS_DIR;
 /** Default stale lock threshold in hours (WU-1949: reduced from 24h to 2h) */
 const DEFAULT_STALE_LOCK_THRESHOLD_HOURS = 2;
 /**

package/dist/logs-lib.d.ts

@@ -4,8 +4,8 @@
  * Core library for unified log aggregation following Anthropic's agent logging patterns.
  * Aggregates logs from multiple sources:
  * - .logs/web.log (structured JSON from Next.js)
- * - .beacon/commands.log (git command audit trail)
- * - .beacon/flow.log (WU flow events)
+ * - .lumenflow/commands.log (git command audit trail)
+ * - .lumenflow/flow.log (WU flow events)
  * - .logs/tool-audit.ndjson (Claude Code tool usage audit)
  *
  * LIBRARY-FIRST: No general-purpose library exists for project-specific log

package/dist/logs-lib.js

@@ -4,8 +4,8 @@
  * Core library for unified log aggregation following Anthropic's agent logging patterns.
  * Aggregates logs from multiple sources:
  * - .logs/web.log (structured JSON from Next.js)
- * - .beacon/commands.log (git command audit trail)
- * - .beacon/flow.log (WU flow events)
+ * - .lumenflow/commands.log (git command audit trail)
+ * - .lumenflow/flow.log (WU flow events)
  * - .logs/tool-audit.ndjson (Claude Code tool usage audit)
  *
  * LIBRARY-FIRST: No general-purpose library exists for project-specific log
@@ -16,10 +16,11 @@
  */
 import { existsSync, readFileSync } from 'node:fs';
 import path from 'node:path';
+import { LUMENFLOW_PATHS } from './wu-constants.js';
 export const LOG_SOURCES = [
     { path: '.logs/web.log', source: 'web.log' },
-    { path: '.beacon/commands.log', source: 'commands.log' },
-    { path: '.beacon/flow.log', source: 'flow.log' },
+    { path: LUMENFLOW_PATHS.COMMANDS_LOG, source: 'commands.log' },
+    { path: LUMENFLOW_PATHS.FLOW_LOG, source: 'flow.log' },
     { path: '.logs/tool-audit.ndjson', source: 'tool-audit.ndjson' },
 ];
 /**

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

@@ -27,7 +27,7 @@ export declare const DirectoriesSchema: z.ZodObject<{
     agentsDir: z.ZodDefault<z.ZodString>;
 }, z.core.$strip>;
 /**
- * Beacon paths configuration (.beacon directory structure)
+ * Beacon paths configuration (.lumenflow directory structure)
  */
 export declare const BeaconPathsSchema: z.ZodObject<{
     base: z.ZodDefault<z.ZodString>;

package/dist/lumenflow-config-schema.js

@@ -43,27 +43,27 @@ export const DirectoriesSchema = z.object({
     agentsDir: z.string().default('.claude/agents'),
 });
 /**
- * Beacon paths configuration (.beacon directory structure)
+ * Beacon paths configuration (.lumenflow directory structure)
  */
 export const BeaconPathsSchema = z.object({
-    /** Base beacon directory (default: '.beacon') */
-    base: z.string().default('.beacon'),
-    /** State directory (default: '.beacon/state') */
-    stateDir: z.string().default('.beacon/state'),
-    /** Stamps directory (default: '.beacon/stamps') */
-    stampsDir: z.string().default('.beacon/stamps'),
-    /** Merge lock file (default: '.beacon/merge.lock') */
-    mergeLock: z.string().default('.beacon/merge.lock'),
-    /** Telemetry directory (default: '.beacon/telemetry') */
-    telemetry: z.string().default('.beacon/telemetry'),
-    /** Flow log file (default: '.beacon/flow.log') */
-    flowLog: z.string().default('.beacon/flow.log'),
-    /** Sessions directory (default: '.beacon/sessions') */
-    sessions: z.string().default('.beacon/sessions'),
-    /** Incidents directory (default: '.beacon/incidents') */
-    incidents: z.string().default('.beacon/incidents'),
-    /** Commands log file (default: '.beacon/commands.log') */
-    commandsLog: z.string().default('.beacon/commands.log'),
+    /** Base beacon directory (default: '.lumenflow') */
+    base: z.string().default('.lumenflow'),
+    /** State directory (default: '.lumenflow/state') */
+    stateDir: z.string().default('.lumenflow/state'),
+    /** Stamps directory (default: '.lumenflow/stamps') */
+    stampsDir: z.string().default('.lumenflow/stamps'),
+    /** Merge lock file (default: '.lumenflow/merge.lock') */
+    mergeLock: z.string().default('.lumenflow/merge.lock'),
+    /** Telemetry directory (default: '.lumenflow/telemetry') */
+    telemetry: z.string().default('.lumenflow/telemetry'),
+    /** Flow log file (default: '.lumenflow/flow.log') */
+    flowLog: z.string().default('.lumenflow/flow.log'),
+    /** Sessions directory (default: '.lumenflow/sessions') */
+    sessions: z.string().default('.lumenflow/sessions'),
+    /** Incidents directory (default: '.lumenflow/incidents') */
+    incidents: z.string().default('.lumenflow/incidents'),
+    /** Commands log file (default: '.lumenflow/commands.log') */
+    commandsLog: z.string().default('.lumenflow/commands.log'),
 });
 /**
  * Git configuration

package/dist/lumenflow-config.js

@@ -206,7 +206,7 @@ directories:
   # Agents directory
   agentsDir: "${defaultConfig.directories.agentsDir}"
 
-# Beacon paths (.beacon directory structure)
+# Beacon paths (.lumenflow directory structure)
 beacon:
   base: "${defaultConfig.beacon.base}"
   stampsDir: "${defaultConfig.beacon.stampsDir}"

package/dist/merge-lock.js

@@ -15,7 +15,7 @@
 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';
 import { createError, ErrorCodes } from './error-handler.js';
 /**
  * Default timeout for waiting to acquire lock (ms)
@@ -27,7 +27,7 @@ export const MERGE_LOCK_TIMEOUT_MS = 30000; // 30 seconds
  * Should be greater than expected merge operation duration
  */
 export const MERGE_LOCK_STALE_MS = 60000; // 60 seconds
-/** Lock file name within .beacon directory */
+/** Lock file name within .lumenflow directory */
 const LOCK_FILE_NAME = 'merge.lock';
 /**
  * Polling interval for lock acquisition retries
@@ -41,7 +41,7 @@ const LOCK_POLL_INTERVAL_MS = 500;
  */
 function getLockPath(options = {}) {
     const baseDir = options.baseDir || process.cwd();
-    return path.join(baseDir, '.beacon', LOCK_FILE_NAME);
+    return path.join(baseDir, LUMENFLOW_PATHS.BASE, LOCK_FILE_NAME);
 }
 /**
  * Read lock file contents
@@ -71,10 +71,10 @@ function readLockFile(options = {}) {
  */
 function writeLockFile(lockInfo, options = {}) {
     const lockPath = getLockPath(options);
-    const beaconDir = path.dirname(lockPath);
-    // Ensure .beacon directory exists
-    if (!existsSync(beaconDir)) {
-        mkdirSync(beaconDir, { recursive: true });
+    const lumenflowDir = path.dirname(lockPath);
+    // Ensure .lumenflow directory exists
+    if (!existsSync(lumenflowDir)) {
+        mkdirSync(lumenflowDir, { recursive: true });
     }
     writeFileSync(lockPath, JSON.stringify(lockInfo, null, 2));
 }

package/dist/prompt-linter.js

@@ -24,7 +24,7 @@ const ROOT_DIR = resolve(__dirname, '../..');
 // Default config path
 const DEFAULT_CONFIG_PATH = resolve(ROOT_DIR, 'config/prompts/linter.yml');
 // Telemetry cache path (for storing previous metrics)
-const METRICS_CACHE_PATH = resolve(ROOT_DIR, '.beacon/telemetry/prompt-metrics.json');
+const METRICS_CACHE_PATH = resolve(ROOT_DIR, '.lumenflow/telemetry/prompt-metrics.json');
 /**
  * Load config from YAML file with fallback to defaults
  * @param {string} configPath - Path to config file (optional)
@@ -139,8 +139,8 @@ async function log(level, event, data, output = {}) {
         event,
         ...data,
     };
-    // For CLI, write to .beacon/telemetry/prompt-lint.ndjson
-    const ndjsonPath = resolve(ROOT_DIR, '.beacon/telemetry/prompt-lint.ndjson');
+    // For CLI, write to .lumenflow/telemetry/prompt-lint.ndjson
+    const ndjsonPath = resolve(ROOT_DIR, '.lumenflow/telemetry/prompt-lint.ndjson');
     const line = `${JSON.stringify(entry)}${STRING_LITERALS.NEWLINE}`;
     try {
         const dir = dirname(ndjsonPath);

package/dist/prompt-monitor.d.ts

@@ -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