@lumenflow/core 3.1.3 → 3.2.1

package/dist/wu-helpers.js

@@ -0,0 +1,268 @@
+#!/usr/bin/env node
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * WU Helpers - Shared utilities for worktree and WU validation hooks
+ *
+ * Used by:
+ * - .husky/prepare-commit-msg
+ * - .husky/pre-commit
+ * - .husky/pre-push
+ */
+import { execSync } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { parse } from 'yaml';
+import { BRANCHES, REMOTES, STDIO, REAL_GIT, PATTERNS } from './wu-constants.js';
+import { die } from './error-handler.js';
+import { isAgentBranchWithDetails } from './branch-check.js';
+/**
+ * Validate WU ID format
+ *
+ * WU-1593: Extracted from duplicate implementations in wu-create.ts and wu-edit.ts (DRY).
+ * Uses centralized PATTERNS.WU_ID regex from wu-constants.ts.
+ *
+ * @param {string} id - WU ID to validate (e.g., 'WU-123')
+ * @throws {Error} If ID format is invalid
+ *
+ * @example
+ * validateWUIDFormat('WU-123'); // OK
+ * validateWUIDFormat('wu-123'); // throws Error
+ * validateWUIDFormat('TICKET-123'); // throws Error
+ */
+export function validateWUIDFormat(id) {
+    if (!PATTERNS.WU_ID.test(id)) {
+        die(`Invalid WU ID format: "${id}"\n\nExpected format: WU-<number> (e.g., WU-706)`);
+    }
+}
+/**
+ * Execute a shell command and return the output
+ * @param {string} cmd - Command to execute
+ * @param {object} opts - Execution options
+ * @returns {string} Command output
+ */
+export function run(cmd, opts = {}) {
+    try {
+        return execSync(cmd, { stdio: STDIO.PIPE, encoding: 'utf-8', ...opts }).trim();
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Get the current Git branch name
+ * Uses REAL_GIT to bypass shim and prevent recursion.
+ * @returns {string|null} Branch name or null if not in a git repo
+ */
+export function getCurrentBranch() {
+    return run(`${REAL_GIT} rev-parse --abbrev-ref HEAD`) || null;
+}
+/**
+ * Get the current working directory relative to repo root
+ * Uses REAL_GIT to bypass shim and prevent recursion.
+ * @returns {string} Current directory path
+ */
+export function getCurrentDir() {
+    const repoRoot = run(`${REAL_GIT} rev-parse --show-toplevel`);
+    const cwd = process.cwd();
+    if (!repoRoot)
+        return cwd;
+    return path.relative(repoRoot, cwd) || '.';
+}
+/**
+ * Check if we're in the main worktree (not a lane worktree)
+ * Uses REAL_GIT to bypass shim and prevent recursion.
+ * @returns {boolean} True if in main worktree
+ */
+export function isMainWorktree() {
+    const gitDir = run(`${REAL_GIT} rev-parse --git-dir`);
+    if (!gitDir)
+        return true;
+    const normalized = gitDir.replace(/\\/g, '/');
+    // Lane worktrees live under .git/worktrees/<name>
+    return !normalized.includes('/worktrees/');
+}
+/**
+ * Extract WU ID from branch name
+ * Expected format: lane/<lane-name>/<wu-id>
+ * @param {string} branch - Branch name
+ * @returns {string|null} WU ID (e.g., 'WU-401') or null
+ */
+export function extractWUFromBranch(branch) {
+    if (!branch)
+        return null;
+    // Match lane/<lane>/<wu-id> format
+    const match = branch.match(/^lane\/[^/]+\/(wu-\d+)$/i);
+    if (match?.[1]) {
+        return match[1].toUpperCase();
+    }
+    return null;
+}
+/**
+ * Validate branch name follows lane convention
+ * Expected: lane/<lane-name>/<wu-id>
+ * @param {string} branch - Branch name to validate
+ * @returns {{valid: boolean, lane: string|null, wuid: string|null, error: string|null}}
+ */
+export function validateBranchName(branch) {
+    if (!branch || branch === BRANCHES.MAIN) {
+        return { valid: true, lane: null, wuid: null, error: null };
+    }
+    const match = branch.match(/^lane\/([^/]+)\/(wu-\d+)$/i);
+    if (!match) {
+        return {
+            valid: false,
+            lane: null,
+            wuid: null,
+            error: `Branch '${branch}' doesn't follow lane/<lane>/<wu-id> convention`,
+        };
+    }
+    const lane = match[1] ?? null;
+    const wuid = match[2]?.toUpperCase() ?? null;
+    return {
+        valid: true,
+        lane,
+        wuid,
+        error: null,
+    };
+}
+/**
+ * Read WU YAML file and return parsed content
+ * Uses REAL_GIT to bypass shim and prevent recursion.
+ * @param {string} wuid - WU ID (e.g., 'WU-401')
+ * @returns {object|null} Parsed WU YAML or null if not found
+ */
+export function readWUYaml(wuid) {
+    const repoRoot = run(`${REAL_GIT} rev-parse --show-toplevel`);
+    if (!repoRoot)
+        return null;
+    const wuPath = path.join(repoRoot, 'docs', '04-operations', 'tasks', 'wu', `${wuid}.yaml`);
+    if (!existsSync(wuPath))
+        return null;
+    try {
+        const content = readFileSync(wuPath, { encoding: 'utf-8' });
+        return parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if WU status allows the operation
+ * @param {string} wuid - WU ID
+ * @param {string[]} allowedStatuses - List of allowed statuses
+ * @returns {{allowed: boolean, status: string|null, error: string|null}}
+ */
+export function checkWUStatus(wuid, allowedStatuses = ['in_progress', 'waiting']) {
+    const wu = readWUYaml(wuid);
+    if (!wu) {
+        return {
+            allowed: false,
+            status: null,
+            error: `WU ${wuid} not found in docs/04-operations/tasks/wu/`,
+        };
+    }
+    const status = wu.status;
+    if (!status) {
+        return {
+            allowed: false,
+            status: null,
+            error: `WU ${wuid} has no status field`,
+        };
+    }
+    if (!allowedStatuses.includes(status)) {
+        return {
+            allowed: false,
+            status,
+            error: `WU ${wuid} status is '${status}' (expected one of: ${allowedStatuses.join(', ')})`,
+        };
+    }
+    return { allowed: true, status, error: null };
+}
+/**
+ * Format an error message for hook output
+ * @param {string} hookName - Name of the hook
+ * @param {string} message - Error message
+ * @returns {string} Formatted error message
+ */
+export function formatHookError(hookName, message) {
+    return `
+╔═══════════════════════════════════════════════════════════════════╗
+║  ${hookName.toUpperCase()} HOOK ERROR
+╠═══════════════════════════════════════════════════════════════════╣
+║  ${message}
+╚═══════════════════════════════════════════════════════════════════╝
+`;
+}
+/**
+ * Extract WU ID from commit message
+ * Supports formats:
+ * - wu(WU-401): message
+ * - chore(wu-401): message
+ * - feat(wu-401): message
+ * @param {string} message - Commit message
+ * @returns {string|null} WU ID or null
+ */
+export function extractWUFromCommitMessage(message) {
+    if (!message)
+        return null;
+    // Match wu(WU-401) or type(wu-401) patterns
+    const patterns = [
+        /wu\((wu-\d+)\)/i, // wu(WU-401)
+        /\w+\((wu-\d+)\)/i, // chore(wu-401), feat(wu-401), etc.
+    ];
+    for (const pattern of patterns) {
+        const match = message.match(pattern);
+        if (match?.[1]) {
+            return match[1].toUpperCase();
+        }
+    }
+    return null;
+}
+/**
+ * Ensure current branch is main. Throws if not.
+ *
+ * Centralized from duplicated ensureOnMain() functions across wu-* scripts (WU-1256).
+ * Async version - accepts a git adapter with async getCurrentBranch() method.
+ *
+ * WU-1091: Agent branches (claude/*, codex/*, copilot/*, cursor/*, agent/*) bypass
+ * the main branch requirement for web agent commands. Lane branches still require
+ * worktree workflow (no bypass). Protected branches (main/master) remain protected.
+ *
+ * @param {object} git - Git adapter with async getCurrentBranch() method
+ * @throws {Error} If not on main branch and not an agent branch
+ */
+export async function ensureOnMain(git) {
+    const branch = await git.getCurrentBranch();
+    if (branch !== BRANCHES.MAIN) {
+        // WU-1091: Check if this is an agent branch that can bypass the main requirement
+        const agentResult = await isAgentBranchWithDetails(branch);
+        if (agentResult.isMatch) {
+            console.log(`[ensureOnMain] Bypassing for agent branch '${branch}' (${agentResult.patternResult.source})`);
+            return;
+        }
+        throw new Error(`Run from shared checkout on '${BRANCHES.MAIN}' (found '${branch}')`);
+    }
+}
+/**
+ * Ensure main branch is up to date with origin.
+ *
+ * Centralized from duplicated ensureMainUpToDate() functions across wu-* scripts (WU-1256).
+ *
+ * @param {object} git - Git adapter with async fetch() and getCommitHash() methods
+ * @param {string} [scriptName='wu'] - Script name for logging
+ * @param {object} [options] - Options
+ * @param {boolean} [options.skipRemote=false] - WU-1653: Skip remote check (requireRemote=false)
+ * @throws {Error} If main is out of sync with origin
+ */
+export async function ensureMainUpToDate(git, _scriptName = 'wu', { skipRemote = false } = {}) {
+    if (skipRemote)
+        return;
+    await git.fetch(REMOTES.ORIGIN, BRANCHES.MAIN);
+    const localMain = await git.getCommitHash(BRANCHES.MAIN);
+    const remoteMain = await git.getCommitHash(`${REMOTES.ORIGIN}/${BRANCHES.MAIN}`);
+    if (localMain !== remoteMain) {
+        throw new Error(`Main branch is out of sync with origin.\n\nRun: git pull ${REMOTES.ORIGIN} ${BRANCHES.MAIN}`);
+    }
+}
+//# sourceMappingURL=wu-helpers.js.map

package/dist/wu-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-helpers.js","sourceRoot":"","sources":["../src/wu-helpers.ts"],"names":[],"mappings":"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"}

package/dist/wu-id-generator.d.ts

@@ -0,0 +1,51 @@
+/** WU ID prefix constant */
+export declare const WU_ID_PREFIX = "WU-";
+/**
+ * Parse the numeric part from a WU ID string.
+ *
+ * Supports formats:
+ * - WU-123 (direct ID)
+ * - WU-123.yaml (filename)
+ *
+ * @param wuIdOrFilename - WU ID or filename to parse
+ * @returns Numeric ID or null if invalid format
+ */
+export declare function parseWuIdNumber(wuIdOrFilename: string): number | null;
+/**
+ * Get the highest WU ID number from the WU directory.
+ *
+ * Scans all WU-*.yaml files and returns the highest numeric ID found.
+ * Returns 0 if directory doesn't exist or contains no valid WU files.
+ *
+ * @returns Highest WU ID number or 0 if none found
+ */
+export declare function getHighestWuId(): number;
+/**
+ * Get the next available WU ID.
+ *
+ * Returns the next sequential ID after the highest existing WU.
+ * Does not fill gaps - always returns highest + 1.
+ *
+ * @returns Next WU ID in format "WU-{number}"
+ */
+export declare function getNextWuId(): string;
+/** Options for generateWuIdWithRetry */
+interface GenerateOptions {
+    /** Maximum number of retry attempts (default: 5) */
+    maxRetries?: number;
+}
+/**
+ * Generate a unique WU ID with retry handling for race conditions.
+ *
+ * This function handles concurrent wu:create calls by:
+ * 1. Generating the next sequential ID
+ * 2. Checking if the file already exists (race condition detection)
+ * 3. Retrying with exponential backoff if conflict detected
+ *
+ * @param options - Generation options
+ * @returns Promise resolving to unique WU ID
+ * @throws Error if max retries exceeded
+ */
+export declare function generateWuIdWithRetry(options?: GenerateOptions): Promise<string>;
+export {};
+//# sourceMappingURL=wu-id-generator.d.ts.map

package/dist/wu-id-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-id-generator.d.ts","sourceRoot":"","sources":["../src/wu-id-generator.ts"],"names":[],"mappings":"AAeA,4BAA4B;AAC5B,eAAO,MAAM,YAAY,QAAQ,CAAC;AAQlC;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAqBrE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAkBvC;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAGpC;AAED,wCAAwC;AACxC,UAAU,eAAe;IACvB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB1F"}

package/dist/wu-id-generator.js

@@ -0,0 +1,110 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * WU ID Generator (WU-1246)
+ *
+ * Auto-generates sequential WU IDs by scanning existing WU YAML files.
+ * Provides race-condition handling via retry mechanism.
+ *
+ * @module wu-id-generator
+ */
+import { existsSync, readdirSync } from 'node:fs';
+import { WU_PATHS } from './wu-paths.js';
+/** WU ID prefix constant */
+export const WU_ID_PREFIX = 'WU-';
+/** Default maximum retry attempts for race condition handling */
+const DEFAULT_MAX_RETRIES = 5;
+/** Retry delay in milliseconds (exponential backoff base) */
+const RETRY_DELAY_BASE_MS = 50;
+/**
+ * Parse the numeric part from a WU ID string.
+ *
+ * Supports formats:
+ * - WU-123 (direct ID)
+ * - WU-123.yaml (filename)
+ *
+ * @param wuIdOrFilename - WU ID or filename to parse
+ * @returns Numeric ID or null if invalid format
+ */
+export function parseWuIdNumber(wuIdOrFilename) {
+    if (!wuIdOrFilename || typeof wuIdOrFilename !== 'string') {
+        return null;
+    }
+    // Remove .yaml extension if present
+    const wuId = wuIdOrFilename.replace(/\.yaml$/, '');
+    // Match WU-{number} pattern using RegExp method per sonarjs/prefer-regexp-exec
+    const WU_ID_PATTERN = /^WU-(\d+)$/;
+    const regexResult = WU_ID_PATTERN.exec(wuId);
+    if (!regexResult) {
+        return null;
+    }
+    const idSegment = regexResult[1];
+    if (!idSegment) {
+        return null;
+    }
+    const num = parseInt(idSegment, 10);
+    return isNaN(num) ? null : num;
+}
+/**
+ * Get the highest WU ID number from the WU directory.
+ *
+ * Scans all WU-*.yaml files and returns the highest numeric ID found.
+ * Returns 0 if directory doesn't exist or contains no valid WU files.
+ *
+ * @returns Highest WU ID number or 0 if none found
+ */
+export function getHighestWuId() {
+    const wuDir = WU_PATHS.WU_DIR();
+    if (!existsSync(wuDir)) {
+        return 0;
+    }
+    const files = readdirSync(wuDir);
+    let highest = 0;
+    for (const file of files) {
+        const num = parseWuIdNumber(file);
+        if (num !== null && num > highest) {
+            highest = num;
+        }
+    }
+    return highest;
+}
+/**
+ * Get the next available WU ID.
+ *
+ * Returns the next sequential ID after the highest existing WU.
+ * Does not fill gaps - always returns highest + 1.
+ *
+ * @returns Next WU ID in format "WU-{number}"
+ */
+export function getNextWuId() {
+    const highest = getHighestWuId();
+    return `${WU_ID_PREFIX}${highest + 1}`;
+}
+/**
+ * Generate a unique WU ID with retry handling for race conditions.
+ *
+ * This function handles concurrent wu:create calls by:
+ * 1. Generating the next sequential ID
+ * 2. Checking if the file already exists (race condition detection)
+ * 3. Retrying with exponential backoff if conflict detected
+ *
+ * @param options - Generation options
+ * @returns Promise resolving to unique WU ID
+ * @throws Error if max retries exceeded
+ */
+export async function generateWuIdWithRetry(options = {}) {
+    const maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+        const nextId = getNextWuId();
+        const wuPath = WU_PATHS.WU(nextId);
+        // Check if file already exists (race condition)
+        if (!existsSync(wuPath)) {
+            return nextId;
+        }
+        // Exponential backoff before retry
+        const delay = RETRY_DELAY_BASE_MS * Math.pow(2, attempt);
+        await new Promise((resolve) => setTimeout(resolve, delay));
+    }
+    throw new Error(`Failed to generate unique WU ID after ${maxRetries} attempts`);
+}
+//# sourceMappingURL=wu-id-generator.js.map

package/dist/wu-id-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-id-generator.js","sourceRoot":"","sources":["../src/wu-id-generator.ts"],"names":[],"mappings":"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"}

package/dist/wu-inconsistency-repairer.d.ts

@@ -0,0 +1,69 @@
+import type { ConsistencyError } from './wu-consistency-detector.js';
+import type { WUConsistencyRepairResult } from './wu-consistency-file-repairs.js';
+/**
+ * Options for repairing WU inconsistencies
+ */
+export interface RepairWUInconsistencyOptions {
+    /** If true, don't actually repair */
+    dryRun?: boolean;
+    /** Project root directory */
+    projectRoot?: string;
+}
+/**
+ * Strategy for repairing a file-based consistency error inside a worktree.
+ *
+ * Each handler receives the error, the worktree path (where files are written),
+ * and the project root (where source files are read from).
+ *
+ * To add a new file-based repair type:
+ *   1. Add the type constant to CONSISTENCY_TYPES in wu-domain-constants.ts
+ *   2. Add a handler to FILE_REPAIR_STRATEGIES below
+ */
+export type FileRepairStrategy = (error: ConsistencyError, worktreePath: string, projectRoot: string) => Promise<WUConsistencyRepairResult>;
+/**
+ * Strategy for repairing a git-only consistency error (no micro-worktree needed).
+ *
+ * To add a new git-only repair type:
+ *   1. Add the type constant to CONSISTENCY_TYPES in wu-domain-constants.ts
+ *   2. Add a handler to GIT_REPAIR_STRATEGIES below
+ */
+export type GitRepairStrategy = (error: ConsistencyError, projectRoot: string) => Promise<WUConsistencyRepairResult>;
+/**
+ * Strategy map for file-based repairs (WU-2018).
+ *
+ * Each entry maps a CONSISTENCY_TYPES value to a handler function.
+ * File-based repairs run inside a micro-worktree for atomic commits.
+ */
+export declare const FILE_REPAIR_STRATEGIES: Record<string, FileRepairStrategy>;
+/**
+ * Strategy map for git-only repairs (WU-2018).
+ *
+ * Each entry maps a CONSISTENCY_TYPES value to a handler function.
+ * Git-only repairs (worktree/branch cleanup) run directly without micro-worktree.
+ */
+export declare const GIT_REPAIR_STRATEGIES: Record<string, GitRepairStrategy>;
+/**
+ * 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.
+ *
+ * WU-1370: When projectRoot is explicitly provided (not process.cwd()), the caller
+ * is already inside a micro-worktree context (e.g., handleOrphanCheck during wu:claim).
+ * In this case, skip creating a nested micro-worktree and work directly in projectRoot.
+ * This prevents local main drift from nested micro-worktrees merging before pushing.
+ *
+ * @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: {
+    valid: boolean;
+    errors: ConsistencyError[];
+}, options?: RepairWUInconsistencyOptions): Promise<{
+    repaired: number;
+    skipped: number;
+    failed: number;
+}>;
+//# sourceMappingURL=wu-inconsistency-repairer.d.ts.map

package/dist/wu-inconsistency-repairer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-inconsistency-repairer.d.ts","sourceRoot":"","sources":["../src/wu-inconsistency-repairer.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAQlF;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,qCAAqC;IACrC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,KAAK,EAAE,gBAAgB,EACvB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,KAChB,OAAO,CAAC,yBAAyB,CAAC,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,KAAK,EAAE,gBAAgB,EACvB,WAAW,EAAE,MAAM,KAChB,OAAO,CAAC,yBAAyB,CAAC,CAAC;AAExC;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAoCrE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAOnE,CAAC;AAmFF;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,gBAAgB,EAAE,CAAA;CAAE,EACtD,OAAO,GAAE,4BAAiC;;;;GAsI3C"}