@lumenflow/cli 3.8.6 → 3.9.0

package/dist/wu-done-mode-execution.js

@@ -0,0 +1,136 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import { createGitForPath } from '@lumenflow/core/git-adapter';
+import { executeBranchOnlyCompletion, executeBranchPRCompletion, } from '@lumenflow/core/wu-done-branch-only';
+import { executeWorktreeCompletion } from '@lumenflow/core/wu-done-worktree';
+import { detectAlreadyMergedNoWorktree } from '@lumenflow/core/wu-done-merged-worktree';
+import { releaseLaneLock } from '@lumenflow/core/lane-lock';
+import { getErrorMessage } from '@lumenflow/core/error-handler';
+import { EMOJI, EXIT_CODES, LOG_PREFIX } from '@lumenflow/core/wu-constants';
+import { WU_DONE_EVENTS } from '@lumenflow/core/wu-done-machine';
+/**
+ * WU-2167: Execute mode-specific wu:done completion while keeping main() as a thin orchestrator.
+ */
+export async function executeModeSpecificCompletion({ id, args, docMain, title, isDocsOnly, maxCommitLength, isBranchPR, effectiveBranchOnly, worktreePath, resolvedWorktreePath, pipelineActor, validateStagedFiles, defaultBranchFrom, executeAlreadyMergedFinalize, recordTransactionState, rollbackTransaction, }) {
+    const completionResult = { cleanupSafe: true };
+    const baseContext = {
+        id,
+        args,
+        docMain,
+        title,
+        isDocsOnly,
+        maxCommitLength,
+        validateStagedFiles,
+    };
+    try {
+        let modeCompletionResult;
+        if (isBranchPR) {
+            const laneBranch = defaultBranchFrom(docMain);
+            const branchPRContext = {
+                ...baseContext,
+                laneBranch,
+            };
+            modeCompletionResult = await executeBranchPRCompletion(branchPRContext);
+        }
+        else if (effectiveBranchOnly) {
+            const branchOnlyContext = {
+                ...baseContext,
+                recordTransactionState,
+                rollbackTransaction,
+            };
+            modeCompletionResult = await executeBranchOnlyCompletion(branchOnlyContext);
+        }
+        else {
+            if (!worktreePath) {
+                const laneBranch = defaultBranchFrom(docMain);
+                const mergedDetection = await detectAlreadyMergedNoWorktree({
+                    wuId: id,
+                    laneBranch: laneBranch || '',
+                    worktreePath: resolvedWorktreePath,
+                });
+                if (mergedDetection.merged && !mergedDetection.worktreeExists) {
+                    console.log(`${LOG_PREFIX.DONE} ${EMOJI.INFO} WU-1746: Worktree missing but branch already merged to main`);
+                    const mergedTitle = title || String(docMain.title || id);
+                    const mergedResult = await executeAlreadyMergedFinalize({
+                        id,
+                        title: mergedTitle,
+                        lane: String(docMain.lane || ''),
+                        doc: docMain,
+                    });
+                    modeCompletionResult = {
+                        success: mergedResult.success,
+                        committed: true,
+                        pushed: true,
+                        merged: true,
+                        cleanupSafe: true,
+                    };
+                }
+                else {
+                    throw new Error(`Missing worktree path for ${id} completion in worktree mode`);
+                }
+            }
+            else {
+                const worktreeGitForValidation = createGitForPath(worktreePath);
+                const worktreeContext = {
+                    ...baseContext,
+                    worktreePath,
+                    validateStagedFiles: (wuId, docsOnly, options) => validateStagedFiles(wuId, docsOnly, worktreeGitForValidation, options),
+                };
+                modeCompletionResult = await executeWorktreeCompletion(worktreeContext);
+            }
+        }
+        pipelineActor.send({ type: WU_DONE_EVENTS.COMMIT_COMPLETE });
+        pipelineActor.send({ type: WU_DONE_EVENTS.MERGE_COMPLETE });
+        pipelineActor.send({ type: WU_DONE_EVENTS.PUSH_COMPLETE });
+        if ('recovered' in modeCompletionResult && modeCompletionResult.recovered) {
+            try {
+                const lane = docMain.lane;
+                if (lane)
+                    releaseLaneLock(lane, { wuId: id });
+            }
+            catch {
+                // Ignore lock release errors during cleanup path
+            }
+            pipelineActor.stop();
+            process.exit(EXIT_CODES.SUCCESS);
+        }
+        return modeCompletionResult;
+    }
+    catch (err) {
+        const failureStage = completionResult.committed === false
+            ? WU_DONE_EVENTS.COMMIT_FAILED
+            : completionResult.merged === false
+                ? WU_DONE_EVENTS.MERGE_FAILED
+                : completionResult.pushed === false
+                    ? WU_DONE_EVENTS.PUSH_FAILED
+                    : WU_DONE_EVENTS.COMMIT_FAILED;
+        pipelineActor.send({
+            type: failureStage,
+            error: getErrorMessage(err),
+        });
+        const failedSnapshot = pipelineActor.getSnapshot();
+        console.error(`${LOG_PREFIX.DONE} Pipeline state: ${failedSnapshot.value} (failedAt: ${failedSnapshot.context.failedAt})`);
+        pipelineActor.stop();
+        try {
+            const lane = docMain.lane;
+            if (lane)
+                releaseLaneLock(lane, { wuId: id });
+        }
+        catch {
+            // Ignore lock release errors during failure path
+        }
+        console.error(`\n${LOG_PREFIX.DONE} ${EMOJI.FAILURE} Mode execution failed: ${getErrorMessage(err)}`);
+        console.error(`${LOG_PREFIX.DONE} ${EMOJI.INFO} Next step: resolve the reported error and retry: pnpm wu:done --id ${id}`);
+        const cleanupSafe = typeof err === 'object' &&
+            err !== null &&
+            'cleanupSafe' in err &&
+            typeof err.cleanupSafe === 'boolean'
+            ? err.cleanupSafe
+            : undefined;
+        if (cleanupSafe === false) {
+            console.log(`\n${LOG_PREFIX.DONE} ${EMOJI.WARNING} WU-1811: Worktree preserved - rerun wu:done to recover`);
+        }
+        process.exit(EXIT_CODES.ERROR);
+    }
+}
+//# sourceMappingURL=wu-done-mode-execution.js.map

