@lumenflow/core 3.2.0 → 3.2.1

package/dist/backlog-parser.js

@@ -0,0 +1,105 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Backlog Parser (WU-1065, WU-1211)
+ * Shared module for parsing YAML frontmatter in backlog.md
+ * Uses gray-matter library for robust frontmatter parsing
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import matter from 'gray-matter';
+import yaml from 'yaml';
+import { createError, ErrorCodes } from './error-handler.js';
+/**
+ * Parse YAML frontmatter from backlog.md
+ * @param {string} backlogPath - Path to backlog.md file
+ * @returns {{frontmatter: object|null, markdown: string}} Parsed frontmatter and markdown body
+ * @throws {Error} If file not found or YAML parsing fails
+ */
+export function parseBacklogFrontmatter(backlogPath) {
+    if (!existsSync(backlogPath)) {
+        throw createError(ErrorCodes.FILE_NOT_FOUND, `Backlog not found: ${backlogPath}`, {
+            path: backlogPath,
+        });
+    }
+    const content = readFileSync(backlogPath, { encoding: 'utf-8' });
+    try {
+        // Configure gray-matter to use modern yaml library instead of deprecated js-yaml
+        const { data, content: markdown } = matter(content, {
+            engines: {
+                yaml: {
+                    parse: yaml.parse.bind(yaml),
+                    stringify: yaml.stringify.bind(yaml),
+                },
+            },
+        });
+        // gray-matter returns {} for no frontmatter; normalize to null for consistency
+        const frontmatter = Object.keys(data).length > 0 ? data : null;
+        return { frontmatter, markdown };
+    }
+    catch (err) {
+        throw createError(ErrorCodes.YAML_PARSE_ERROR, `Failed to parse frontmatter in ${backlogPath}:\n\n${err.message}\n\n` +
+            `Ensure frontmatter is valid YAML between --- delimiters.`, { path: backlogPath, originalError: err.message });
+    }
+}
+/**
+ * Extract section headings from frontmatter
+ * @param {object|null} frontmatter - Parsed frontmatter object
+ * @returns {object} Map of section names to heading strings (e.g., {ready: "## 🚀 Ready"})
+ */
+export function getSectionHeadings(frontmatter) {
+    if (!frontmatter || !frontmatter.sections) {
+        return {};
+    }
+    const headings = {};
+    for (const [sectionName, sectionConfig] of Object.entries(frontmatter.sections)) {
+        if (sectionConfig.heading) {
+            headings[sectionName] = sectionConfig.heading;
+        }
+    }
+    return headings;
+}
+/**
+ * Find section boundaries in backlog content
+ * @param {string[]} lines - Lines of backlog content
+ * @param {object|null} frontmatter - Parsed frontmatter object
+ * @returns {object} Map of section names to {start, end} boundary indices
+ */
+export function findSectionBoundaries(lines, frontmatter) {
+    if (!frontmatter || !frontmatter.sections) {
+        return {};
+    }
+    const headings = getSectionHeadings(frontmatter);
+    const boundaries = {};
+    // Initialize all sections as null (not found)
+    for (const sectionName of Object.keys(headings)) {
+        boundaries[sectionName] = null;
+    }
+    // Find start indices for each section (exact match)
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        for (const [sectionName, heading] of Object.entries(headings)) {
+            if (line === heading) {
+                boundaries[sectionName] = { start: i, end: null };
+            }
+        }
+    }
+    // Calculate end indices (last line before next section or EOF)
+    const sectionStarts = Object.values(boundaries)
+        .filter((b) => b !== null)
+        .map((b) => b.start)
+        .sort((a, b) => a - b);
+    for (const boundary of Object.values(boundaries)) {
+        if (boundary === null)
+            continue;
+        const currentStart = boundary.start;
+        const nextStart = sectionStarts.find((s) => s > currentStart);
+        if (nextStart !== undefined) {
+            boundary.end = nextStart - 1;
+        }
+        else {
+            boundary.end = lines.length - 1;
+        }
+    }
+    return boundaries;
+}
+//# sourceMappingURL=backlog-parser.js.map

package/dist/backlog-parser.js.map

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

package/dist/backlog-sync-validator.d.ts

