@lumenflow/core 3.2.0 → 3.2.2

package/dist/wu-state-store.js

@@ -0,0 +1,171 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * WU State Store - Facade (WU-2013, WU-2020)
+ *
+ * Thin facade delegating to: WUEventSourcer, WUStateIndexer,
+ * wu-lock-manager, wu-repair-service.
+ *
+ * WU-2020: Implements IWuStateStore port interface for DIP compliance.
+ * Command handlers should depend on IWuStateStore, not this concrete class.
+ * Use createWUStateStore() factory for new instances.
+ */
+import { validateWUEvent, WU_EVENT_TYPE } from './wu-state-schema.js';
+import { WU_STATUS } from './wu-constants.js';
+import { WUStateIndexer } from './wu-state-indexer.js';
+import { WUEventSourcer } from './wu-event-sourcer.js';
+// Re-export from extracted services for backward compatibility
+export { WU_EVENTS_FILE_NAME } from './wu-event-sourcer.js';
+export { isLockStale, acquireLock, releaseLock } from './wu-lock-manager.js';
+export { repairStateFile } from './wu-repair-service.js';
+/** Validate a WU event, throwing on failure. */
+function validateOrThrow(event) {
+    const validation = validateWUEvent(event);
+    if (!validation.success) {
+        const issues = validation.error.issues
+            .map((i) => `${i.path.join('.')}: ${i.message}`)
+            .join(', ');
+        throw new Error(`Validation error: ${issues}`);
+    }
+    return validation.data;
+}
+/** Assert WU is in_progress, throwing if not. */
+function assertInProgress(indexer, wuId) {
+    const s = indexer.getWUState(wuId);
+    if (!s || s.status !== WU_STATUS.IN_PROGRESS) {
+        throw new Error(`WU ${wuId} is not ${WU_STATUS.IN_PROGRESS}`);
+    }
+}
+/**
+ * WU State Store - event-sourced WU lifecycle state.
+ * Delegates to focused services for each responsibility.
+ *
+ * Implements IWuStateStore port interface (WU-2020) so consumers
+ * can depend on the interface instead of this concrete class.
+ */
+export class WUStateStore {
+    indexer;
+    sourcer;
+    constructor(baseDir) {
+        this.indexer = new WUStateIndexer();
+        this.sourcer = new WUEventSourcer(baseDir, this.indexer);
+    }
+    async load() {
+        await this.sourcer.load();
+    }
+    async appendAndApply(event) {
+        await this.sourcer.appendAndApply(event);
+    }
+    async claim(wuId, lane, title) {
+        const s = this.indexer.getWUState(wuId);
+        if (s && s.status === WU_STATUS.IN_PROGRESS) {
+            throw new Error(`WU ${wuId} is already ${WU_STATUS.IN_PROGRESS}`);
+        }
+        await this.sourcer.appendAndApply(validateOrThrow({
+            type: WU_EVENT_TYPE.CLAIM,
+            wuId,
+            lane,
+            title,
+            timestamp: new Date().toISOString(),
+        }));
+    }
+    async complete(wuId) {
+        assertInProgress(this.indexer, wuId);
+        await this.sourcer.appendAndApply(validateOrThrow({
+            type: WU_EVENT_TYPE.COMPLETE,
+            wuId,
+            timestamp: new Date().toISOString(),
+        }));
+    }
+    getWUState(wuId) {
+        return this.indexer.getWUState(wuId);
+    }
+    createCompleteEvent(wuId, timestamp = new Date().toISOString()) {
+        assertInProgress(this.indexer, wuId);
+        return validateOrThrow({ type: WU_EVENT_TYPE.COMPLETE, wuId, timestamp });
+    }
+    applyEvent(event) {
+        this.indexer.applyEvent(validateOrThrow(event));
+    }
+    async block(wuId, reason) {
+        assertInProgress(this.indexer, wuId);
+        await this.sourcer.appendAndApply(validateOrThrow({
+            type: WU_EVENT_TYPE.BLOCK,
+            wuId,
+            reason,
+            timestamp: new Date().toISOString(),
+        }));
+    }
+    async unblock(wuId) {
+        const s = this.indexer.getWUState(wuId);
+        if (!s || s.status !== WU_STATUS.BLOCKED) {
+            throw new Error(`WU ${wuId} is not ${WU_STATUS.BLOCKED}`);
+        }
+        await this.sourcer.appendAndApply(validateOrThrow({
+            type: WU_EVENT_TYPE.UNBLOCK,
+            wuId,
+            timestamp: new Date().toISOString(),
+        }));
+    }
+    async checkpoint(wuId, note, options = {}) {
+        const { sessionId, progress, nextSteps } = options;
+        const eventData = {
+            type: WU_EVENT_TYPE.CHECKPOINT,
+            wuId,
+            note,
+            timestamp: new Date().toISOString(),
+        };
+        if (sessionId)
+            eventData.sessionId = sessionId;
+        if (progress)
+            eventData.progress = progress;
+        if (nextSteps)
+            eventData.nextSteps = nextSteps;
+        await this.sourcer.appendAndApply(validateOrThrow(eventData));
+    }
+    getByStatus(status) {
+        return this.indexer.getByStatus(status);
+    }
+    getByLane(lane) {
+        return this.indexer.getByLane(lane);
+    }
+    getChildWUs(parentWuId) {
+        return this.indexer.getChildWUs(parentWuId);
+    }
+    async delegate(childWuId, parentWuId, delegationId) {
+        await this.sourcer.appendAndApply(validateOrThrow({
+            type: WU_EVENT_TYPE.DELEGATION,
+            wuId: childWuId,
+            parentWuId,
+            delegationId,
+            timestamp: new Date().toISOString(),
+        }));
+    }
+    async release(wuId, reason) {
+        assertInProgress(this.indexer, wuId);
+        await this.sourcer.appendAndApply(validateOrThrow({
+            type: WU_EVENT_TYPE.RELEASE,
+            wuId,
+            reason,
+            timestamp: new Date().toISOString(),
+        }));
+    }
+    createReleaseEvent(wuId, reason, timestamp = new Date().toISOString()) {
+        assertInProgress(this.indexer, wuId);
+        return validateOrThrow({ type: WU_EVENT_TYPE.RELEASE, wuId, reason, timestamp });
+    }
+}
+/**
+ * Factory function to create a WUStateStore instance (WU-2020).
+ *
+ * Command handlers should prefer this factory over direct `new WUStateStore()`
+ * to enable future swapping of implementations and easier testing.
+ * The return type is the IWuStateStore interface, not the concrete class.
+ *
+ * @param baseDir - Base directory for the state store (e.g., `.lumenflow/state`)
+ * @returns An IWuStateStore implementation
+ */
+export function createWUStateStore(baseDir) {
+    return new WUStateStore(baseDir);
+}
+//# sourceMappingURL=wu-state-store.js.map