package/dist/wu-done-mode-execution.js.map

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

package/dist/wu-done-policies.js

@@ -2,13 +2,19 @@
 // SPDX-License-Identifier: AGPL-3.0-only
 import { getDocsOnlyPrefixes, DOCS_ONLY_ROOT_FILES } from '@lumenflow/core';
 import { DelegationRegistryStore } from '@lumenflow/core/delegation-registry-store';
+import { getConfig } from '@lumenflow/core/config';
 import { die, getErrorMessage } from '@lumenflow/core/error-handler';
 import { isDocumentationType } from '@lumenflow/core/wu-type-helpers';
 import { CLI_FLAGS, EMOJI, LOG_PREFIX, PKG_MANAGER, SCRIPTS, WU_EXPOSURE, WU_TYPES, } from '@lumenflow/core/wu-constants';
-import { getLatestWuBriefEvidence } from '@lumenflow/core/wu-state-store';
+import { getLatestWuBriefEvidence, getWuBriefEvidenceAgeMinutes, isWuBriefEvidenceStale, WUStateStore, } from '@lumenflow/core/wu-state-store';
 import { validateExposure, validateFeatureAccessibility } from '@lumenflow/core/wu-validation';
 import { createSignal } from '@lumenflow/memory/signal';
 import { resolveStateDir } from './state-path-resolvers.js';
