@lumenflow/core 1.3.4 → 1.3.6

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/state-machine.d.ts

@@ -9,6 +9,7 @@
  * - in_progress → blocked (block)
  * - in_progress → waiting (implementation complete, awaiting sign-off)
  * - in_progress → done (direct completion)
+ * - in_progress → ready (release - WU-1080: orphan recovery)
  * - blocked → in_progress (unblock)
  * - blocked → done (blocker resolved, direct completion)
  * - waiting → in_progress (changes requested)

package/dist/state-machine.js

@@ -9,6 +9,7 @@
  * - in_progress → blocked (block)
  * - in_progress → waiting (implementation complete, awaiting sign-off)
  * - in_progress → done (direct completion)
+ * - in_progress → ready (release - WU-1080: orphan recovery)
  * - blocked → in_progress (unblock)
  * - blocked → done (blocker resolved, direct completion)
  * - waiting → in_progress (changes requested)
@@ -26,7 +27,7 @@ const VALID_STATES = new Set(['ready', 'in_progress', 'blocked', 'waiting', 'don
  */
 const TRANSITIONS = {
     ready: ['in_progress'],
-    in_progress: ['blocked', 'waiting', 'done'],
+    in_progress: ['blocked', 'waiting', 'done', 'ready'], // WU-1080: 'ready' via release for orphan recovery
     blocked: ['in_progress', 'done'],
     waiting: ['in_progress', 'done'],
     done: [], // Terminal state - no outgoing transitions

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-consistency-checker.d.ts

@@ -84,14 +84,34 @@ export interface RepairWUInconsistencyOptions {
     projectRoot?: string;
 }
 /**
- * Repair WU inconsistencies
+ * Error object structure from checkWUConsistency()
+ */
+interface ConsistencyError {
+    type: string;
+    wuId: string;
+    title?: string;
+    lane?: string;
+    description?: string;
+    repairAction?: string;
+    canAutoRepair: boolean;
+}
+/**
+ * Repair WU inconsistencies using micro-worktree isolation (WU-1078)
+ *
+ * All file modifications (stamps, YAML, markdown) are made atomically
+ * in a micro-worktree, then committed and pushed to origin/main.
+ * This prevents direct writes to the main checkout.
  *
  * @param {object} report - Report from checkWUConsistency()
  * @param {RepairWUInconsistencyOptions} [options={}] - Repair options
  * @returns {Promise<object>} Result with repaired, skipped, and failed counts
  */
-export declare function repairWUInconsistency(report: any, options?: RepairWUInconsistencyOptions): Promise<{
+export declare function repairWUInconsistency(report: {
+    valid: boolean;
+    errors: ConsistencyError[];
+}, options?: RepairWUInconsistencyOptions): Promise<{
     repaired: number;
     skipped: number;
     failed: number;
 }>;
+export {};