package/dist/wu-state-store.js.map

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

package/dist/wu-status-transition.d.ts

@@ -0,0 +1,58 @@
+type TransitionDirection = 'block' | 'unblock';
+interface TransitionOptions {
+    id: string;
+    direction: TransitionDirection;
+    reason?: string;
+    worktreeOverride?: string;
+    removeWorktree?: boolean;
+    createWorktree?: boolean;
+    gitAdapter?: StatusTransitionGitAdapter;
+}
+interface TransitionResult {
+    id: string;
+    fromStatus: string;
+    toStatus: string;
+}
+interface StatusTransitionGitAdapter {
+    run(command: string): unknown;
+    removeWorktree(path: string): unknown;
+}
+/**
+ * Direction type for status transitions
+ * @typedef {'block' | 'unblock'} TransitionDirection
+ */
+/**
+ * Transition WU status between blocked and in_progress states
+ *
+ * @param {object} options - Transition options
+ * @param {string} options.id - WU ID (e.g., 'WU-100')
+ * @param {TransitionDirection} options.direction - Transition direction: 'block' or 'unblock'
+ * @param {string} [options.reason] - Reason for transition (optional)
+ * @param {string} [options.worktreeOverride] - Custom worktree path (optional)
+ * @param {boolean} [options.removeWorktree] - Remove worktree after blocking (default: false)
+ * @param {boolean} [options.createWorktree] - Create worktree after unblocking (default: false)
+ * @param {object} [options.gitAdapter] - Git adapter for testing (optional, defaults to getGitForCwd())
+ * @returns {{id: string, fromStatus: string, toStatus: string}} Transition result
+ * @throws {Error} If state transition is invalid or files not found
+ *
+ * @example
+ * // Block a WU
+ * transitionWUStatus({
+ *   id: 'WU-100',
+ *   direction: 'block',
+ *   reason: 'Blocked by WU-200',
+ *   removeWorktree: true
+ * });
+ *
+ * @example
+ * // Unblock a WU
+ * transitionWUStatus({
+ *   id: 'WU-100',
+ *   direction: 'unblock',
+ *   reason: 'Blocker resolved',
+ *   createWorktree: true
+ * });
+ */
+export declare function transitionWUStatus({ id, direction, reason, worktreeOverride, removeWorktree, createWorktree, gitAdapter, }: TransitionOptions): Promise<TransitionResult>;
+export {};
+//# sourceMappingURL=wu-status-transition.d.ts.map