@@ -0,0 +1,88 @@
+export declare function validateBacklogSync(backlogPath: string): {
+    valid: boolean;
+    errors: string[];
+    stats?: undefined;
+} | {
+    valid: boolean;
+    errors: string[];
+    stats: {
+        ready: number;
+        inProgress: number;
+        blocked: number;
+        done: number;
+        duplicates: number;
+        parentOnlyInReady: number;
+    };
+};
+/**
+ * Options for fixing backlog duplicates
+ */
+export interface FixBacklogDuplicatesOptions {
+    /** If true, report changes without writing */
+    dryRun?: boolean;
+    /** If true, return fixed content without writing (WU-1506) */
+    returnContent?: boolean;
+}
+/**
+ * Fix backlog duplicates by removing WUs from non-authoritative sections
+ * - If WU in Done AND Ready: remove from Ready (Done is authoritative)
+ * - If WU in Done AND InProgress: remove from InProgress (Done is authoritative)
+ *
+ * Part of WU-1303: Backlog duplicate entries after rebase conflicts
+ * WU-1506: Added returnContent option for atomic in-memory validation
+ *
+ * @param {string} backlogPath - Path to backlog.md file
+ * @param {FixBacklogDuplicatesOptions} options - Fix options
+ * @returns {{fixed: boolean, removed: Array<{wu: string, section: string}>, backupPath?: string, content?: string}}
+ */
+export declare function fixBacklogDuplicates(backlogPath: string, options?: FixBacklogDuplicatesOptions): {
+    fixed: boolean;
+    removed: never[];
+    error: string;
+    message?: undefined;
+    content?: undefined;
+    dryRun?: undefined;
+    backupPath?: undefined;
+} | {
+    fixed: boolean;
+    removed: never[];
+    message: string;
+    error?: undefined;
+    content?: undefined;
+    dryRun?: undefined;
+    backupPath?: undefined;
+} | {
+    fixed: boolean;
+    removed: {
+        wu: string;
+        section: string;
+    }[];
+    content: string;
+    message: string;
+    error?: undefined;
+    dryRun?: undefined;
+    backupPath?: undefined;
+} | {
+    fixed: boolean;
+    removed: {
+        wu: string;
+        section: string;
+    }[];
+    dryRun: boolean;
+    message: string;
+    error?: undefined;
+    content?: undefined;
+    backupPath?: undefined;
+} | {
+    fixed: boolean;
+    removed: {
+        wu: string;
+        section: string;
+    }[];
+    backupPath: string;
+    message: string;
+    error?: undefined;
+    content?: undefined;
+    dryRun?: undefined;
+};
+//# sourceMappingURL=backlog-sync-validator.d.ts.map

package/dist/backlog-sync-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backlog-sync-validator.d.ts","sourceRoot":"","sources":["../src/backlog-sync-validator.ts"],"names":[],"mappings":"AAyDA,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM;;;;;;;;;;;;;;;EAoKtD;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,8CAA8C;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,2BAAgC;;;;;;;;;;;;;;;;;;;YA0Ed,MAAM;iBAAW,MAAM;;;;;;;;;;YAAvB,MAAM;iBAAW,MAAM;;;;;;;;;;YAAvB,MAAM;iBAAW,MAAM;;;;;;;EAuEnD"}

package/dist/backlog-sync-validator.js