+export const WU_BRIEF_POLICY_MODES = ['off', 'manual', 'auto', 'required'];
+const DEFAULT_WU_BRIEF_POLICY_MODE = 'auto';
+const DEFAULT_WU_BRIEF_FRESHNESS_MINUTES = 1440;
+const PREP_LOG_PREFIX = '[wu-prep]';
+const PREP_FORCE_REASON_REQUIRED_MESSAGE = 'Missing required --reason for wu:brief policy bypass in wu:prep.';
 /**
  * WU-1999: Print exposure validation warnings.
  *
@@ -118,6 +124,31 @@ export function buildGatesCommand(options) {
 export function shouldEnforceWuBriefEvidence(doc) {
     return doc.type === WU_TYPES.FEATURE || doc.type === WU_TYPES.BUG;
 }
+function isWuBriefPolicyMode(value) {
+    return (typeof value === 'string' &&
+        WU_BRIEF_POLICY_MODES.includes(value));
+}
+export function resolveWuBriefPolicyMode(config = getConfig()) {
+    const configured = config.wu?.brief?.policyMode;
+    if (isWuBriefPolicyMode(configured)) {
+        return configured;
+    }
+    return DEFAULT_WU_BRIEF_POLICY_MODE;
+}
+/**
+ * Resolve wu:brief freshness threshold in minutes.
+ * 0 disables freshness checks.
+ */
+export function resolveWuBriefFreshnessMinutes(config = getConfig()) {
+    const configured = config.wu?.brief?.freshnessMinutes;
+    if (typeof configured === 'number' && Number.isFinite(configured)) {
+        if (configured <= 0) {
+            return null;
+        }
+        return Math.floor(configured);
+    }
+    return DEFAULT_WU_BRIEF_FRESHNESS_MINUTES;
+}
 /**
  * Build remediation guidance when wu:brief evidence is missing.
  */
@@ -134,6 +165,145 @@ export function buildMissingWuBriefEvidenceMessage(id) {
         `  4. Legacy/manual override (audited):\n` +
         `     pnpm wu:done --id ${id} --force`);
 }
