@lumenflow/cli 2.3.2 → 2.5.0

package/dist/rotate-progress.js

@@ -15,7 +15,8 @@
 import { readFileSync, writeFileSync, existsSync, readdirSync } from 'node:fs';
 import { join } from 'node:path';
 import { parse as parseYaml } from 'yaml';
-import { EXIT_CODES, STATUS_SECTIONS, DIRECTORIES, FILE_SYSTEM, } from '@lumenflow/core/dist/wu-constants.js';
+import { EXIT_CODES, STATUS_SECTIONS, FILE_SYSTEM, } from '@lumenflow/core/dist/wu-constants.js';
+import { WU_PATHS } from '@lumenflow/core/dist/wu-paths.js';
 import { runCLI } from './cli-entry-point.js';
 /** Log prefix for console output */
 const LOG_PREFIX = '[rotate:progress]';
@@ -49,7 +50,8 @@ export function parseRotateArgs(argv) {
  * Get WU status from YAML file
  */
 function getWuStatus(wuId, baseDir = process.cwd()) {
-    const yamlPath = join(baseDir, DIRECTORIES.WU_DIR, `${wuId}.yaml`);
+    // WU-1301: Use config-based paths
+    const yamlPath = join(baseDir, WU_PATHS.WU(wuId));
     if (!existsSync(yamlPath)) {
         return null;
     }
@@ -67,7 +69,8 @@ function getWuStatus(wuId, baseDir = process.cwd()) {
  */
 function getAllWuStatuses(baseDir = process.cwd()) {
     const statuses = new Map();
-    const wuDir = join(baseDir, DIRECTORIES.WU_DIR);
+    // WU-1301: Use config-based paths
+    const wuDir = join(baseDir, WU_PATHS.WU_DIR());
     if (!existsSync(wuDir)) {
         return statuses;
     }
@@ -203,8 +206,8 @@ async function main() {
         printHelp();
         process.exit(EXIT_CODES.SUCCESS);
     }
-    // Read status.md
-    const statusPath = join(process.cwd(), DIRECTORIES.STATUS_PATH);
+    // Read status.md - WU-1301: Use config-based paths
+    const statusPath = join(process.cwd(), WU_PATHS.STATUS());
     if (!existsSync(statusPath)) {
         console.error(`${LOG_PREFIX} Error: ${statusPath} not found`);
         process.exit(EXIT_CODES.ERROR);

package/dist/spawn-list.js

@@ -15,7 +15,8 @@
  */
 import { createWUParser, WU_OPTIONS } from '@lumenflow/core/dist/arg-parser.js';
 import { die } from '@lumenflow/core/dist/error-handler.js';
-import { PATTERNS, LUMENFLOW_PATHS, DIRECTORIES } from '@lumenflow/core/dist/wu-constants.js';
+import { PATTERNS, LUMENFLOW_PATHS } from '@lumenflow/core/dist/wu-constants.js';
+import { WU_PATHS } from '@lumenflow/core/dist/wu-paths.js';
 /** Local EMOJI constants for spawn-list output */
 const EMOJI = {
     WARNING: '⚠️',
@@ -38,10 +39,10 @@ const SPAWN_LIST_OPTIONS = {
 import { buildSpawnTree, formatSpawnTree, getSpawnsByWU, getSpawnsByInitiative, treeToJSON, STATUS_INDICATORS, } from '@lumenflow/core/dist/spawn-tree.js';
 import { SpawnStatus } from '@lumenflow/core/dist/spawn-registry-schema.js';
 const LOG_PREFIX = '[spawn:list]';
-/** Default paths for spawn registry and WU files */
+/** Default paths for spawn registry and WU files (WU-1301: uses config-based paths) */
 const DEFAULT_PATHS = Object.freeze({
     REGISTRY_DIR: LUMENFLOW_PATHS.STATE_DIR,
-    WU_DIR: DIRECTORIES.WU_DIR,
+    WU_DIR: WU_PATHS.WU_DIR(),
 });
 /** Initiative ID pattern */
 const INIT_PATTERN = /^INIT-\d+$/;

package/dist/state-bootstrap.js

@@ -15,18 +15,20 @@ import { readdirSync, existsSync, writeFileSync, mkdirSync } from 'node:fs';
 import path from 'node:path';
 import { parse as parseYaml } from 'yaml';
 import { readFileSync } from 'node:fs';
+import { WU_PATHS } from '@lumenflow/core/dist/wu-paths.js';
 import { CLI_FLAGS, EXIT_CODES, EMOJI, STRING_LITERALS, } from '@lumenflow/core/dist/wu-constants.js';
 /* eslint-disable security/detect-non-literal-fs-filename */
 /** Log prefix for consistent output */
 const LOG_PREFIX = '[state-bootstrap]';
 /**
  * Default configuration for state bootstrap
+ * WU-1301: Uses config-based paths instead of hardcoded values
  */
 export const STATE_BOOTSTRAP_DEFAULTS = {
-    /** Default WU directory path */
-    wuDir: 'docs/04-operations/tasks/wu',
-    /** Default state directory path */
-    stateDir: '.lumenflow/state',
+    /** Default WU directory path (from config) */
+    wuDir: WU_PATHS.WU_DIR(),
+    /** Default state directory path (from config) */
+    stateDir: WU_PATHS.STATE_DIR(),
 };
 /**
  * Parse command line arguments for state-bootstrap

package/dist/state-doctor-fix.js

@@ -14,6 +14,7 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { withMicroWorktree } from '@lumenflow/core/dist/micro-worktree.js';
+import { WU_PATHS } from '@lumenflow/core/dist/wu-paths.js';
 /**
  * Operation name for micro-worktree isolation
  */
@@ -31,13 +32,13 @@ const SIGNALS_FILE = '.lumenflow/memory/signals.jsonl';
  */
 const WU_EVENTS_FILE = '.lumenflow/state/wu-events.jsonl';
 /**
- * Backlog file path (relative to project root)
+ * Backlog file path (WU-1301: uses config-based paths)
  */
-const BACKLOG_FILE = 'docs/04-operations/tasks/backlog.md';
+const BACKLOG_FILE = WU_PATHS.BACKLOG();
 /**
- * Status file path (relative to project root)
+ * Status file path (WU-1301: uses config-based paths)
  */
-const STATUS_FILE = 'docs/04-operations/tasks/status.md';
+const STATUS_FILE = WU_PATHS.STATUS();
 /**
  * Remove lines containing a WU reference from markdown content
  *

package/dist/state-doctor.js

@@ -32,7 +32,8 @@ import { parse as parseYaml } from 'yaml';
 import { diagnoseState, ISSUE_TYPES, ISSUE_SEVERITY, } from '@lumenflow/core/dist/state-doctor-core.js';
 import { createWUParser } from '@lumenflow/core/dist/arg-parser.js';
 import { EXIT_CODES, LUMENFLOW_PATHS } from '@lumenflow/core/dist/wu-constants.js';
-import { getConfig } from '@lumenflow/core/dist/lumenflow-config.js';
+import { getConfig, getResolvedPaths } from '@lumenflow/core/dist/lumenflow-config.js';
+import { existsSync } from 'node:fs';
 import { createStamp } from '@lumenflow/core/dist/stamp-utils.js';
 import { createStateDoctorFixDeps } from './state-doctor-fix.js';
 /**
@@ -170,10 +171,11 @@ async function createDeps(baseDir) {
         },
         /**
          * List all stamp file IDs
+         * WU-1301: Use config-based paths instead of LUMENFLOW_PATHS
          */
         listStamps: async () => {
             try {
-                const stampsDir = path.join(baseDir, LUMENFLOW_PATHS.STAMPS_DIR);
+                const stampsDir = path.join(baseDir, config.beacon.stampsDir);
                 const stampFiles = await fg('WU-*.done', { cwd: stampsDir });
                 return stampFiles.map((file) => file.replace('.done', ''));
             }
@@ -438,6 +440,32 @@ function buildAuditOutput(result) {
         dryRun: result.dryRun,
     };
 }
+/**
+ * WU-1301: Warn if configured paths don't exist
+ * This helps consumers detect misconfiguration early.
+ */
+function warnMissingPaths(baseDir, quiet) {
+    if (quiet)
+        return;
+    const paths = getResolvedPaths({ projectRoot: baseDir });
+    const missing = [];
+    if (!existsSync(paths.wuDir)) {
+        missing.push(`WU directory: ${paths.wuDir}`);
+    }
+    if (!existsSync(paths.stampsDir)) {
+        missing.push(`Stamps directory: ${paths.stampsDir}`);
+    }
+    if (!existsSync(paths.stateDir)) {
+        missing.push(`State directory: ${paths.stateDir}`);
+    }
+    if (missing.length > 0) {
+        console.warn(`${LOG_PREFIX} ${EMOJI.WARNING} Configured paths not found:`);
+        for (const p of missing) {
+            console.warn(`  - ${p}`);
+        }
+        console.warn('  Tip: Run `pnpm setup` or check .lumenflow.config.yaml');
+    }
+}
 /**
  * Main CLI entry point
  */
@@ -446,6 +474,8 @@ async function main() {
     const baseDir = args.baseDir || process.cwd();
     const startedAt = new Date().toISOString();
     const startTime = Date.now();
+    // WU-1301: Warn about missing configured paths
+    warnMissingPaths(baseDir, args.quiet ?? false);
     let result = null;
     let error = null;
     try {

package/dist/trace-gen.js

@@ -17,7 +17,8 @@ import { readFileSync, writeFileSync, existsSync, readdirSync } from 'node:fs';
 import { join } from 'node:path';
 import { execSync } from 'node:child_process';
 import { parse as parseYaml } from 'yaml';
-import { EXIT_CODES, DIRECTORIES, FILE_SYSTEM } from '@lumenflow/core/dist/wu-constants.js';
+import { EXIT_CODES, FILE_SYSTEM } from '@lumenflow/core/dist/wu-constants.js';
+import { WU_PATHS } from '@lumenflow/core/dist/wu-paths.js';
 import { runCLI } from './cli-entry-point.js';
 /** Log prefix for console output */
 const LOG_PREFIX = '[trace:gen]';
@@ -131,7 +132,8 @@ function getWuFiles(wuId) {
  * Get WU info from YAML file
  */
 function getWuInfo(wuId) {
-    const yamlPath = join(process.cwd(), DIRECTORIES.WU_DIR, `${wuId}.yaml`);
+    // WU-1301: Use config-based paths
+    const yamlPath = join(process.cwd(), WU_PATHS.WU(wuId));
     if (!existsSync(yamlPath)) {
         return null;
     }
@@ -268,7 +270,8 @@ async function main() {
     else {
         // Trace all WUs
         console.error(`${LOG_PREFIX} Scanning all WUs...`);
-        const wuDir = join(process.cwd(), DIRECTORIES.WU_DIR);
+        // WU-1301: Use config-based paths
+        const wuDir = join(process.cwd(), WU_PATHS.WU_DIR());
         if (!existsSync(wuDir)) {
             console.error(`${LOG_PREFIX} Error: WU directory not found`);
             process.exit(EXIT_CODES.ERROR);

package/dist/wu-block.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+/* eslint-disable no-console -- CLI tool requires console output */
 /**
  * WU Block Helper
  *
@@ -32,6 +33,8 @@ import { withMicroWorktree } from '@lumenflow/core/dist/micro-worktree.js';
 import { WUStateStore } from '@lumenflow/core/dist/wu-state-store.js';
 // WU-1603: Atomic lane locking - release lock when WU is blocked
 import { releaseLaneLock } from '@lumenflow/core/dist/lane-lock.js';
+// WU-1325: Import lock policy getter to determine release behavior
+import { getLockPolicyForLane } from '@lumenflow/core/dist/lane-checker.js';
 // ensureOnMain() moved to wu-helpers.ts (WU-1256)
 // ensureStaged() moved to git-staged-validator.ts (WU-1341)
 // defaultWorktreeFrom() moved to wu-paths.ts (WU-1341)
@@ -215,15 +218,23 @@ async function main() {
         await getGitForCwd().push(REMOTES.ORIGIN, BRANCHES.MAIN);
     }
     await handleWorktreeRemoval(args, doc);
-    // WU-1603: Release lane lock when WU is blocked
-    // This allows another WU to be claimed in the same lane
+    // WU-1325: Release lane lock when WU is blocked (only for lock_policy=active)
+    // For policy=all, lock is held through block/unblock cycle
+    // For policy=none, no lock exists to release
     try {
         const lane = doc.lane;
         if (lane) {
-            const releaseResult = releaseLaneLock(lane, { wuId: id });
-            if (releaseResult.released && !releaseResult.notFound) {
-                console.log(`${LOG_PREFIX.BLOCK} Lane lock released for "${lane}"`);
+            const lockPolicy = getLockPolicyForLane(lane);
+            if (lockPolicy === 'active') {
+                const releaseResult = releaseLaneLock(lane, { wuId: id });
+                if (releaseResult.released && !releaseResult.notFound) {
+                    console.log(`${LOG_PREFIX.BLOCK} Lane lock released for "${lane}" (lock_policy=active)`);
+                }
             }
+            else if (lockPolicy === 'all') {
+                console.log(`${LOG_PREFIX.BLOCK} Lane lock retained for "${lane}" (lock_policy=all)`);
+            }
+            // For policy=none, no lock exists - nothing to do
         }
     }
     catch (err) {

package/dist/wu-claim.js

@@ -67,9 +67,13 @@ async function ensureCleanOrClaimOnlyWhenNoAuto() {
         .split(STRING_LITERALS.NEWLINE)
         .filter(Boolean)
         .filter((l) => l.startsWith('A ') || l.startsWith('M ') || l.startsWith('R '));
-    const hasClaimFiles = staged.some((l) => l.includes('docs/04-operations/tasks/status.md') ||
-        l.includes('docs/04-operations/tasks/backlog.md') ||
-        /docs\/04-operations\/tasks\/wu\/WU-\d+\.yaml/.test(l));
+    // WU-1311: Use config-based paths instead of hardcoded docs/04-operations paths
+    const config = getConfig();
+    const wuDirPattern = config.directories.wuDir.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const wuYamlRegex = new RegExp(`${wuDirPattern}/WU-\\d+\\.yaml`);
+    const hasClaimFiles = staged.some((l) => l.includes(config.directories.statusPath) ||
+        l.includes(config.directories.backlogPath) ||
+        wuYamlRegex.test(l));
     if (!hasClaimFiles) {
         console.error(status);
         die('Stage claim-related files (status/backlog/WU YAML) before running with --no-auto.');
@@ -400,12 +404,12 @@ async function appendClaimEventOnly(stateDir, id, title, lane) {
  * @returns {string[]} List of files to commit
  */
 export function getWorktreeCommitFiles(wuId) {
+    // WU-1311: Use config-based paths instead of hardcoded docs/04-operations paths
+    const config = getConfig();
     return [
-        `docs/04-operations/tasks/wu/${wuId}.yaml`,
+        `${config.directories.wuDir}/${wuId}.yaml`,
         LUMENFLOW_PATHS.WU_EVENTS, // WU-1740: Event store is source of truth
-        // WU-1746: Explicitly NOT including:
-        // - docs/04-operations/tasks/backlog.md
-        // - docs/04-operations/tasks/status.md
+        // WU-1746: Explicitly NOT including backlog.md and status.md
         // These generated files cause merge conflicts when main advances
     ];
 }
@@ -694,7 +698,8 @@ function handleLaneOccupancy(laneCheck, lane, id, force) {
         `  2. Choose a different lane\n` +
         `  3. Increase wip_limit in .lumenflow.config.yaml\n` +
         `  4. Use --force to override (P0 emergencies only)\n\n` +
-        `To check lane status: grep "${STATUS_SECTIONS.IN_PROGRESS}" docs/04-operations/tasks/status.md`);
+        // WU-1311: Use config-based status path
+        `To check lane status: grep "${STATUS_SECTIONS.IN_PROGRESS}" ${getConfig().directories.statusPath}`);
 }
 /**
  * Handle code path overlap detection (WU-901)
@@ -726,13 +731,14 @@ function handleCodePathOverlap(WU_PATH, STATUS_PATH, id, args) {
             return `  - ${c.wuid}: ${displayedOverlaps}${suffix}`;
         })
             .join(STRING_LITERALS.NEWLINE);
+        // WU-1311: Use config-based status path in error message
         die(`Code path overlap detected with in-progress WUs:\n\n${conflictList}\n\n` +
             `Merge conflicts are guaranteed if both WUs proceed.\n\n` +
             `Options:\n` +
             `  1. Wait for conflicting WU(s) to complete\n` +
             `  2. Coordinate with agent working on conflicting WU\n` +
             `  3. Use --force-overlap --reason "..." (emits telemetry for audit)\n\n` +
-            `To check WU status: grep "${STATUS_SECTIONS.IN_PROGRESS}" docs/04-operations/tasks/status.md`);
+            `To check WU status: grep "${STATUS_SECTIONS.IN_PROGRESS}" ${getConfig().directories.statusPath}`);
     }
     if (args.forceOverlap) {
         if (!args.reason) {

package/dist/wu-create.js

@@ -41,6 +41,7 @@ import { inferSubLane } from '@lumenflow/core/dist/lane-inference.js';
 import { parseBacklogFrontmatter } from '@lumenflow/core/dist/backlog-parser.js';
 import { createWUParser, WU_CREATE_OPTIONS, WU_OPTIONS } from '@lumenflow/core/dist/arg-parser.js';
 import { WU_PATHS } from '@lumenflow/core/dist/wu-paths.js';
+import { getConfig } from '@lumenflow/core/dist/lumenflow-config.js';
 import { validateWU } from '@lumenflow/core/dist/wu-schema.js';
 import { getPlanPath, getPlanProtocolRef, getPlansDir, } from '@lumenflow/core/dist/lumenflow-home.js';
 import { validateSpecRefs } from '@lumenflow/core/dist/wu-create-validators.js';
@@ -57,6 +58,8 @@ import { validateSpecCompleteness } from '@lumenflow/core/dist/wu-done-validator
 import { readWU } from '@lumenflow/core/dist/wu-yaml.js';
 // WU-2253: Import WU spec linter for acceptance/code_paths validation
 import { lintWUSpec, formatLintErrors } from '@lumenflow/core/dist/wu-lint.js';
+// WU-1329: Import path existence validators for strict mode
+import { validateCodePathsExistence, validateTestPathsExistence, } from '@lumenflow/core/dist/wu-preflight-validators.js';
 // WU-1025: Import placeholder validator for inline content validation
 import { validateNoPlaceholders, buildPlaceholderErrorMessage, } from '@lumenflow/core/dist/wu-validator.js';
 // WU-1211: Import initiative validation for phase check
@@ -247,9 +250,24 @@ function buildWUContent({ id, lane, title, priority, type, created, opts, }) {
         ...(specRefs?.length && { spec_refs: specRefs }),
     };
 }
+/**
+ * Validate WU spec for creation
+ *
+ * WU-1329: Strict mode (default) validates that code_paths and test_paths exist on disk.
+ * Use opts.strict = false to bypass path existence checks.
+ *
+ * @param params - Validation parameters
+ * @returns {{ valid: boolean, errors: string[] }}
+ */
 export function validateCreateSpec({ id, lane, title, priority, type, opts, }) {
     const errors = [];
     const effectiveType = type || DEFAULT_TYPE;
+    // WU-1329: Strict mode is the default
+    const strict = opts.strict !== false;
+    // WU-1329: Log when strict validation is bypassed
+    if (!strict) {
+        console.warn(`${LOG_PREFIX} WARNING: strict validation bypassed (--no-strict). Path existence checks skipped.`);
+    }
     if (!opts.description) {
         errors.push('--description is required');
     }
@@ -269,7 +287,9 @@ export function validateCreateSpec({ id, lane, title, priority, type, opts, }) {
         }
     }
     if (effectiveType === 'feature' && !opts.specRefs) {
-        errors.push('--spec-refs is required for type: feature WUs');
+        errors.push('--spec-refs is required for type: feature WUs\n' +
+            '    Tip: Create a plan first with: pnpm plan:create --id <WU-ID> --title "..."\n' +
+            '    Then use --plan flag or --spec-refs lumenflow://plans/<WU-ID>-plan.md');
     }
     if (errors.length > 0) {
         return { valid: false, errors };
@@ -303,6 +323,29 @@ export function validateCreateSpec({ id, lane, title, priority, type, opts, }) {
     if (!completeness.valid) {
         return { valid: false, errors: completeness.errors };
     }
+    // WU-1329: Strict mode validates path existence
+    if (strict) {
+        const rootDir = process.cwd();
+        // Validate code_paths exist
+        if (opts.codePaths && opts.codePaths.length > 0) {
+            const codePathsResult = validateCodePathsExistence(opts.codePaths, rootDir);
+            if (!codePathsResult.valid) {
+                errors.push(...codePathsResult.errors);
+            }
+        }
+        // Validate test_paths exist (unit, e2e - not manual)
+        const testsObj = {
+            unit: opts.testPathsUnit || [],
+            e2e: opts.testPathsE2e || [],
+        };
+        const testPathsResult = validateTestPathsExistence(testsObj, rootDir);
+        if (!testPathsResult.valid) {
+            errors.push(...testPathsResult.errors);
+        }
+        if (errors.length > 0) {
+            return { valid: false, errors };
+        }
+    }
     return { valid: true, errors: [] };
 }
 /**
@@ -382,9 +425,10 @@ function updateBacklogInWorktree(worktreePath, id, lane, title) {
     const backlogRelativePath = WU_PATHS.BACKLOG();
     const backlogAbsolutePath = join(worktreePath, backlogRelativePath);
     if (!existsSync(backlogAbsolutePath)) {
+        // WU-1311: Use config-based backlog path in error message
         die(`Backlog not found in micro-worktree: ${backlogAbsolutePath}\n\n` +
             `Options:\n` +
-            `  1. Ensure backlog.md exists at docs/04-operations/tasks/backlog.md\n` +
+            `  1. Ensure backlog.md exists at ${getConfig().directories.backlogPath}\n` +
             `  2. Run from repository root directory`);
     }
     const { frontmatter, markdown } = parseBacklogFrontmatter(backlogAbsolutePath);
@@ -482,6 +526,8 @@ async function main() {
             WU_OPTIONS.uiPairingWus,
             // WU-1062: External plan options for wu:create
             WU_CREATE_OPTIONS.plan,
+            // WU-1329: Strict validation is default, --no-strict bypasses
+            WU_OPTIONS.noStrict,
         ],
         required: ['lane', 'title'], // WU-1246: --id is now optional (auto-generated if not provided)
         allowPositionalId: false,
@@ -558,6 +604,8 @@ async function main() {
             blocks: args.blocks,
             labels: args.labels,
             assignedTo,
+            // WU-1329: Strict validation is default, --no-strict bypasses
+            strict: !args.noStrict,
         },
     });
     if (!createSpecValidation.valid) {

package/dist/wu-deps.js

@@ -15,6 +15,7 @@ import { die } from '@lumenflow/core/dist/error-handler.js';
 import { buildDependencyGraphAsync, renderASCII, renderMermaid, validateGraph, } from '@lumenflow/core/dist/dependency-graph.js';
 import { OUTPUT_FORMATS } from '@lumenflow/initiatives/dist/initiative-constants.js';
 import { PATTERNS } from '@lumenflow/core/dist/wu-constants.js';
+import { getConfig } from '@lumenflow/core/dist/lumenflow-config.js';
 async function main() {
     const args = createWUParser({
         name: 'wu-deps',
@@ -33,7 +34,8 @@ async function main() {
     console.log(`[wu:deps] Building dependency graph...`);
     const graph = await buildDependencyGraphAsync();
     if (!graph.has(wuId)) {
-        die(`WU not found in graph: ${wuId}\n\nEnsure the WU exists in docs/04-operations/tasks/wu/`);
+        // WU-1311: Use config-based WU directory path
+        die(`WU not found in graph: ${wuId}\n\nEnsure the WU exists in ${getConfig().directories.wuDir}/`);
     }
     const format = args.format || OUTPUT_FORMATS.ASCII;
     const depth = args.depth ? parseInt(args.depth, 10) : 3;

package/dist/wu-done.js

@@ -65,6 +65,7 @@ CONTEXT_VALIDATION, } from '@lumenflow/core/dist/wu-constants.js';
 import { printGateFailureBox, printStatusPreview } from '@lumenflow/core/dist/wu-done-ui.js';
 import { ensureOnMain } from '@lumenflow/core/dist/wu-helpers.js';
 import { WU_PATHS } from '@lumenflow/core/dist/wu-paths.js';
+import { getConfig } from '@lumenflow/core/dist/lumenflow-config.js';
 import { writeWU, appendNote, parseYAML } from '@lumenflow/core/dist/wu-yaml.js';
 import { PLACEHOLDER_SENTINEL, validateWU, validateDoneWU, validateApprovalGates, } from '@lumenflow/core/dist/wu-schema.js';
 import { validateBacklogSync } from '@lumenflow/core/dist/backlog-sync-validator.js';
@@ -969,11 +970,14 @@ async function runGatesInWorktree(worktreePath, id, options = {}) {
 }
 async function validateStagedFiles(id, isDocsOnly = false) {
     const staged = await listStaged();
+    // WU-1311: Use config-based paths instead of hardcoded docs/04-operations paths
+    const config = getConfig();
+    const wuPath = `${config.directories.wuDir}/${id}.yaml`;
     // WU-1740: Include wu-events.jsonl to persist state store events
     const whitelist = [
-        `docs/04-operations/tasks/wu/${id}.yaml`,
-        'docs/04-operations/tasks/status.md',
-        'docs/04-operations/tasks/backlog.md',
+        wuPath,
+        config.directories.statusPath,
+        config.directories.backlogPath,
         WU_EVENTS_PATH,
     ];
     if (isDocsOnly) {
@@ -998,7 +1002,10 @@ async function validateStagedFiles(id, isDocsOnly = false) {
         return true;
     });
     if (unexpected.length > 0) {
-        const otherWuYamlOnly = unexpected.every((f) => /^docs\/04-operations\/tasks\/wu\/WU-\d+\.yaml$/.test(f));
+        // WU-1311: Use config-based pattern for WU YAML detection
+        const wuDirPattern = config.directories.wuDir.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        const wuYamlRegex = new RegExp(`^${wuDirPattern}/WU-\\d+\\.yaml$`);
+        const otherWuYamlOnly = unexpected.every((f) => wuYamlRegex.test(f));
         if (otherWuYamlOnly) {
             console.warn(`${LOG_PREFIX.DONE} Warning: other WU YAMLs are staged; proceeding and committing only current WU files.`);
         }
@@ -1620,8 +1627,10 @@ async function executePreFlightChecks({ id, args, isBranchOnly, isDocsOnly, docM
     if (!specResult.valid) {
         console.error(`\n❌ Spec completeness validation failed for ${id}:\n`);
         specResult.errors.forEach((err) => console.error(`  - ${err}`));
+        // WU-1311: Use config-based path in error message
+        const specConfig = getConfig();
         console.error(`\nFix these issues before running wu:done:\n` +
-            `  1. Update docs/04-operations/tasks/wu/${id}.yaml\n` +
+            `  1. Update ${specConfig.directories.wuDir}/${id}.yaml\n` +
             `  2. Fill description with Context/Problem/Solution\n` +
             `  3. Replace ${PLACEHOLDER_SENTINEL} text with specific criteria\n` +
             `  4. List all modified files in code_paths\n` +

package/dist/wu-edit.js

@@ -57,6 +57,8 @@ import { readInitiative, writeInitiative } from '@lumenflow/initiatives/dist/ini
 import { normalizeWUSchema } from '@lumenflow/core/dist/wu-schema-normalization.js';
 // WU-2253: Import WU spec linter for acceptance/code_paths validation
 import { lintWUSpec, formatLintErrors } from '@lumenflow/core/dist/wu-lint.js';
+// WU-1329: Import path existence validators for strict validation
+import { validateCodePathsExistence, validateTestPathsExistence, } from '@lumenflow/core/dist/wu-preflight-validators.js';
 /* eslint-disable security/detect-object-injection */
 const PREFIX = LOG_PREFIX.EDIT;
 /**
@@ -377,6 +379,8 @@ function parseArgs() {
             EDIT_OPTIONS.replaceDependencies,
             // WU-1039: Add exposure for done WU metadata updates
             WU_OPTIONS.exposure,
+            // WU-1329: Strict validation is default, --no-strict bypasses
+            WU_OPTIONS.noStrict,
         ],
         required: ['id'],
         allowPositionalId: true,
@@ -921,6 +925,37 @@ async function main() {
     // WU-1750: CRITICAL - Use transformed data for all subsequent operations
     // This ensures embedded newlines are normalized before YAML output
     const normalizedWU = validationResult.data;
+    // WU-1329: Strict validation of path existence (default behavior)
+    // --no-strict bypasses these checks
+    const strict = !opts.noStrict;
+    if (!strict) {
+        console.warn(`${PREFIX} WARNING: strict validation bypassed (--no-strict). Path existence checks skipped.`);
+    }
+    if (strict) {
+        const rootDir = process.cwd();
+        const strictErrors = [];
+        // Validate code_paths exist
+        if (normalizedWU.code_paths && normalizedWU.code_paths.length > 0) {
+            const codePathsResult = validateCodePathsExistence(normalizedWU.code_paths, rootDir);
+            if (!codePathsResult.valid) {
+                strictErrors.push(...codePathsResult.errors);
+            }
+        }
+        // Validate test_paths exist (unit, e2e - not manual)
+        if (normalizedWU.tests) {
+            const testPathsResult = validateTestPathsExistence(normalizedWU.tests, rootDir);
+            if (!testPathsResult.valid) {
+                strictErrors.push(...testPathsResult.errors);
+            }
+        }
+        if (strictErrors.length > 0) {
+            const errorList = strictErrors.map((e) => `  • ${e}`).join('\n');
+            die(`${PREFIX} ❌ Strict validation failed:\n\n${errorList}\n\n` +
+                `Options:\n` +
+                `  1. Fix the paths in the WU spec to match actual files\n` +
+                `  2. Use --no-strict to bypass path existence checks (not recommended)`);
+        }
+    }
     // Validate lane format if present (WU-923: block parent-only lanes with taxonomy)
     if (normalizedWU.lane) {
         validateLaneFormat(normalizedWU.lane);

package/dist/wu-infer-lane.js

@@ -20,6 +20,7 @@ import { parseYAML } from '@lumenflow/core/dist/wu-yaml.js';
 import { inferSubLane } from '@lumenflow/core/dist/lane-inference.js';
 import { die } from '@lumenflow/core/dist/error-handler.js';
 import { FILE_SYSTEM, EXIT_CODES } from '@lumenflow/core/dist/wu-constants.js';
+import { WU_PATHS } from '@lumenflow/core/dist/wu-paths.js';
 function parseArgs(argv) {
     const args = { paths: [], desc: '', id: null };
     for (let i = 2; i < argv.length; i++) {
@@ -62,7 +63,8 @@ Options:
     return args;
 }
 function loadWuYaml(id) {
-    const wuPath = path.join(process.cwd(), 'docs/04-operations/tasks/wu', `${id}.yaml`);
+    // WU-1301: Use config-based paths instead of hardcoded path
+    const wuPath = path.join(process.cwd(), WU_PATHS.WU(id));
     if (!existsSync(wuPath)) {
         die(`WU file not found: ${wuPath}\n\n` +
             `Options:\n` +

package/dist/wu-spawn.js

@@ -36,7 +36,9 @@ import { parseYAML } from '@lumenflow/core/dist/wu-yaml.js';
 import { die } from '@lumenflow/core/dist/error-handler.js';
 import { WU_STATUS, PATTERNS, FILE_SYSTEM, EMOJI } from '@lumenflow/core/dist/wu-constants.js';
 // WU-1603: Check lane lock status before spawning
+// WU-1325: Import lock policy getter for lane availability check
 import { checkLaneLock } from '@lumenflow/core/dist/lane-lock.js';
+import { getLockPolicyForLane } from '@lumenflow/core/dist/lane-checker.js';
 import { minimatch } from 'minimatch';
 // WU-2252: Import invariants loader for spawn output injection
 import { loadInvariants, INVARIANT_TYPES } from '@lumenflow/core/dist/invariants-runner.js';
@@ -1146,11 +1148,17 @@ ${SPAWN_END_SENTINEL}
 }
 /**
  * WU-1603: Check if a lane is currently occupied by another WU
+ * WU-1325: Now considers lock_policy - lanes with policy=none are never occupied
  *
  * @param {string} lane - Lane name (e.g., "Operations: Tooling")
  * @returns {import('@lumenflow/core/dist/lane-lock.js').LockMetadata|null} Lock metadata if occupied, null otherwise
  */
 export function checkLaneOccupation(lane) {
+    // WU-1325: Lanes with lock_policy=none never report as occupied
+    const lockPolicy = getLockPolicyForLane(lane);
+    if (lockPolicy === 'none') {
+        return null;
+    }
     const lockStatus = checkLaneLock(lane);
     if (lockStatus.locked && lockStatus.metadata) {
         return lockStatus.metadata;