@@ -0,0 +1,322 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Backlog Sync Validator (WU-672, WU-1065, WU-1137, WU-1303)
+ * Detects WUs present in multiple sections (Done+Ready, Done+InProgress, etc.)
+ * Uses frontmatter-driven section detection (WU-1065) instead of brittle string matching
+ * Flags parent-only WUs in Ready section (WU-1137) - sub-lane format is preferred
+ * Supports --fix mode to automatically remove duplicates (WU-1303)
+ */
+import { readFileSync, writeFileSync, existsSync, copyFileSync } from 'node:fs';
+import path from 'node:path';
+import { parseYAML } from './wu-yaml.js';
+import { parseBacklogFrontmatter, getSectionHeadings } from './backlog-parser.js';
+import { extractParent } from './lane-checker.js';
+import { CONFIG_FILES, STRING_LITERALS, WU_STATUS, getProjectRoot } from './wu-constants.js';
+import { getErrorMessage } from './error-handler.js';
+const BACKLOG_SECTION_STATUS = {
+    ready: WU_STATUS.READY,
+    in_progress: WU_STATUS.IN_PROGRESS,
+    blocked: WU_STATUS.BLOCKED,
+    done: WU_STATUS.DONE,
+};
+const BACKLOG_SECTIONS = Object.keys(BACKLOG_SECTION_STATUS);
+/**
+ * Check if parent lane has sub-lane taxonomy in .lumenflow.lane-inference.yaml
+ * @param {string} parent - Parent lane name
+ * @param {string} projectRoot - Path to project root
+ * @returns {boolean} True if parent has sub-lanes defined
+ */
+function hasSubLaneTaxonomy(parent, projectRoot) {
+    const taxonomyPath = path.join(projectRoot, CONFIG_FILES.LANE_INFERENCE);
+    if (!existsSync(taxonomyPath)) {
+        return false;
+    }
+    try {
+        const taxonomyContent = readFileSync(taxonomyPath, { encoding: 'utf-8' });
+        const taxonomy = parseYAML(taxonomyContent);
+        const normalizedParent = parent.trim().toLowerCase();
+        return Object.keys(taxonomy).some((key) => key.toLowerCase().trim() === normalizedParent);
+    }
+    catch {
+        // If taxonomy file is malformed, assume no taxonomy (fail safe)
+        return false;
+    }
+}
+export function validateBacklogSync(backlogPath) {
+    // Parse frontmatter to get configured section headings
+    let frontmatter;
+    let markdown;
+    try {
+        ({ frontmatter, markdown } = parseBacklogFrontmatter(backlogPath));
+    }
+    catch (err) {
+        return { valid: false, errors: [getErrorMessage(err)] };
+    }
+    // If no frontmatter, fall back to empty sections (backlog without frontmatter is valid)
+    const headings = frontmatter
+        ? getSectionHeadings(frontmatter)
+        : {};
+    const lines = markdown.split(/\r?\n/);
+    // Parse sections using frontmatter headings
+    const sections = {
+        ready: new Set(),
+        in_progress: new Set(),
+        blocked: new Set(),
+        done: new Set(),
+    };
+    let currentSection = null;
+    // Build heading-to-section map for efficient lookup
+    const headingMap = new Map();
+    for (const sectionName of BACKLOG_SECTIONS) {
+        const heading = headings[sectionName];
+        if (heading) {
+            headingMap.set(heading, sectionName);
+        }
+    }
+    // WU-1334: Pattern to match WU IDs only in backlog list items
+    // Matches lines starting with:
+    // - `- WU-123` (bullet list)
+    // - `* WU-123` (asterisk list)
+    // - `- [ ] WU-123` (unchecked checkbox)
+    // - `- [x] WU-123` (checked checkbox)
+    // - `- [WU-123 - title](...)` (markdown link)
+    // Does NOT match prose like "See WU-123 for details" or "WU-123 → WU-124"
+    // eslint-disable-next-line security/detect-unsafe-regex -- static backlog pattern; input is line-bounded markdown
+    const BACKLOG_ITEM_PATTERN = /^\s*[-*]\s*(?:\[[ x]\]\s*)?\[?(WU-\d+)/i;
+    for (const line of lines) {
+        // Check if line matches UnsafeAny configured section heading (exact match)
+        if (headingMap.has(line)) {
+            currentSection = headingMap.get(line) ?? null;
+            continue;
+        }
+        // Reset section when encountering other ## headings (not subsections ###)
+        if (line.trim().startsWith('## ') && !line.trim().startsWith('### ')) {
+            currentSection = null;
+            continue;
+        }
+        if (currentSection) {
+            const match = line.match(BACKLOG_ITEM_PATTERN);
+            if (match?.[1]) {
+                sections[currentSection].add(match[1].toUpperCase());
+            }
+        }
+    }
+    // Detect duplicates
+    const errors = [];
+    // Done + Ready
+    const doneAndReady = [...sections.done].filter((wu) => sections.ready.has(wu));
+    if (doneAndReady.length > 0) {
+        errors.push(`❌ ${doneAndReady.length} WU(s) are in BOTH Done and Ready sections:${STRING_LITERALS.NEWLINE}${doneAndReady
+            .map((wu) => `   - ${wu}`)
+            .join(STRING_LITERALS.NEWLINE)}${STRING_LITERALS.DOUBLE_NEWLINE}` +
+            `   Fix: Remove from Ready section (they are already complete)${STRING_LITERALS.NEWLINE}` +
+            `   Command: Edit docs/04-operations/tasks/backlog.md and remove duplicate entries`);
+    }
+    // Done + In Progress (should never happen, but check anyway)
+    const doneAndInProgress = [...sections.done].filter((wu) => sections.in_progress.has(wu));
+    if (doneAndInProgress.length > 0) {
+        errors.push(`❌ ${doneAndInProgress.length} WU(s) are in BOTH Done and In Progress sections:${STRING_LITERALS.NEWLINE}${doneAndInProgress
+            .map((wu) => `   - ${wu}`)
+            .join(STRING_LITERALS.NEWLINE)}${STRING_LITERALS.DOUBLE_NEWLINE}` +
+            `   Fix: Remove from In Progress section (they are already complete)${STRING_LITERALS.NEWLINE}` +
+            `   Or: If reopened, remove from Done and update WU YAML status to in_progress`);
+    }
+    // Ready + In Progress (legitimate during claim, but flag for awareness)
+    const readyAndInProgress = [...sections.ready].filter((wu) => sections.in_progress.has(wu));
+    if (readyAndInProgress.length > 0) {
+        errors.push(`⚠️  ${readyAndInProgress.length} WU(s) are in BOTH Ready and In Progress sections:${STRING_LITERALS.NEWLINE}${readyAndInProgress
+            .map((wu) => `   - ${wu}`)
+            .join(STRING_LITERALS.NEWLINE)}${STRING_LITERALS.DOUBLE_NEWLINE}` +
+            `   This is normal during wu:claim before commit.${STRING_LITERALS.NEWLINE}` +
+            `   If you see this error after commit, wu:claim did not remove from Ready.${STRING_LITERALS.NEWLINE}` +
+            `   Fix: Remove from Ready section`);
+    }
+    // WU-1137: Check for parent-only WUs in Ready section (sub-lane format preferred)
+    const projectRoot = getProjectRoot(import.meta.url);
+    const wuDir = path.join(path.dirname(backlogPath), 'wu');
+    const parentOnlyWUs = [];
+    for (const wuId of sections.ready) {
+        const wuPath = path.join(wuDir, `${wuId}.yaml`);
+        if (!existsSync(wuPath)) {
+            continue; // Skip missing WU files (handled by other validators)
+        }
+        try {
+            const wuContent = readFileSync(wuPath, { encoding: 'utf-8' });
+            const wuDoc = parseYAML(wuContent);
+            if (wuDoc && wuDoc.lane) {
+                const lane = wuDoc.lane.toString().trim();
+                const hasColon = lane.includes(':');
+                // If parent-only format (no colon) and parent has sub-lane taxonomy, flag it
+                if (!hasColon) {
+                    const parent = extractParent(lane);
+                    if (hasSubLaneTaxonomy(parent, projectRoot)) {
+                        parentOnlyWUs.push({ wuId, lane, parent });
+                    }
+                }
+            }
+        }
+        catch {
+            // Skip WU files that can't be parsed (handled by other validators)
+            continue;
+        }
+    }
+    if (parentOnlyWUs.length > 0) {
+        errors.push(`⚠️  ${parentOnlyWUs.length} WU(s) in Ready section use parent-only lane format (sub-lane format preferred):${STRING_LITERALS.NEWLINE}${parentOnlyWUs
+            .map((wu) => `   - ${wu.wuId}: "${wu.lane}" (parent has sub-lanes)`)
+            .join(STRING_LITERALS.NEWLINE)}${STRING_LITERALS.DOUBLE_NEWLINE}` +
+            `   Fix: Migrate to sub-lane format using:${STRING_LITERALS.NEWLINE}` +
+            `        pnpm wu:infer-lane --id WU-123     # Suggest a sub-lane${STRING_LITERALS.NEWLINE}` +
+            `        pnpm wu:edit --id WU-123 --lane "Parent: Sub"${STRING_LITERALS.NEWLINE}` +
+            `   See: https://lumenflow.dev/reference/sub-lanes/`);
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        stats: {
+            ready: sections.ready.size,
+            inProgress: sections.in_progress.size,
+            blocked: sections.blocked.size,
+            done: sections.done.size,
+            duplicates: doneAndReady.length + doneAndInProgress.length + readyAndInProgress.length,
+            parentOnlyInReady: parentOnlyWUs.length,
+        },
+    };
+}
+/**
+ * Fix backlog duplicates by removing WUs from non-authoritative sections
+ * - If WU in Done AND Ready: remove from Ready (Done is authoritative)
+ * - If WU in Done AND InProgress: remove from InProgress (Done is authoritative)
+ *
+ * Part of WU-1303: Backlog duplicate entries after rebase conflicts
+ * WU-1506: Added returnContent option for atomic in-memory validation
+ *
+ * @param {string} backlogPath - Path to backlog.md file
+ * @param {FixBacklogDuplicatesOptions} options - Fix options
+ * @returns {{fixed: boolean, removed: Array<{wu: string, section: string}>, backupPath?: string, content?: string}}
+ */
+export function fixBacklogDuplicates(backlogPath, options = {}) {
+    const { dryRun = false, returnContent = false } = options;
+    // Parse frontmatter to get configured section headings
+    let frontmatter;
+    let markdown;
+    try {
+        ({ frontmatter, markdown } = parseBacklogFrontmatter(backlogPath));
+    }
+    catch (err) {
+        return { fixed: false, removed: [], error: getErrorMessage(err) };
+    }
+    const headings = frontmatter
+        ? getSectionHeadings(frontmatter)
+        : {};
+    const lines = markdown.split(/\r?\n/);
+    // Track section boundaries and WU locations
+    const sections = {
+        ready: { wus: new Set(), lineNumbers: new Map() },
+        in_progress: { wus: new Set(), lineNumbers: new Map() },
+        blocked: { wus: new Set(), lineNumbers: new Map() },
+        done: { wus: new Set(), lineNumbers: new Map() },
+    };
+    let currentSection = null;
+    // Build heading-to-section map
+    const headingMap = new Map();
+    for (const sectionName of BACKLOG_SECTIONS) {
+        const heading = headings[sectionName];
+        if (heading) {
+            headingMap.set(heading, sectionName);
+        }
+    }
+    // WU-1334: Same pattern as validateBacklogSync - only match list items
+    // eslint-disable-next-line security/detect-unsafe-regex -- static backlog pattern; input is line-bounded markdown
+    const BACKLOG_ITEM_PATTERN = /^\s*[-*]\s*(?:\[[ x]\]\s*)?\[?(WU-\d+)/i;
+    // Parse sections and track line numbers for each WU
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line === undefined) {
+            continue;
+        }
+        if (headingMap.has(line)) {
+            currentSection = headingMap.get(line) ?? null;
+            continue;
+        }
+        // Reset section on other ## headings
+        if (line.trim().startsWith('## ') && !line.trim().startsWith('### ')) {
+            currentSection = null;
+            continue;
+        }
+        if (currentSection) {
+            const match = line.match(BACKLOG_ITEM_PATTERN);
+            if (match?.[1]) {
+                const wuId = match[1].toUpperCase();
+                sections[currentSection].wus.add(wuId);
+                // Store line number (can have multiple lines per WU, but we just need one to identify the entry)
+                if (!sections[currentSection].lineNumbers.has(wuId)) {
+                    sections[currentSection].lineNumbers.set(wuId, i);
+                }
+            }
+        }
+    }
+    // Find duplicates that need removal
+    const linesToRemove = new Set();
+    const removed = [];
+    // Done + Ready: remove from Ready
+    for (const wu of sections.done.wus) {
+        if (sections.ready.wus.has(wu)) {
+            const lineNum = sections.ready.lineNumbers.get(wu);
+            if (lineNum !== undefined) {
+                linesToRemove.add(lineNum);
+                removed.push({ wu, section: WU_STATUS.READY });
+            }
+        }
+    }
+    // Done + InProgress: remove from InProgress
+    for (const wu of sections.done.wus) {
+        if (sections.in_progress.wus.has(wu)) {
+            const lineNum = sections.in_progress.lineNumbers.get(wu);
+            if (lineNum !== undefined) {
+                linesToRemove.add(lineNum);
+                removed.push({ wu, section: WU_STATUS.IN_PROGRESS });
+            }
+        }
+    }
+    // No duplicates to fix
+    if (removed.length === 0) {
+        return { fixed: false, removed: [], message: 'No duplicates found' };
+    }
+    // Remove duplicate lines (filter out the lines to remove)
+    const newLines = lines.filter((_, index) => !linesToRemove.has(index));
+    // Reconstruct file with frontmatter
+    const originalContent = readFileSync(backlogPath, { encoding: 'utf-8' });
+    const frontmatterMatch = originalContent.match(/^---\n[\s\S]*?\n---\n/);
+    const frontmatterContent = frontmatterMatch ? frontmatterMatch[0] : STRING_LITERALS.EMPTY;
+    const newContent = frontmatterContent + newLines.join(STRING_LITERALS.NEWLINE);
+    // WU-1506: Return content without writing when returnContent is true
+    if (returnContent) {
+        return {
+            fixed: true,
+            removed,
+            content: newContent,
+            message: `Would remove ${removed.length} duplicate(s)`,
+        };
+    }
+    // Dry run - report what would change
+    if (dryRun) {
+        return {
+            fixed: false,
+            removed,
+            dryRun: true,
+            message: `Would remove ${removed.length} duplicate(s)`,
+        };
+    }
+    // Create backup before modifying
+    const backupPath = `${backlogPath}.bak`;
+    copyFileSync(backlogPath, backupPath);
+    writeFileSync(backlogPath, newContent, { encoding: 'utf-8' });
+    return {
+        fixed: true,
+        removed,
+        backupPath,
+        message: `Removed ${removed.length} duplicate(s). Backup at ${backupPath}`,
+    };
+}
+//# sourceMappingURL=backlog-sync-validator.js.map