+export function buildMissingWuBriefEvidenceMessageForPrep(id, mode) {
+    return (`Missing wu:brief evidence for ${id} (policy=${mode}).\n\n` +
+        `wu:prep enforces wu:brief evidence when policy mode is required.\n\n` +
+        `Fix options:\n` +
+        `  1. Record evidence by generating a brief prompt:\n` +
+        `     pnpm wu:brief --id ${id}\n` +
+        `  2. If self-implementing, record evidence only:\n` +
+        `     pnpm wu:brief --id ${id} --evidence-only\n` +
+        `  3. Retry prep:\n` +
+        `     pnpm wu:prep --id ${id}\n` +
+        `  4. Emergency audited bypass (requires explicit reason):\n` +
+        `     pnpm wu:prep --id ${id} --force --reason "<why bypass is required>"`);
+}
+function describeWuBriefFreshness(evidenceTimestamp, freshnessMinutes, now) {
+    const ageMinutes = getWuBriefEvidenceAgeMinutes(evidenceTimestamp, now);
+    if (ageMinutes === null) {
+        return `Evidence timestamp is invalid: ${evidenceTimestamp}`;
+    }
+    return `Evidence age is ${ageMinutes} minute(s); threshold is ${freshnessMinutes} minute(s).`;
+}
+function buildStaleWuBriefEvidenceMessageForPrep(options) {
+    return (`Stale wu:brief evidence for ${options.id} (policy=${options.mode}).\n\n` +
+        `${describeWuBriefFreshness(options.evidenceTimestamp, options.freshnessMinutes, options.now)}\n\n` +
+        `Fix options:\n` +
+        `  1. Refresh evidence:\n` +
+        `     pnpm wu:brief --id ${options.id}\n` +
+        `  2. If self-implementing, refresh evidence only:\n` +
+        `     pnpm wu:brief --id ${options.id} --evidence-only\n` +
+        `  3. Retry prep:\n` +
+        `     pnpm wu:prep --id ${options.id}\n` +
+        `  4. Emergency audited bypass (requires explicit reason):\n` +
+        `     pnpm wu:prep --id ${options.id} --force --reason "<why stale evidence bypass is required>"`);
+}
+function buildStaleWuBriefEvidenceMessageForDone(options) {
+    return (`Stale wu:brief evidence for ${options.id} (policy=${options.mode}).\n\n` +
+        `${describeWuBriefFreshness(options.evidenceTimestamp, options.freshnessMinutes, options.now)}\n\n` +
+        `Fix options:\n` +
+        `  1. Refresh evidence:\n` +
+        `     pnpm wu:brief --id ${options.id}\n` +
+        `  2. If self-implementing, refresh evidence only:\n` +
+        `     pnpm wu:brief --id ${options.id} --evidence-only\n` +
+        `  3. Retry completion:\n` +
+        `     pnpm wu:done --id ${options.id}\n` +
+        `  4. Legacy/manual override (audited):\n` +
+        `     pnpm wu:done --id ${options.id} --force`);
+}
+export async function recordWuBriefPrepBypassAudit(options) {
+    const baseDir = options.baseDir ?? process.cwd();
+    const stateDir = resolveStateDir(baseDir);
+    const store = new WUStateStore(stateDir);
+    await store.checkpoint(options.wuId, `[wu:brief] prep force bypass accepted (${options.policyMode}): ${options.reason}`, {
+        progress: 'wu:brief policy bypass',
+        nextSteps: `policy=${options.policyMode}`,
+    });
+}
+export async function enforceWuBriefEvidenceForPrep(id, doc, options = {}) {
+    if (!shouldEnforceWuBriefEvidence(doc)) {
+        return;
+    }
+    const mode = options.mode ?? resolveWuBriefPolicyMode();
+    if (mode === 'off' || mode === 'manual') {
+        return;
+    }
+    const baseDir = options.baseDir ?? process.cwd();
+    const stateDir = resolveStateDir(baseDir);
+    const force = options.force === true;
+    const getBriefEvidenceFn = options.getBriefEvidenceFn ?? getLatestWuBriefEvidence;
+    const blocker = options.blocker ?? ((message) => die(message));
+    const warn = options.warn ?? console.warn;
+    const recordBypassAudit = options.recordBypassAudit ?? recordWuBriefPrepBypassAudit;
+    const freshnessMinutes = options.freshnessMinutes === undefined
+        ? resolveWuBriefFreshnessMinutes()
+        : options.freshnessMinutes;
+    const now = options.now ?? new Date();
+    let evidence;
+    try {
+        evidence = await getBriefEvidenceFn(stateDir, id);
+    }
+    catch (error) {
+        if (mode === 'required' && !force) {
+            blocker(buildWuBriefEvidenceReadFailureMessage(id, stateDir, error));
+            return;
+        }
+        warn(`${PREP_LOG_PREFIX} ${EMOJI.WARNING} Could not verify wu:brief evidence for ${id}: ${getErrorMessage(error)}`);
+        return;
+    }
+    if (evidence &&
+        freshnessMinutes !== null &&
+        isWuBriefEvidenceStale({ timestamp: evidence.timestamp, freshnessMinutes, now })) {
+        if (mode === 'auto') {
+            warn(`${PREP_LOG_PREFIX} ${EMOJI.WARNING} wu:brief evidence stale for ${id} (policy=auto).`);
+            warn(buildStaleWuBriefEvidenceMessageForPrep({
+                id,
+                mode,
+                evidenceTimestamp: evidence.timestamp,
+                freshnessMinutes,
+                now,
+            }));
+            return;
+        }
+        if (!force) {
+            blocker(buildStaleWuBriefEvidenceMessageForPrep({
+                id,
+                mode,
+                evidenceTimestamp: evidence.timestamp,
+                freshnessMinutes,
+                now,
+            }));
+            return;
+        }
+        const reason = typeof options.reason === 'string' ? options.reason.trim() : '';
+        if (!reason) {
+            blocker(PREP_FORCE_REASON_REQUIRED_MESSAGE);
+            return;
+        }
+        await recordBypassAudit({ wuId: id, baseDir, reason, policyMode: mode });
+        warn(`${PREP_LOG_PREFIX} ${EMOJI.WARNING} wu:brief policy override accepted for ${id} (policy=${mode}, reason="${reason}").`);
+        return;
+    }
+    if (evidence) {
+        return;
+    }
+    if (mode === 'auto') {
+        warn(`${PREP_LOG_PREFIX} ${EMOJI.WARNING} wu:brief evidence missing for ${id} (policy=auto).`);
+        warn(buildMissingWuBriefEvidenceMessageForPrep(id, mode));
+        return;
+    }
+    if (!force) {
+        blocker(buildMissingWuBriefEvidenceMessageForPrep(id, mode));
+        return;
+    }
+    const reason = typeof options.reason === 'string' ? options.reason.trim() : '';
+    if (!reason) {
+        blocker(PREP_FORCE_REASON_REQUIRED_MESSAGE);
+        return;
+    }
+    await recordBypassAudit({ wuId: id, baseDir, reason, policyMode: mode });
+    warn(`${PREP_LOG_PREFIX} ${EMOJI.WARNING} wu:brief policy override accepted for ${id} (policy=${mode}, reason="${reason}").`);
+}
 function buildWuBriefEvidenceReadFailureMessage(id, stateDir, error) {
     return (`Could not verify wu:brief evidence for ${id}.\n\n` +
         `State path: ${stateDir}\n` +
@@ -147,7 +317,12 @@ export async function enforceWuBriefEvidenceForDone(id, doc, options = {}) {
         return;
     }
     const baseDir = options.baseDir ?? process.cwd();
+    const mode = options.mode ?? resolveWuBriefPolicyMode();
     const force = options.force === true;
+    const freshnessMinutes = options.freshnessMinutes === undefined
+        ? resolveWuBriefFreshnessMinutes()
+        : options.freshnessMinutes;
+    const now = options.now ?? new Date();
     const stateDir = resolveStateDir(baseDir);
     const getBriefEvidenceFn = options.getBriefEvidenceFn ?? getLatestWuBriefEvidence;
     const blocker = options.blocker ?? ((message) => die(message));
@@ -164,6 +339,36 @@ export async function enforceWuBriefEvidenceForDone(id, doc, options = {}) {
         warn(`${LOG_PREFIX.DONE} ${EMOJI.WARNING} WU-2132: brief evidence verification failed for ${id}, override accepted via --force`);
         return;
     }
+    if (evidence &&
+        freshnessMinutes !== null &&
+        isWuBriefEvidenceStale({ timestamp: evidence.timestamp, freshnessMinutes, now })) {
+        if (mode === 'off' || mode === 'manual') {
+            return;
+        }
+        if (mode === 'auto') {
+            warn(`${LOG_PREFIX.DONE} ${EMOJI.WARNING} WU-2289: stale wu:brief evidence for ${id}`);
+            warn(buildStaleWuBriefEvidenceMessageForDone({
+                id,
+                mode,
+                evidenceTimestamp: evidence.timestamp,
+                freshnessMinutes,
+                now,
+            }));
+            return;
+        }
+        if (!force) {
+            blocker(buildStaleWuBriefEvidenceMessageForDone({
+                id,
+                mode,
+                evidenceTimestamp: evidence.timestamp,
+                freshnessMinutes,
+                now,
+            }));
+            return;
+        }
+        warn(`${LOG_PREFIX.DONE} ${EMOJI.WARNING} WU-2289: stale brief evidence override accepted for ${id} via --force`);
+        return;
+    }
     if (evidence) {
         return;
     }

package/dist/wu-done-policies.js.map

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

package/dist/wu-done-preflight.js

@@ -0,0 +1,207 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import { appendFileSync, existsSync, mkdirSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { validateBacklogSync } from '@lumenflow/core/backlog-sync-validator';
+import { die, getErrorMessage } from '@lumenflow/core/error-handler';
+import { resolveWuDonePreCommitGateDecision } from '@lumenflow/core/gates-agent-mode';
+import { getGitForCwd } from '@lumenflow/core/git-adapter';
+import { buildPreflightErrorMessage, runPreflightTasksValidation, validateAllPreCommitHooks, } from '@lumenflow/core/wu-done-validators';
+import { EMOJI, ENV_VARS, FILE_SYSTEM, LOG_PREFIX } from '@lumenflow/core/wu-constants';
+import { WUStateStore } from '@lumenflow/core/wu-state-store';
+import { WU_PATHS } from '@lumenflow/core/wu-paths';
+import { parseYAML } from '@lumenflow/core/wu-yaml';
+import { resolveStateDir } from './state-path-resolvers.js';
+const GIT_CONFIG_USER_EMAIL = 'user.email';
+export function computeBranchOnlyFallback({ isBranchOnly, branchOnlyRequested, worktreeExists, derivedWorktree, }) {
+    const allowFallback = Boolean(branchOnlyRequested) && !isBranchOnly && !worktreeExists && Boolean(derivedWorktree);
+    return {
+        allowFallback,
+        effectiveBranchOnly: isBranchOnly || allowFallback,
+    };
+}
+/**
+ * WU-1234: Normalize username for ownership comparison
+ * Extracts username from email address for comparison.
+ */
+export function normalizeUsername(value) {
+    if (!value)
+        return '';
+    const str = String(value).trim();
+    const atIndex = str.indexOf('@');
+    const username = atIndex > 0 ? str.slice(0, atIndex) : str;
+    return username.toLowerCase();
+}
+/**
+ * WU-1234: Pre-flight check for backlog state consistency.
+ */
+export function checkBacklogConsistencyForWU(id, backlogPath) {
+    try {
+        const result = validateBacklogSync(backlogPath);
+        if (!result.valid) {
+            for (const error of result.errors) {
+                if (error.includes('Done and In Progress') && error.includes(id)) {
+                    return {
+                        valid: false,
+                        error: `❌ BACKLOG STATE INCONSISTENCY: ${id} found in both Done and In Progress sections.\n\n` +
+                            `This is an invalid state that must be fixed manually before wu:done can proceed.\n\n` +
+                            `Fix options:\n` +
+                            `  1. If ${id} is truly done: Remove from In Progress in backlog.md\n` +
+                            `  2. If ${id} needs more work: Remove from Done in backlog.md, update WU YAML status\n\n` +
+                            `After fixing backlog.md, retry: pnpm wu:done --id ${id}`,
+                    };
+                }
+            }
+        }
+        return { valid: true, error: null };
+    }
+    catch (e) {
+        console.warn(`${LOG_PREFIX.DONE} Warning: Could not validate backlog consistency: ${getErrorMessage(e)}`);
+        return { valid: true, error: null };
+    }
+}
+export async function appendClaimSessionOverrideAuditEvent({ wuId, claimedSessionId, activeSessionId, reason, worktreePath, }) {
+    const stateDir = resolveStateDir(worktreePath);
+    const stateStore = new WUStateStore(stateDir);
+    await stateStore.load();
+    await stateStore.checkpoint(wuId, `[wu:done] force ownership override claimed_session=${claimedSessionId} active_session=${activeSessionId || 'none'}`, {
+        progress: 'wu:done ownership override',
+        nextSteps: reason,
+    });
+}
+export async function checkOwnership(id, doc, worktreePath, overrideOwner = false, overrideReason = null) {
+    if (!worktreePath || !existsSync(worktreePath)) {
+        return {
+            valid: false,
+            error: `Missing worktree for ${id}.\n\n` +
+                `Expected worktree at: ${worktreePath || 'unknown'}\n\n` +
+                `Worktrees are required for proper WU completion in Worktree mode.\n` +
+                `If the worktree was removed, recreate it and retry, or use --skip-gates with justification.`,
+            auditEntry: null,
+        };
+    }
+    let assignedTo = doc.assigned_to || null;
+    if (!assignedTo && worktreePath) {
+        const wtWUPath = path.join(worktreePath, WU_PATHS.WU(id));
+        if (existsSync(wtWUPath)) {
+            try {
+                const text = readFileSync(wtWUPath, { encoding: FILE_SYSTEM.UTF8 });
+                const wtDoc = parseYAML(text);
+                assignedTo = wtDoc?.assigned_to || null;
+                if (assignedTo) {
+                    console.log(`${LOG_PREFIX.DONE} Note: Read assigned_to from worktree YAML (not found in main)`);
+                }
+            }
+            catch (err) {
+                console.warn(`${LOG_PREFIX.DONE} Warning: Failed to read assigned_to from worktree: ${getErrorMessage(err)}`);
+            }
+        }
+    }
+    if (!assignedTo) {
+        return {
+            valid: false,
+            error: `WU ${id} has no assigned_to field.\n\n` +
+                `This WU was claimed before ownership tracking was implemented.\n` +
+                `To complete this WU:\n` +
+                `  1. Add assigned_to: <your-email> to ${id}.yaml\n` +
+                `  2. Commit the change\n` +
+                `  3. Re-run: pnpm wu:done --id ${id}`,
+            auditEntry: null,
+        };
+    }
+    let currentUser;
+    try {
+        currentUser = (await getGitForCwd().getConfigValue(GIT_CONFIG_USER_EMAIL)).trim();
+    }
+    catch {
+        currentUser = process.env[ENV_VARS.GIT_USER] || process.env[ENV_VARS.USER] || null;
+    }
+    if (!currentUser) {
+        return {
+            valid: false,
+            error: `Cannot determine current user identity.\n\n` +
+                `Set git user.email or GIT_USER environment variable.`,
+            auditEntry: null,
+        };
+    }
+    const normalizedAssigned = normalizeUsername(assignedTo);
+    const normalizedCurrent = normalizeUsername(currentUser);
+    const isOwner = normalizedAssigned === normalizedCurrent;
+    if (isOwner) {
+        if (assignedTo !== currentUser) {
+            console.log(`${LOG_PREFIX.DONE} ${EMOJI.INFO} Ownership match via normalization: "${assignedTo}" == "${currentUser}"`);
+        }
+        return { valid: true, error: null, auditEntry: null };
+    }
+    if (overrideOwner) {
+        if (!overrideReason) {
+            return {
+                valid: false,
+                error: `--override-owner requires --reason "<why you're completing someone else's WU>"`,
+                auditEntry: null,
+            };
+        }
+        const auditEntry = {
+            timestamp: new Date().toISOString(),
+            wu_id: id,
+            assigned_to: assignedTo,
+            completed_by: currentUser,
+            reason: overrideReason,
+            git_commit: (await getGitForCwd().getCommitHash()).trim(),
+        };
+        console.log(`\n⚠️  --override-owner: Completing WU assigned to someone else`);
+        console.log(`   Assigned to: ${assignedTo}`);
+        console.log(`   Completed by: ${currentUser}`);
+        console.log(`   Reason: ${overrideReason}\n`);
+        return { valid: true, error: null, auditEntry };
+    }
+    return {
+        valid: false,
+        error: `\n❌ OWNERSHIP VIOLATION: ${id} is assigned to someone else\n\n` +
+            `   Assigned to: ${assignedTo}\n` +
+            `   Current user: ${currentUser}\n\n` +
+            `   You cannot complete WUs you do not own.\n\n` +
+            `   📋 Options:\n` +
+            `      1. Contact ${assignedTo} to complete the WU\n` +
+            `      2. Reassign the WU to yourself in ${id}.yaml (requires approval)\n` +
+            `      3. Add co_assigned field for pairing (requires approval)\n\n` +
+            `   ⚠️  To override (use with extreme caution):\n` +
+            `      pnpm wu:done --id ${id} --override-owner --reason "<why>"\n\n` +
+            `   AGENTS: NEVER use --override-owner without explicit instruction.\n` +
+            `   Language protocol: "pick up WU-${id.replace('WU-', '')}" = READ ONLY.\n`,
+        auditEntry: null,
+    };
+}
+export function auditOwnershipOverride(auditEntry) {
+    const auditPath = path.join('.lumenflow', 'ownership-override-audit.log');
+    const auditDir = path.dirname(auditPath);
+    if (!existsSync(auditDir))
+        mkdirSync(auditDir, { recursive: true });
+    const line = JSON.stringify(auditEntry);
+    appendFileSync(auditPath, `${line}\n`, { encoding: FILE_SYSTEM.UTF8 });
+    console.log(`${LOG_PREFIX.DONE} ${EMOJI.MEMO} Ownership override logged to ${auditPath}`);
+}
+export async function runWuDoneStagedValidation({ id, worktreePath, gateResult, skipGates, runGatesFn, }) {
+    const preCommitGateDecision = resolveWuDonePreCommitGateDecision({
+        skipGates,
+        fullGatesRanInCurrentRun: gateResult.fullGatesRanInCurrentRun,
+        skippedByCheckpoint: gateResult.skippedByCheckpoint,
+        checkpointId: gateResult.checkpointId,
+    });
+    console.log(`${LOG_PREFIX.DONE} ${preCommitGateDecision.message}`);
+    if (preCommitGateDecision.runPreCommitFullSuite) {
+        const hookResult = await validateAllPreCommitHooks(id, worktreePath, {
+            runGates: ({ cwd }) => runGatesFn({ cwd }),
+        });
+        if (!hookResult.valid) {
+            die('Pre-flight validation failed. Fix hook issues and try again.');
+        }
+    }
+    const tasksValidationResult = runPreflightTasksValidation(id);
+    if (!tasksValidationResult.valid) {
+        const errorMessage = buildPreflightErrorMessage(id, tasksValidationResult.errors);
+        console.error(errorMessage);
+        die('Preflight tasks:validate failed. See errors above for fix options.');
+    }
+}
+//# sourceMappingURL=wu-done-preflight.js.map