@lumenflow/core 2.3.1 → 2.4.0

package/dist/arg-parser.d.ts

@@ -1,3 +1,4 @@
+import { type OptionValues } from 'commander';
 /**
  * Predefined option configurations for WU management scripts.
  * Each option has: name, flags, description, and optional default.
@@ -19,6 +20,10 @@ interface WUOption {
     default?: string | boolean | string[];
     isNegated?: boolean;
     isRepeatable?: boolean;
+    /** Type hint for option parsing (e.g., 'boolean' for flags, 'string' for values) */
+    type?: 'boolean' | 'string';
+    /** Whether this option is required (used for validation hints) */
+    required?: boolean;
 }
 export declare const WU_OPTIONS: Record<string, WUOption>;
 /**
@@ -49,7 +54,14 @@ export declare const WU_CREATE_OPTIONS: Record<string, WUOption>;
  * console.log(opts.id); // 'WU-123'
  * console.log(opts.branchOnly); // true
  */
-export declare function createWUParser(config: any): import("commander").OptionValues;
+export declare function createWUParser(config: {
+    name: string;
+    description: string;
+    options?: WUOption[];
+    required?: string[];
+    allowPositionalId?: boolean;
+    version?: string;
+}): OptionValues;
 /**
  * Backward-compatible unified argument parser for WU management scripts.
  * Uses commander internally but maintains the same return format.
@@ -65,5 +77,5 @@ export declare function createWUParser(config: any): import("commander").OptionV
  * console.log(args.id); // 'WU-123'
  * console.log(args.branchOnly); // true
  */
-export declare function parseWUArgs(argv: any): import("commander").OptionValues;
+export declare function parseWUArgs(argv: string[]): OptionValues;
 export {};

package/dist/arg-parser.js

@@ -323,12 +323,26 @@ export const WU_OPTIONS = {
         description: 'Code paths (repeatable)',
         isRepeatable: true,
     },
+    // WU-1300: Alias for --code-paths (singular form for convenience)
+    codePath: {
+        name: 'codePath',
+        flags: '--code-path <path>',
+        description: 'Alias for --code-paths (repeatable)',
+        isRepeatable: true,
+    },
     testPathsManual: {
         name: 'testPathsManual',
         flags: '--test-paths-manual <tests>',
         description: 'Manual test descriptions (repeatable)',
         isRepeatable: true,
     },