package/dist/wu-status-transition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-status-transition.d.ts","sourceRoot":"","sources":["../src/wu-status-transition.ts"],"names":[],"mappings":"AA+BA,KAAK,mBAAmB,GAAG,OAAO,GAAG,SAAS,CAAC;AAE/C,UAAU,iBAAiB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,mBAAmB,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,0BAA0B,CAAC;CACzC;AAED,UAAU,gBAAgB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAWD,UAAU,0BAA0B;IAClC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACvC;AAED;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,wBAAsB,kBAAkB,CAAC,EACvC,EAAE,EACF,SAAS,EACT,MAAM,EACN,gBAAgB,EAChB,cAAsB,EACtB,cAAsB,EACtB,UAAU,GACX,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwF/C"}

package/dist/wu-status-transition.js

@@ -0,0 +1,370 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * WU Status Transition Module
+ *
+ * Shared logic for block/unblock status transitions.
+ * Eliminates 90% code duplication between wu-block.ts and wu-unblock.ts.
+ *
+ * Responsibilities:
+ * - Validate state transitions (via state-machine)
+ * - Update WU YAML status and notes
+ * - Sync backlog.md and status.md
+ * - Handle worktree creation/removal
+ *
+ * Created: WU-1340 (2025-11-29)
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { assertTransition } from './state-machine.js';
+// WU-1574: Removed BacklogManager - using state store + generator
+import { WUStateStore } from './wu-state-store.js';
+import { generateBacklog } from './backlog-generator.js';
+import { writeFile } from 'node:fs/promises';
+// backlog-parser imports removed (dead code after WU-1574 state store refactor)
+import { createError, ErrorCodes, getErrorMessage } from './error-handler.js';
+import { todayISO } from './date-utils.js';
+import { getStateStoreDirFromBacklog, WU_PATHS } from './wu-paths.js';
+import { readWU, writeWU, appendNote } from './wu-yaml.js';
+import { toKebab, REMOTES, BRANCHES, WU_STATUS, STRING_LITERALS } from './wu-constants.js';
+/**
+ * Direction type for status transitions
+ * @typedef {'block' | 'unblock'} TransitionDirection
+ */
+/**
+ * Transition WU status between blocked and in_progress states
+ *
+ * @param {object} options - Transition options
+ * @param {string} options.id - WU ID (e.g., 'WU-100')
+ * @param {TransitionDirection} options.direction - Transition direction: 'block' or 'unblock'
+ * @param {string} [options.reason] - Reason for transition (optional)
+ * @param {string} [options.worktreeOverride] - Custom worktree path (optional)
+ * @param {boolean} [options.removeWorktree] - Remove worktree after blocking (default: false)
+ * @param {boolean} [options.createWorktree] - Create worktree after unblocking (default: false)
+ * @param {object} [options.gitAdapter] - Git adapter for testing (optional, defaults to getGitForCwd())
+ * @returns {{id: string, fromStatus: string, toStatus: string}} Transition result
+ * @throws {Error} If state transition is invalid or files not found
+ *
+ * @example
+ * // Block a WU
+ * transitionWUStatus({
+ *   id: 'WU-100',
+ *   direction: 'block',
+ *   reason: 'Blocked by WU-200',
+ *   removeWorktree: true
+ * });
+ *
+ * @example
+ * // Unblock a WU
+ * transitionWUStatus({
+ *   id: 'WU-100',
+ *   direction: 'unblock',
+ *   reason: 'Blocker resolved',
+ *   createWorktree: true
+ * });
+ */
+// WU-1574: Made async for updateBacklogAndStatus
+export async function transitionWUStatus({ id, direction, reason, worktreeOverride, removeWorktree = false, createWorktree = false, gitAdapter, }) {
+    // Validate inputs
+    if (!id) {
+        throw createError(ErrorCodes.VALIDATION_ERROR, 'WU ID is required');
+    }
+    if (!direction || !['block', 'unblock'].includes(direction)) {
+        throw createError(ErrorCodes.VALIDATION_ERROR, `Invalid direction: ${direction}. Must be 'block' or 'unblock'`);
+    }
+    // Resolve paths
+    const paths = {
+        wu: WU_PATHS.WU(id),
+        status: WU_PATHS.STATUS(),
+        backlog: WU_PATHS.BACKLOG(),
+    };
+    // Validate files exist
+    if (!existsSync(paths.wu)) {
+        throw createError(ErrorCodes.FILE_NOT_FOUND, `WU file not found: ${paths.wu}`, {
+            path: paths.wu,
+            id,
+        });
+    }
+    if (!existsSync(paths.backlog)) {
+        throw createError(ErrorCodes.FILE_NOT_FOUND, `Missing ${paths.backlog}`, {
+            path: paths.backlog,
+        });
+    }
+    if (!existsSync(paths.status)) {
+        throw createError(ErrorCodes.FILE_NOT_FOUND, `Missing ${paths.status}`, {
+            path: paths.status,
+        });
+    }
+    // Read WU document
+    const doc = readWU(paths.wu, id);
+    const title = typeof doc.title === 'string' ? doc.title : '';
+    const currentStatus = typeof doc.status === 'string' ? doc.status : WU_STATUS.IN_PROGRESS;
+    // Determine target status
+    const toStatus = direction === 'block' ? WU_STATUS.BLOCKED : WU_STATUS.IN_PROGRESS;
+    // Validate state transition (may throw if invalid)
+    try {
+        assertTransition(currentStatus, toStatus, id);
+    }
+    catch (error) {
+        const originalError = getErrorMessage(error);
+        // If already in target state, make operation idempotent (don't throw)
+        if (currentStatus === toStatus) {
+            console.warn(`[wu-status-transition] WU ${id} already ${toStatus}, skipping transition (idempotent)`);
+            return { id, fromStatus: currentStatus, toStatus };
+        }
+        // Re-throw validation errors
+        throw createError(ErrorCodes.STATE_ERROR, `State transition validation failed: ${originalError}`, { id, fromStatus: currentStatus, toStatus, originalError });
+    }
+    // Update WU YAML
+    doc.status = toStatus;
+    const noteLine = createNoteEntry(direction, reason);
+    appendNote(doc, noteLine);
+    writeWU(paths.wu, doc);
+    // Update backlog.md and status.md (WU-1574: now async)
+    await updateBacklogAndStatus(paths, id, title, currentStatus, toStatus, direction, reason);
+    // Handle worktree operations (only if gitAdapter provided)
+    if (gitAdapter) {
+        if (direction === 'block' && removeWorktree) {
+            handleWorktreeRemoval(doc, worktreeOverride, gitAdapter);
+        }
+        else if (direction === 'unblock' && createWorktree) {
+            handleWorktreeCreation(doc, worktreeOverride, gitAdapter);
+        }
+    }
+    return {
+        id,
+        fromStatus: currentStatus,
+        toStatus,
+    };
+}
+/**
+ * Create note entry for transition
+ *
+ * @private
+ * @param {TransitionDirection} direction - Transition direction
+ * @param {string} [reason] - Transition reason
+ * @returns {string} Note text
+ */
+function createNoteEntry(direction, reason) {
+    const action = direction === 'block' ? 'Blocked' : 'Unblocked';
+    const date = todayISO();
+    return reason ? `${action} (${date}): ${reason}` : `${action} (${date})`;
+}
+/**
+ * Update backlog.md and status.md files
+ *
+ * @private
+ * @param {object} paths - File paths
+ * @param {string} id - WU ID
+ * @param {string} title - WU title
+ * @param {string} fromStatus - Current status
+ * @param {string} toStatus - Target status
+ * @param {TransitionDirection} direction - Transition direction
+ * @param {string} [reason] - Transition reason
+ */
+// WU-1574: Made async for generateBacklog
+async function updateBacklogAndStatus(paths, id, title, fromStatus, toStatus, direction, reason) {
+    // WU-1574: Section variables removed - backlog is now fully regenerated from state store
+    // WU-1574: Regenerate backlog.md from state store (replaces BacklogManager)
+    const stateDir = getStateStoreDirFromBacklog(paths.backlog);
+    const store = new WUStateStore(stateDir);
+    await store.load();
+    const content = await generateBacklog(store);
+    await writeFile(paths.backlog, content, 'utf-8');
+    // Update status.md
+    updateStatusFile(paths.status, id, title, direction, reason);
+}
+/**
+ * Update status.md file
+ *
+ * @private
+ * @param {string} statusPath - Path to status.md
+ * @param {string} id - WU ID
+ * @param {string} title - WU title
+ * @param {TransitionDirection} direction - Transition direction
+ * @param {string} [reason] - Transition reason
+ */
+function updateStatusFile(statusPath, id, title, direction, reason) {
+    const rel = `wu/${id}.yaml`;
+    const lines = readFileSync(statusPath, { encoding: 'utf-8' }).split(/\r?\n/);
+    const findHeader = (h) => lines.findIndex((l) => l.trim().toLowerCase() === h.toLowerCase());
+    const inProgIdx = findHeader('## in progress');
+    const blockedIdx = findHeader('## blocked');
+    if (direction === 'block') {
+        // Remove from In Progress
+        removeFromSection(lines, inProgIdx, rel, id);
+        // Add to Blocked
+        if (blockedIdx !== -1) {
+            const reasonSuffix = reason ? ` — ${reason}` : '';
+            const bullet = `- [${id} — ${title}](${rel})${reasonSuffix}`;
+            const sectionStart = blockedIdx + 1;
+            // Check if already exists (idempotent)
+            if (!lines.slice(sectionStart).some((l) => l.includes(rel))) {
+                lines.splice(sectionStart, 0, '', bullet);
+            }
+        }
+    }
+    else {
+        // Remove from Blocked
+        removeFromSection(lines, blockedIdx, rel, id);
+        // Add to In Progress
+        if (inProgIdx !== -1) {
+            const bullet = `- [${id} — ${title}](${rel})`;
+            const sectionStart = inProgIdx + 1;
+            // Remove "No items" placeholder if present
+            let endIdx = lines.slice(sectionStart).findIndex((l) => l.startsWith('## '));
+            if (endIdx === -1)
+                endIdx = lines.length - sectionStart;
+            else
+                endIdx = sectionStart + endIdx;
+            for (let i = sectionStart; i < endIdx; i++) {
+                const line = lines[i];
+                if (line && line.includes('No items currently in progress')) {
+                    lines.splice(i, 1);
+                    endIdx--;
+                    break;
+                }
+            }
+            // Check if already exists (idempotent)
+            if (!lines.slice(sectionStart, endIdx).some((l) => l.includes(rel))) {
+                lines.splice(sectionStart, 0, '', bullet);
+            }
+        }
+    }
+    writeFileSync(statusPath, lines.join(STRING_LITERALS.NEWLINE), { encoding: 'utf-8' });
+}
+/**
+ * Remove WU entry from section in status.md
+ *
+ * @private
+ * @param {string[]} lines - File lines
+ * @param {number} sectionIdx - Section header index
+ * @param {string} rel - Relative WU path
+ * @param {string} id - WU ID
+ */
+function removeFromSection(lines, sectionIdx, rel, id) {
+    if (sectionIdx === -1)
+        return;
+    let i = sectionIdx + 1;
+    while (i < lines.length) {
+        const line = lines[i];
+        if (!line) {
+            i++;
+            continue;
+        }
+        if (line.startsWith('## '))
+            break;
+        if (line.includes(rel) || line.includes(`[${id}`)) {
+            lines.splice(i, 1);
+            continue;
+        }
+        i++;
+    }
+}
+/**
+ * Handle worktree removal after blocking
+ *
+ * @private
+ * @param {object} doc - WU document
+ * @param {string} [worktreeOverride] - Custom worktree path
+ * @param {object} gitAdapter - Git adapter
+ */
+function handleWorktreeRemoval(doc, worktreeOverride, gitAdapter) {
+    const wt = worktreeOverride || defaultWorktreeFrom(doc);
+    if (wt && existsSync(wt)) {
+        try {
+            gitAdapter.removeWorktree(wt);
+        }
+        catch (e) {
+            console.warn(`[wu-status-transition] Could not remove worktree ${wt}: ${getErrorMessage(e)}`);
+        }
+    }
+    else if (wt) {
+        console.warn('[wu-status-transition] Worktree path not found; skipping removal');
+    }
+    else {
+        console.warn('[wu-status-transition] No worktree path specified; skipping removal');
+    }
+}
+/**
+ * Handle worktree creation after unblocking
+ *
+ * @private
+ * @param {object} doc - WU document
+ * @param {string} [worktreeOverride] - Custom worktree path
+ * @param {object} gitAdapter - Git adapter
+ */
+function handleWorktreeCreation(doc, worktreeOverride, gitAdapter) {
+    const worktreePath = worktreeOverride || defaultWorktreeFrom(doc);
+    const branchName = defaultBranchFrom(doc);
+    if (!branchName) {
+        console.warn('[wu-status-transition] Cannot derive branch name; skipping worktree creation');
+        return;
+    }
+    if (!worktreePath) {
+        console.warn('[wu-status-transition] Worktree path required; skipping creation');
+        return;
+    }
+    if (existsSync(worktreePath)) {
+        console.warn(`[wu-status-transition] Worktree ${worktreePath} already exists; skipping creation`);
+        return;
+    }
+    gitAdapter.run(`git fetch ${REMOTES.ORIGIN} ${BRANCHES.MAIN}`);
+    if (branchExists(branchName, gitAdapter)) {
+        gitAdapter.run(`git worktree add ${JSON.stringify(worktreePath)} ${JSON.stringify(branchName)}`);
+    }
+    else {
+        gitAdapter.run(`git worktree add ${JSON.stringify(worktreePath)} -b ${JSON.stringify(branchName)} ${REMOTES.ORIGIN}/${BRANCHES.MAIN}`);
+    }
+}
+/**
+ * Derive default worktree path from WU document
+ *
+ * @private
+ * @param {object} doc - WU document
+ * @returns {string | null} Worktree path
+ */
+function defaultWorktreeFrom(doc) {
+    const lane = (doc.lane || '').toString();
+    const laneK = lane
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    const idK = (doc.id || '').toLowerCase();
+    if (!laneK || !idK)
+        return null;
+    return `worktrees/${laneK}-${idK}`;
+}
+/**
+ * Derive default branch name from WU document
+ *
+ * @private
+ * @param {object} doc - WU document
+ * @returns {string | null} Branch name
+ */
+function defaultBranchFrom(doc) {
+    const lane = (doc.lane || '').toString();
+    const laneK = toKebab(lane);
+    const idK = (doc.id || '').toLowerCase();
+    if (!laneK || !idK)
+        return null;
+    return `lane/${laneK}/${idK}`;
+}
+/**
+ * Check if git branch exists
+ *
+ * @private
+ * @param {string} branch - Branch name
+ * @param {object} gitAdapter - Git adapter
+ * @returns {boolean} True if branch exists
+ */
+function branchExists(branch, gitAdapter) {
+    try {
+        gitAdapter.run(`git rev-parse --verify ${JSON.stringify(branch)}`);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=wu-status-transition.js.map

package/dist/wu-status-transition.js.map

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

package/dist/wu-status-updater.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Remove WU from In Progress section (idempotent)
+ * Refactored from wu-done.ts line 471 to use frontmatter headings
+ *
+ * @param {string} statusPath - Path to status.md
+ * @param {string} id - WU ID
+ */
+export declare function updateStatusRemoveInProgress(statusPath: UnsafeAny, id: UnsafeAny): void;
+/**
+ * Add WU to Completed section (idempotent - checks for duplicates)
+ * Refactored from wu-done.ts line 499 to use frontmatter headings
+ *
+ * @param {string} statusPath - Path to status.md
+ * @param {string} id - WU ID
+ * @param {string} title - WU title
+ */
+export declare function addToStatusCompleted(statusPath: UnsafeAny, id: UnsafeAny, title: UnsafeAny): void;
+//# sourceMappingURL=wu-status-updater.d.ts.map

package/dist/wu-status-updater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-status-updater.d.ts","sourceRoot":"","sources":["../src/wu-status-updater.ts"],"names":[],"mappings":"AAmBA;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,QAwDhF;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,QAoD1F"}