package/dist/backlog-sync-validator.js.map

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

package/dist/branch-check.d.ts

@@ -0,0 +1,63 @@
+import { type AgentPatternResult } from './agent-patterns-registry.js';
+/**
+ * Check if branch is an agent branch that can bypass worktree requirements.
+ *
+ * WU-1089: Now uses resolveAgentPatterns with proper merge/override/airgapped support:
+ * - Default: Fetches from registry (lumenflow.dev) with 7-day cache
+ * - Config patterns merge with registry patterns (config first)
+ * - Override patterns (agentBranchPatternsOverride) replace everything
+ * - Airgapped mode (disableAgentPatternRegistry) skips network fetch
+ *
+ * @param branch - Branch name to check
+ * @returns Promise<true> if branch matches agent patterns
+ *
+ * @example
+ * ```typescript
+ * if (await isAgentBranch('claude/session-123')) {
+ *   // Allow bypass for agent branch
+ * }
+ * ```
+ */
+export declare function isAgentBranch(branch: string | null | undefined): Promise<boolean>;
+/**
+ * Check if branch is an agent branch with full result details.
+ *
+ * Same as isAgentBranch but returns the full AgentPatternResult
+ * for observability and debugging.
+ *
+ * @param branch - Branch name to check
+ * @returns Promise with match result and pattern resolution details
+ *
+ * @example
+ * ```typescript
+ * const result = await isAgentBranchWithDetails('claude/session-123');
+ * if (result.isMatch) {
+ *   console.log(`Matched via ${result.patternResult.source}`);
+ *   console.log(`Registry fetched: ${result.patternResult.registryFetched}`);
+ * }
+ * ```
+ */
+export declare function isAgentBranchWithDetails(branch: string | null | undefined): Promise<{
+    isMatch: boolean;
+    patternResult: AgentPatternResult;
+}>;
+/**
+ * Synchronous version of isAgentBranch for backwards compatibility.
+ *
+ * Uses only local config patterns or defaults - does NOT fetch from registry.
+ * Prefer async isAgentBranch() when possible.
+ *
+ * WU-1089: Updated to respect override and disable flags, but cannot fetch from registry.
+ *
+ * @param branch - Branch name to check
+ * @returns True if branch matches agent patterns
+ *
+ * @deprecated Use async isAgentBranch() instead for registry support
+ */
+export declare function isAgentBranchSync(branch: string | null | undefined): boolean;
+/**
+ * Check if headless mode is allowed (guarded).
+ * Requires LUMENFLOW_HEADLESS=1 AND (LUMENFLOW_ADMIN=1 OR CI truthy OR GITHUB_ACTIONS truthy)
+ */
+export declare function isHeadlessAllowed(): boolean;
+//# sourceMappingURL=branch-check.d.ts.map

package/dist/branch-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-check.d.ts","sourceRoot":"","sources":["../src/branch-check.ts"],"names":[],"mappings":"AAgBA,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,8BAA8B,CAAC;AA8BtC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CA0BvF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAChC,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,kBAAkB,CAAA;CAAE,CAAC,CA+ClE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CA+B5E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAO3C"}