+    // WU-1300: Alias for --test-paths-manual (shorter form for convenience)
+    manualTest: {
+        name: 'manualTest',
+        flags: '--manual-test <test>',
+        description: 'Alias for --test-paths-manual (repeatable)',
+        isRepeatable: true,
+    },
     testPathsUnit: {
         name: 'testPathsUnit',
         flags: '--test-paths-unit <paths>',
@@ -562,8 +576,57 @@ export function createWUParser(config) {
     if (allowPositionalId && program.args.length > 0 && !opts.id) {
         opts.id = program.args[0];
     }
+    // WU-1300: Merge CLI aliases into their canonical options
+    opts = mergeAliasOptions(opts);
     return opts;
 }
+/**
+ * WU-1300: Option alias mappings (alias -> canonical)
+ * These allow users to use shorter/alternative flag names.
+ */
+const OPTION_ALIASES = {
+    codePath: 'codePaths',
+    manualTest: 'testPathsManual',
+};
+/**
+ * WU-1300: Merge alias options into their canonical counterparts.
+ * Supports both singular aliases (--code-path -> --code-paths)
+ * and alternative names (--manual-test -> --test-paths-manual).
+ *
+ * For repeatable options, values are concatenated.
+ * For single-value options, alias value is used if canonical is not set.
+ *
+ * @param {object} opts - Parsed options from Commander
+ * @returns {object} Options with aliases merged into canonical names
+ */
+function mergeAliasOptions(opts) {
+    const result = { ...opts };
+    for (const [alias, canonical] of Object.entries(OPTION_ALIASES)) {
+        const aliasValue = result[alias];
+        const canonicalValue = result[canonical];
+        if (aliasValue !== undefined && aliasValue !== null) {
+            // For arrays (repeatable options), concatenate
+            if (Array.isArray(aliasValue)) {
+                const existingArray = Array.isArray(canonicalValue) ? canonicalValue : [];
+                result[canonical] = [...existingArray, ...aliasValue];
+            }
+            else if (canonicalValue === undefined || canonicalValue === null) {
+                // For single values, only use alias if canonical not set
+                result[canonical] = aliasValue;
+            }
+            // Remove the alias from results (clean output)
+            // Build new result without the alias key to avoid dynamic delete
+        }
+    }
+    // Remove alias keys from final result
+    const finalResult = {};
+    for (const [key, value] of Object.entries(result)) {
+        if (!(key in OPTION_ALIASES)) {
+            finalResult[key] = value;
+        }
+    }
+    return finalResult;
+}
 /**
  * Backward-compatible unified argument parser for WU management scripts.
  * Uses commander internally but maintains the same return format.

package/dist/context/wu-state-reader.js

@@ -11,7 +11,7 @@
 import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { parse as parseYaml } from 'yaml';
-import { DIRECTORIES } from '../wu-constants.js';
+import { WU_PATHS } from '../wu-paths.js';
 /**
  * Normalize WU ID to uppercase format.
  */
@@ -24,10 +24,11 @@ function normalizeWuId(id) {
 }
 /**
  * Build the path to WU YAML file.
+ * WU-1301: Uses config-based paths instead of hardcoded DIRECTORIES.
  */
 function getWuYamlPath(wuId, repoRoot) {
     const normalizedId = normalizeWuId(wuId);
-    return join(repoRoot, DIRECTORIES.WU_DIR, `${normalizedId}.yaml`);
+    return join(repoRoot, WU_PATHS.WU(normalizedId));
 }
 /**
  * Read WU state from YAML and detect inconsistencies.

package/dist/lane-inference.js

@@ -31,7 +31,13 @@ function loadConfig(configPath = null) {
         configPath = path.join(projectRoot, '.lumenflow.lane-inference.yaml');
     }
     if (!existsSync(configPath)) {
-        throw createError(ErrorCodes.FILE_NOT_FOUND, `Lane inference config not found: ${configPath}\n\nRun WU-906 to create infrastructure files.`, { path: configPath });
+        throw createError(ErrorCodes.FILE_NOT_FOUND, `Lane inference config not found: ${configPath}\n\n` +
+            `This file defines the lane taxonomy for sub-lane validation.\n\n` +
+            `To fix this:\n` +
+            `  1. Generate a lane taxonomy from your codebase:\n` +
+            `     pnpm lane:suggest --output .lumenflow.lane-inference.yaml\n\n` +
+            `  2. Or copy from an example project and customize.\n\n` +
+            `See: LUMENFLOW.md "Setup Notes" section for details.`, { path: configPath });
     }
     try {
         const configContent = readFileSync(configPath, { encoding: 'utf-8' });
@@ -167,7 +173,7 @@ export function getAllSubLanes(configPath = null) {
             subLanes.push(`${parentLane}: ${subLane}`);
         }
     }
-    return subLanes.sort();
+    return subLanes.sort((a, b) => a.localeCompare(b));
 }
 /**
  * Get valid sub-lanes for a specific parent lane

package/dist/lumenflow-config-schema.d.ts

@@ -35,6 +35,7 @@ export declare const DirectoriesSchema: z.ZodObject<{
     statusPath: z.ZodDefault<z.ZodString>;
     skillsDir: z.ZodDefault<z.ZodString>;
     agentsDir: z.ZodDefault<z.ZodString>;
+    plansDir: z.ZodDefault<z.ZodString>;
 }, z.core.$strip>;
 /**
  * Beacon paths configuration (.lumenflow directory structure)
@@ -67,6 +68,7 @@ export declare const GitConfigSchema: z.ZodObject<{
     maxBranchDrift: z.ZodDefault<z.ZodNumber>;
     branchDriftWarning: z.ZodDefault<z.ZodNumber>;
     branchDriftInfo: z.ZodDefault<z.ZodNumber>;
+    requireRemote: z.ZodDefault<z.ZodBoolean>;
     agentBranchPatterns: z.ZodDefault<z.ZodArray<z.ZodString>>;
     agentBranchPatternsOverride: z.ZodOptional<z.ZodArray<z.ZodString>>;
     disableAgentPatternRegistry: z.ZodDefault<z.ZodBoolean>;
@@ -329,6 +331,7 @@ export declare const LumenFlowConfigSchema: z.ZodObject<{
         statusPath: z.ZodDefault<z.ZodString>;
         skillsDir: z.ZodDefault<z.ZodString>;
         agentsDir: z.ZodDefault<z.ZodString>;
+        plansDir: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
     beacon: z.ZodDefault<z.ZodObject<{
         base: z.ZodDefault<z.ZodString>;
@@ -355,6 +358,7 @@ export declare const LumenFlowConfigSchema: z.ZodObject<{
         maxBranchDrift: z.ZodDefault<z.ZodNumber>;
         branchDriftWarning: z.ZodDefault<z.ZodNumber>;
         branchDriftInfo: z.ZodDefault<z.ZodNumber>;
+        requireRemote: z.ZodDefault<z.ZodBoolean>;
         agentBranchPatterns: z.ZodDefault<z.ZodArray<z.ZodString>>;
         agentBranchPatternsOverride: z.ZodOptional<z.ZodArray<z.ZodString>>;
         disableAgentPatternRegistry: z.ZodDefault<z.ZodBoolean>;
@@ -544,6 +548,7 @@ export declare function validateConfig(data: unknown): z.ZodSafeParseResult<{
         statusPath: string;
         skillsDir: string;
         agentsDir: string;
+        plansDir: string;
     };
     beacon: {
         base: string;
@@ -570,6 +575,7 @@ export declare function validateConfig(data: unknown): z.ZodSafeParseResult<{
         maxBranchDrift: number;
         branchDriftWarning: number;
         branchDriftInfo: number;
+        requireRemote: boolean;
         agentBranchPatterns: string[];
         disableAgentPatternRegistry: boolean;
         agentBranchPatternsOverride?: string[];

package/dist/lumenflow-config-schema.js

@@ -67,6 +67,8 @@ export const DirectoriesSchema = z.object({
     skillsDir: z.string().default('.claude/skills'),
     /** Agents directory (default: '.claude/agents') */
     agentsDir: z.string().default('.claude/agents'),
+    /** Plans directory (default: 'docs/04-operations/plans') - WU-1301 */
+    plansDir: z.string().default('docs/04-operations/plans'),
 });
 /**
  * Beacon paths configuration (.lumenflow directory structure)
@@ -118,6 +120,25 @@ export const GitConfigSchema = z.object({
     branchDriftWarning: z.number().int().positive().default(15),
     /** Info threshold for branch drift */
     branchDriftInfo: z.number().int().positive().default(10),
