@lumenflow/core 1.3.3 → 1.3.5

package/dist/wu-repair-core.js

@@ -21,7 +21,7 @@ import { readWU, writeWU, parseYAML, stringifyYAML } from './wu-yaml.js';
 import { WU_PATHS } from './wu-paths.js';
 import { WUStateStore, WU_EVENTS_FILE_NAME } from './wu-state-store.js';
 import { getGitForCwd, createGitForPath } from './git-adapter.js';
-import { EXIT_CODES, LOG_PREFIX, EMOJI, WU_STATUS } from './wu-constants.js';
+import { EXIT_CODES, LOG_PREFIX, EMOJI, WU_STATUS, LUMENFLOW_PATHS, } from './wu-constants.js';
 import { die } from './error-handler.js';
 import { ensureOnMain, ensureMainUpToDate, validateWUIDFormat } from './wu-helpers.js';
 import { withMicroWorktree } from './micro-worktree.js';
@@ -103,7 +103,7 @@ export async function checkClaimMetadata(id, worktreePath) {
         errors.push(`WU YAML not found at: ${wuPath}`);
     }
     // Check state store
-    const stateDir = path.join(worktreePath, '.beacon', 'state');
+    const stateDir = path.join(worktreePath, LUMENFLOW_PATHS.STATE_DIR);
     const eventsPath = path.join(stateDir, WU_EVENTS_FILE_NAME);
     if (existsSync(eventsPath)) {
         try {
@@ -174,7 +174,7 @@ export async function repairClaimMetadata(id, worktreePath, checkResult) {
     // Repair 2: Add claim event to state store if missing
     if (!checkResult.stateStoreHasClaim) {
         try {
-            const stateDir = path.join(worktreePath, '.beacon', 'state');
+            const stateDir = path.join(worktreePath, LUMENFLOW_PATHS.STATE_DIR);
             const eventsPath = path.join(stateDir, WU_EVENTS_FILE_NAME);
             // Ensure directory exists
             mkdirSync(stateDir, { recursive: true });
@@ -201,7 +201,7 @@ export async function repairClaimMetadata(id, worktreePath, checkResult) {
             const gitWorktree = createGitForPath(worktreePath);
             // Stage repaired files
             const filesToStage = [wuPath];
-            const stateDir = path.join(worktreePath, '.beacon', 'state');
+            const stateDir = path.join(worktreePath, LUMENFLOW_PATHS.STATE_DIR);
             const eventsPath = path.join(stateDir, WU_EVENTS_FILE_NAME);
             if (existsSync(eventsPath)) {
                 filesToStage.push(eventsPath);

package/dist/wu-spawn-helpers.d.ts

@@ -79,7 +79,7 @@ export declare function getHelpText(): string;
  * @param {string} options.parentWuId - Parent WU ID (orchestrator)
  * @param {string} options.targetWuId - Target WU ID (spawned work)
  * @param {string} options.lane - Lane for the spawned work
- * @param {string} [options.baseDir] - Base directory for registry (defaults to .beacon/state)
+ * @param {string} [options.baseDir] - Base directory for registry (defaults to LUMENFLOW_PATHS.STATE_DIR)
  * @returns {Promise<{success: boolean, spawnId: string|null, error?: string}>}
  *
  * @example

package/dist/wu-spawn-helpers.js

@@ -12,6 +12,7 @@
  */
 import { Command } from 'commander';
 import { SpawnRegistryStore } from './spawn-registry-store.js';
+import { LUMENFLOW_PATHS } from './wu-constants.js';
 /**
  * Option definitions for thinking mode configuration.
  *
@@ -210,7 +211,7 @@ const LOG_PREFIX = '[wu:spawn]';
  * @param {string} options.parentWuId - Parent WU ID (orchestrator)
  * @param {string} options.targetWuId - Target WU ID (spawned work)
  * @param {string} options.lane - Lane for the spawned work
- * @param {string} [options.baseDir] - Base directory for registry (defaults to .beacon/state)
+ * @param {string} [options.baseDir] - Base directory for registry (defaults to LUMENFLOW_PATHS.STATE_DIR)
  * @returns {Promise<{success: boolean, spawnId: string|null, error?: string}>}
  *
  * @example
@@ -225,7 +226,7 @@ const LOG_PREFIX = '[wu:spawn]';
  * }
  */
 export async function recordSpawnToRegistry(options) {
-    const { parentWuId, targetWuId, lane, baseDir = '.beacon/state' } = options;
+    const { parentWuId, targetWuId, lane, baseDir = LUMENFLOW_PATHS.STATE_DIR } = options;
     try {
         const store = new SpawnRegistryStore(baseDir);
         await store.load();

package/dist/wu-spawn.js

@@ -34,7 +34,7 @@ import { createWUParser, WU_OPTIONS } from './arg-parser.js';
 import { WU_PATHS } from './wu-paths.js';
 import { parseYAML } from './wu-yaml.js';
 import { die } from './error-handler.js';
-import { WU_STATUS, PATTERNS, EMOJI } from './wu-constants.js';
+import { WU_STATUS, PATTERNS, EMOJI, LUMENFLOW_PATHS } from './wu-constants.js';
 // WU-1603: Check lane lock status before spawning
 import { checkLaneLock } from './lane-lock.js';
 import { minimatch } from 'minimatch';
@@ -650,7 +650,7 @@ git rev-parse --show-toplevel
 
 ### Stamp Creation
 
-When creating \`.beacon/\` stamps or other artifacts:
+When creating \`.lumenflow/\` stamps or other artifacts:
 
 1. **ALWAYS** create stamps in the **worktree**, not main
 2. Use \`git rev-parse --show-toplevel\` to get the correct base path
@@ -659,11 +659,11 @@ When creating \`.beacon/\` stamps or other artifacts:
 \`\`\`bash
 # CORRECT: Create stamp in worktree
 WORKTREE_ROOT=$(git rev-parse --show-toplevel)
-mkdir -p "$WORKTREE_ROOT/.beacon/agent-runs"
-touch "$WORKTREE_ROOT/.beacon/agent-runs/beacon-guardian.stamp"
+mkdir -p "$WORKTREE_ROOT/.lumenflow/agent-runs"
+touch "$WORKTREE_ROOT/.lumenflow/agent-runs/beacon-guardian.stamp"
 
 # WRONG: Hardcoded path to main
-# touch /path/to/main/.beacon/agent-runs/beacon-guardian.stamp
+# touch /path/to/main/.lumenflow/agent-runs/beacon-guardian.stamp
 \`\`\`
 
 ### Why This Matters
@@ -789,7 +789,7 @@ cd worktrees/${laneSlug}-${id.toLowerCase()}
 Then implement following all standards above.
 
 **CRITICAL:** Never use \`git worktree add\` directly. Always use \`pnpm wu:claim\` to ensure:
-- Event tracking in .beacon/state/wu-events.jsonl
+- Event tracking in ${LUMENFLOW_PATHS.WU_EVENTS}
 - Lane lock acquisition (WIP=1 enforcement)
 - Session tracking for context recovery`;
 }
@@ -1229,7 +1229,7 @@ async function main() {
                 parentWuId: args.parentWu,
                 targetWuId: id,
                 lane: doc.lane || 'Unknown',
-                baseDir: '.beacon/state',
+                baseDir: LUMENFLOW_PATHS.STATE_DIR,
             });
             const registryMessage = formatSpawnRecordedMessage(registryResult.spawnId, registryResult.error);
             console.log(`\n${registryMessage}`);

package/dist/wu-state-store.d.ts

@@ -2,7 +2,7 @@
  * WU State Store (WU-1570, WU-2240)
  *
  * Event-sourced state store for WU lifecycle following INIT-007 pattern.
- * Stores events in .beacon/state/wu-events.jsonl (append-only, git-friendly).
+ * Stores events in .lumenflow/state/wu-events.jsonl (append-only, git-friendly).
  *
  * Features:
  * - Event sourcing with replay for current state
@@ -255,7 +255,7 @@ export declare function releaseLock(lockPath: string): void;
  * - Returns detailed repair statistics
  *
  * @example
- * const stateFilePath = path.join(process.cwd(), '.beacon', 'state', 'wu-events.jsonl');
+ * const stateFilePath = path.join(process.cwd(), '.lumenflow', 'state', 'wu-events.jsonl');
  * const result = await repairStateFile(stateFilePath);
  * if (result.success) {
  *   console.log(`Repaired: kept ${result.linesKept}, removed ${result.linesRemoved}`);

package/dist/wu-state-store.js

@@ -2,7 +2,7 @@
  * WU State Store (WU-1570, WU-2240)
  *
  * Event-sourced state store for WU lifecycle following INIT-007 pattern.
- * Stores events in .beacon/state/wu-events.jsonl (append-only, git-friendly).
+ * Stores events in .lumenflow/state/wu-events.jsonl (append-only, git-friendly).
  *
  * Features:
  * - Event sourcing with replay for current state
@@ -592,7 +592,7 @@ export function releaseLock(lockPath) {
  * - Returns detailed repair statistics
  *
  * @example
- * const stateFilePath = path.join(process.cwd(), '.beacon', 'state', 'wu-events.jsonl');
+ * const stateFilePath = path.join(process.cwd(), '.lumenflow', 'state', 'wu-events.jsonl');
  * const result = await repairStateFile(stateFilePath);
  * if (result.success) {
  *   console.log(`Repaired: kept ${result.linesKept}, removed ${result.linesRemoved}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/core",
-  "version": "1.3.3",
+  "version": "1.3.5",
   "description": "Core WU lifecycle tools for LumenFlow workflow framework",
   "keywords": [
     "lumenflow",
@@ -65,13 +65,6 @@
     "LICENSE",
     "README.md"
   ],
-  "scripts": {
-    "build": "tsc",
-    "build:dist": "tsc -p tsconfig.build.json",
-    "pack:dist": "pnpm pack",
-    "clean": "rm -rf dist *.tgz",
-    "test": "vitest run"
-  },
   "dependencies": {
     "change-case": "^5.4.4",
     "cli-progress": "^3.12.0",
@@ -98,8 +91,8 @@
     "vitest": "^4.0.17"
   },
   "peerDependencies": {
-    "@lumenflow/memory": "workspace:*",
-    "@lumenflow/initiatives": "workspace:*"
+    "@lumenflow/memory": "1.3.5",
+    "@lumenflow/initiatives": "1.3.5"
   },
   "peerDependenciesMeta": {
     "@lumenflow/memory": {
@@ -114,5 +107,12 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:dist": "tsc -p tsconfig.build.json",
+    "pack:dist": "pnpm pack",
+    "clean": "rm -rf dist *.tgz",
+    "test": "vitest run"
   }
-}
+}

package/dist/spec-branch-helpers.d.ts

@@ -1,118 +0,0 @@
-/**
- * Spec Branch Helpers
- *
- * WU-1062: External plan storage and no-main-write mode
- *
- * Provides helpers for working with spec branches (spec/wu-XXXX).
- * wu:create writes to spec branches by default; wu:claim merges them to main.
- *
- * @module
- */
-import type { GitAdapter } from './git-adapter.js';
-/**
- * Spec branch prefix
- */
-export declare const SPEC_BRANCH_PREFIX = "spec/";
-/**
- * WU source location constants
- */
-export declare const WU_SOURCE: {
-    /** WU exists on main branch only */
-    readonly MAIN: "main";
-    /** WU exists on spec branch only */
-    readonly SPEC_BRANCH: "spec_branch";
-    /** WU exists on both main and spec branch */
-    readonly BOTH: "both";
-    /** WU not found anywhere */
-    readonly NOT_FOUND: "not_found";
-};
-export type WUSourceType = (typeof WU_SOURCE)[keyof typeof WU_SOURCE];
-/**
- * Get the spec branch name for a WU
- *
- * @param {string} wuId - Work Unit ID (e.g., 'WU-1062')
- * @returns {string} Spec branch name (e.g., 'spec/wu-1062')
- *
- * @example
- * getSpecBranchName('WU-1062') // 'spec/wu-1062'
- */
-export declare function getSpecBranchName(wuId: string): string;
-/**
- * Get the origin-qualified spec branch name
- *
- * @param {string} wuId - Work Unit ID
- * @returns {string} Origin-qualified branch name (e.g., 'origin/spec/wu-1062')
- */
-export declare function getOriginSpecBranch(wuId: string): string;
-/**
- * Check if a spec branch exists on origin
- *
- * @param {string} wuId - Work Unit ID
- * @param {SimpleGit} git - Git adapter instance
- * @returns {Promise<boolean>} True if spec branch exists
- *
- * @example
- * const exists = await specBranchExists('WU-1062', git);
- */
-export declare function specBranchExists(wuId: string, git: GitAdapter): Promise<boolean>;
-/**
- * Check if a WU exists on main branch
- *
- * @param {string} wuId - Work Unit ID
- * @param {SimpleGit} git - Git adapter instance
- * @returns {Promise<boolean>} True if WU YAML exists on main
- */
-export declare function isWUOnMain(wuId: string, git: GitAdapter): Promise<boolean>;
-/**
- * Merge spec branch to main branch (fast-forward only)
- *
- * This is used by wu:claim when a WU exists only on a spec branch.
- * The spec branch is merged to main before creating the worktree.
- *
- * @param {string} wuId - Work Unit ID
- * @param {SimpleGit} git - Git adapter instance
- * @throws {Error} If merge fails (e.g., due to conflicts)
- *
- * @example
- * await mergeSpecBranchToMain('WU-1062', git);
- */
-export declare function mergeSpecBranchToMain(wuId: string, git: GitAdapter): Promise<void>;
-/**
- * Delete spec branch after merge
- *
- * @param {string} wuId - Work Unit ID
- * @param {SimpleGit} git - Git adapter instance
- */
-export declare function deleteSpecBranch(wuId: string, git: GitAdapter): Promise<void>;
-/**
- * Determine the source of a WU (main, spec branch, both, or not found)
- *
- * Used by wu:claim to decide whether to merge spec branch before creating worktree.
- *
- * @param {string} wuId - Work Unit ID
- * @param {SimpleGit} git - Git adapter instance
- * @returns {Promise<WUSourceType>} Source location constant
- *
- * @example
- * const source = await getWUSource('WU-1062', git);
- * if (source === WU_SOURCE.SPEC_BRANCH) {
- *   await mergeSpecBranchToMain('WU-1062', git);
- * }
- */
-export declare function getWUSource(wuId: string, git: GitAdapter): Promise<WUSourceType>;
-/**
- * Create a spec branch from current HEAD
- *
- * Used by wu:create in default mode (no --direct flag).
- *
- * @param {string} wuId - Work Unit ID
- * @param {SimpleGit} git - Git adapter instance
- */
-export declare function createSpecBranch(wuId: string, git: GitAdapter): Promise<void>;
-/**
- * Push spec branch to origin
- *
- * @param {string} wuId - Work Unit ID
- * @param {SimpleGit} git - Git adapter instance
- */
-export declare function pushSpecBranch(wuId: string, git: GitAdapter): Promise<void>;

package/dist/spec-branch-helpers.js

@@ -1,199 +0,0 @@
-/**
- * Spec Branch Helpers
- *
- * WU-1062: External plan storage and no-main-write mode
- *
- * Provides helpers for working with spec branches (spec/wu-XXXX).
- * wu:create writes to spec branches by default; wu:claim merges them to main.
- *
- * @module
- */
-import { WU_PATHS } from './wu-paths.js';
-import { REMOTES, GIT_REFS, GIT_COMMANDS, GIT_FLAGS } from './wu-constants.js';
-/**
- * Spec branch prefix
- */
-export const SPEC_BRANCH_PREFIX = 'spec/';
-/**
- * WU source location constants
- */
-export const WU_SOURCE = {
-    /** WU exists on main branch only */
-    MAIN: 'main',
-    /** WU exists on spec branch only */
-    SPEC_BRANCH: 'spec_branch',
-    /** WU exists on both main and spec branch */
-    BOTH: 'both',
-    /** WU not found anywhere */
-    NOT_FOUND: 'not_found',
-};
-/**
- * Get the spec branch name for a WU
- *
- * @param {string} wuId - Work Unit ID (e.g., 'WU-1062')
- * @returns {string} Spec branch name (e.g., 'spec/wu-1062')
- *
- * @example
- * getSpecBranchName('WU-1062') // 'spec/wu-1062'
- */
-export function getSpecBranchName(wuId) {
-    return `${SPEC_BRANCH_PREFIX}${wuId.toLowerCase()}`;
-}
-/**
- * Get the origin-qualified spec branch name
- *
- * @param {string} wuId - Work Unit ID
- * @returns {string} Origin-qualified branch name (e.g., 'origin/spec/wu-1062')
- */
-export function getOriginSpecBranch(wuId) {
-    return GIT_REFS.remote(REMOTES.ORIGIN, getSpecBranchName(wuId));
-}
-/**
- * Check if a spec branch exists on origin
- *
- * @param {string} wuId - Work Unit ID
- * @param {SimpleGit} git - Git adapter instance
- * @returns {Promise<boolean>} True if spec branch exists
- *
- * @example
- * const exists = await specBranchExists('WU-1062', git);
- */
-export async function specBranchExists(wuId, git) {
-    try {
-        const originBranch = getOriginSpecBranch(wuId);
-        // Use branchExists if available, otherwise check with ls-remote
-        if ('branchExists' in git && typeof git.branchExists === 'function') {
-            return await git.branchExists(originBranch);
-        }
-        // Fallback: use ls-remote to check if branch exists
-        const result = await git.raw([
-            GIT_COMMANDS.LS_REMOTE,
-            GIT_FLAGS.HEADS,
-            REMOTES.ORIGIN,
-            getSpecBranchName(wuId),
-        ]);
-        return result.trim().length > 0;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Check if a WU exists on main branch
- *
- * @param {string} wuId - Work Unit ID
- * @param {SimpleGit} git - Git adapter instance
- * @returns {Promise<boolean>} True if WU YAML exists on main
- */
-export async function isWUOnMain(wuId, git) {
-    try {
-        const wuPath = WU_PATHS.WU(wuId);
-        // Check if file exists on origin/main
-        // git ls-tree returns exit 0 with empty output if file doesn't exist
-        const result = await git.raw([GIT_COMMANDS.LS_TREE, GIT_REFS.ORIGIN_MAIN, GIT_FLAGS.PATH_SEPARATOR, wuPath]);
-        return result.trim().length > 0;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Merge spec branch to main branch (fast-forward only)
- *
- * This is used by wu:claim when a WU exists only on a spec branch.
- * The spec branch is merged to main before creating the worktree.
- *
- * @param {string} wuId - Work Unit ID
- * @param {SimpleGit} git - Git adapter instance
- * @throws {Error} If merge fails (e.g., due to conflicts)
- *
- * @example
- * await mergeSpecBranchToMain('WU-1062', git);
- */
-export async function mergeSpecBranchToMain(wuId, git) {
-    const specBranch = getSpecBranchName(wuId);
-    const originSpecBranch = getOriginSpecBranch(wuId);
-    // Fetch the spec branch
-    await git.fetch(REMOTES.ORIGIN, specBranch);
-    // Merge with fast-forward only (safe merge)
-    await git.merge(originSpecBranch, { ffOnly: true });
-}
-/**
- * Delete spec branch after merge
- *
- * @param {string} wuId - Work Unit ID
- * @param {SimpleGit} git - Git adapter instance
- */
-export async function deleteSpecBranch(wuId, git) {
-    const specBranch = getSpecBranchName(wuId);
-    try {
-        // Delete local branch if exists
-        await git.deleteBranch(specBranch);
-    }
-    catch {
-        // Ignore if local branch doesn't exist
-    }
-    try {
-        // Delete remote branch
-        await git.raw([GIT_COMMANDS.PUSH, REMOTES.ORIGIN, GIT_FLAGS.DELETE_REMOTE, specBranch]);
-    }
-    catch {
-        // Ignore if remote branch doesn't exist
-    }
-}
-/**
- * Determine the source of a WU (main, spec branch, both, or not found)
- *
- * Used by wu:claim to decide whether to merge spec branch before creating worktree.
- *
- * @param {string} wuId - Work Unit ID
- * @param {SimpleGit} git - Git adapter instance
- * @returns {Promise<WUSourceType>} Source location constant
- *
- * @example
- * const source = await getWUSource('WU-1062', git);
- * if (source === WU_SOURCE.SPEC_BRANCH) {
- *   await mergeSpecBranchToMain('WU-1062', git);
- * }
- */
-export async function getWUSource(wuId, git) {
-    // Check both locations in parallel for efficiency
-    const [onMain, hasSpecBranch] = await Promise.all([
-        isWUOnMain(wuId, git),
-        specBranchExists(wuId, git),
-    ]);
-    if (onMain && hasSpecBranch) {
-        return WU_SOURCE.BOTH;
-    }
-    if (onMain) {
-        return WU_SOURCE.MAIN;
-    }
-    if (hasSpecBranch) {
-        return WU_SOURCE.SPEC_BRANCH;
-    }
-    return WU_SOURCE.NOT_FOUND;
-}
-/**
- * Create a spec branch from current HEAD
- *
- * Used by wu:create in default mode (no --direct flag).
- *
- * @param {string} wuId - Work Unit ID
- * @param {SimpleGit} git - Git adapter instance
- */
-export async function createSpecBranch(wuId, git) {
-    const specBranch = getSpecBranchName(wuId);
-    // Create local branch and checkout
-    await git.createBranch(specBranch);
-}
-/**
- * Push spec branch to origin
- *
- * @param {string} wuId - Work Unit ID
- * @param {SimpleGit} git - Git adapter instance
- */
-export async function pushSpecBranch(wuId, git) {
-    const specBranch = getSpecBranchName(wuId);
-    // Push to origin
-    await git.push(REMOTES.ORIGIN, specBranch);
-}