+    /**
+     * WU-1302: Require a remote repository for wu:create and wu:claim.
+     * When true (default), operations fail if no remote 'origin' exists.
+     * When false, operations can proceed locally without pushing.
+     *
+     * Use `git.requireRemote: false` for:
+     * - Local-only development before remote is set up
+     * - Air-gapped environments
+     * - Testing/evaluation of LumenFlow
+     *
+     * @default true
+     *
+     * @example
+     * ```yaml
+     * git:
+     *   requireRemote: false  # Allow offline/local mode
+     * ```
+     */
+    requireRemote: z.boolean().default(true),
     /**
      * Agent branch patterns to MERGE with the registry patterns.
      * These patterns are merged with patterns from lumenflow.dev/registry/agent-patterns.json.

package/dist/lumenflow-config.d.ts

@@ -71,6 +71,7 @@ export declare function getResolvedPaths(options?: {
     skillsDir: string;
     agentsDir: string;
     memoryBank: string;
+    plansDir: string;
 };
 /**
  * Validate a config file
@@ -93,3 +94,4 @@ export declare function createSampleConfig(outputPath: string, options?: {
     includeComments?: boolean;
 }): void;
 export type { LumenFlowConfig, Directories, BeaconPaths, GitConfig, WuConfig, GatesConfig, MemoryConfig, UiConfig, YamlConfig, } from './lumenflow-config-schema.js';
+export { getDefaultConfig } from './lumenflow-config-schema.js';

package/dist/lumenflow-config.js

@@ -144,6 +144,7 @@ export function getResolvedPaths(options = {}) {
         skillsDir: path.join(projectRoot, config.directories.skillsDir),
         agentsDir: path.join(projectRoot, config.directories.agentsDir),
         memoryBank: path.join(projectRoot, config.directories.memoryBank),
+        plansDir: path.join(projectRoot, config.directories.plansDir),
     };
 }
 /**
@@ -234,3 +235,5 @@ gates:
         : yaml.stringify(defaultConfig);
     fs.writeFileSync(outputPath, configContent, 'utf8');
 }
+// Re-export getDefaultConfig for consumers
+export { getDefaultConfig } from './lumenflow-config-schema.js';

package/dist/wu-paths.d.ts

@@ -77,6 +77,11 @@ export declare function createWuPaths(options?: {
      * @returns Path to worktrees directory
      */
     WORKTREES_DIR: () => string;
+    /**
+     * Get path to plans directory
+     * @returns Path to plans directory (WU-1301)
+     */
+    PLANS_DIR: () => string;
 };
 /**
  * Default WU paths using default config
@@ -130,6 +135,11 @@ export declare const WU_PATHS: {
      * @returns Path to worktrees directory
      */
     WORKTREES_DIR: () => string;
+    /**
+     * Get path to plans directory
+     * @returns Path to plans directory (WU-1301)
+     */
+    PLANS_DIR: () => string;
 };
 /**
  * Generate default worktree path from WU document

package/dist/wu-paths.js

@@ -104,6 +104,11 @@ export function createWuPaths(options = {}) {
          * @returns Path to worktrees directory
          */
         WORKTREES_DIR: () => config.directories.worktrees,
+        /**
+         * Get path to plans directory
+         * @returns Path to plans directory (WU-1301)
+         */
+        PLANS_DIR: () => config.directories.plansDir,
     };
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/core",
-  "version": "2.3.1",
+  "version": "2.4.0",
   "description": "Core WU lifecycle tools for LumenFlow workflow framework",
   "keywords": [
     "lumenflow",
@@ -98,7 +98,7 @@
     "vitest": "^4.0.17"
   },
   "peerDependencies": {
-    "@lumenflow/memory": "2.3.1"
+    "@lumenflow/memory": "2.4.0"
   },
   "peerDependenciesMeta": {
     "@lumenflow/memory": {