@lumenflow/core 3.1.2 → 3.1.3

package/dist/wu-context-constants.js

@@ -1,267 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-/**
- * Context Validation Constants
- *
- * WU-1549: Extracted from wu-constants.ts for domain-specific modularity.
- * Contains context validation, hook messages, Claude Code hook constants,
- * and derived types for context validation.
- *
- * @module wu-context-constants
- */
-/**
- * Context validation constants (WU-1090)
- *
- * Constants for the context-aware state machine for WU lifecycle commands.
- * Supports unified context model, declarative command requirements,
- * smart validation, and recovery paths.
- */
-export const CONTEXT_VALIDATION = {
-    /** Location types for WU operations */
-    LOCATION_TYPES: {
-        /** Main checkout (not a worktree) */
-        MAIN: 'main',
-        /** Inside a worktree */
-        WORKTREE: 'worktree',
-        /** Detached HEAD state */
-        DETACHED: 'detached',
-        /** Unknown location (not a git repo or error) */
-        UNKNOWN: 'unknown',
-    },
-    /** Validation error codes */
-    ERROR_CODES: {
-        /** Command run from wrong location type */
-        WRONG_LOCATION: 'WRONG_LOCATION',
-        /** Target WU does not exist */
-        WU_NOT_FOUND: 'WU_NOT_FOUND',
-        /** WU with this ID already exists */
-        WU_ALREADY_EXISTS: 'WU_ALREADY_EXISTS',
-        /** WU in unexpected status for command */
-        WRONG_WU_STATUS: 'WRONG_WU_STATUS',
-        /** Lane already has WU in progress */
-        LANE_OCCUPIED: 'LANE_OCCUPIED',
-        /** Worktree already exists for WU */
-        WORKTREE_EXISTS: 'WORKTREE_EXISTS',
-        /** Expected worktree not found */
-        WORKTREE_MISSING: 'WORKTREE_MISSING',
-        /** Gates haven't run or failed */
-        GATES_NOT_PASSED: 'GATES_NOT_PASSED',
-        /** Uncommitted changes exist */
-        DIRTY_GIT: 'DIRTY_GIT',
-        /** Cannot reach origin remote */
-        REMOTE_UNAVAILABLE: 'REMOTE_UNAVAILABLE',
-        /** YAML and state store disagree */
-        INCONSISTENT_STATE: 'INCONSISTENT_STATE',
-    },
-    /** Recovery action types */
-    RECOVERY_ACTIONS: {
-        /** Reconcile state and continue working (preserves work) */
-        RESUME: 'resume',
-        /** Discard worktree, reset WU to ready */
-        RESET: 'reset',
-        /** Remove all artifacts completely (requires --force) */
-        NUKE: 'nuke',
-        /** Remove leftover worktree (for done WUs) */
-        CLEANUP: 'cleanup',
-        /** Complete a WU that is already merged but not stamped (WU-1746) */
-        COMPLETE: 'complete',
-    },
-    /** Recovery issue codes */
-    RECOVERY_ISSUES: {
-        /** Worktree exists but WU status is "ready" */
-        PARTIAL_CLAIM: 'PARTIAL_CLAIM',
-        /** WU is "in_progress" but worktree does not exist */
-        ORPHAN_CLAIM: 'ORPHAN_CLAIM',
-        /** YAML status differs from state store */
-        INCONSISTENT_STATE: 'INCONSISTENT_STATE',
-        /** Branch exists but worktree does not */
-        ORPHAN_BRANCH: 'ORPHAN_BRANCH',
-        /** Lock file from different WU */
-        STALE_LOCK: 'STALE_LOCK',
-        /** WU is done but worktree was not cleaned up */
-        LEFTOVER_WORKTREE: 'LEFTOVER_WORKTREE',
-        /** WU branch is merged to main but WU is not stamped as done (WU-1746) */
-        MERGED_NOT_DONE: 'MERGED_NOT_DONE',
-    },
-    /** Predicate severity levels */
-    SEVERITY: {
-        /** Blocks command execution */
-        ERROR: 'error',
-        /** Shows warning but allows execution */
-        WARNING: 'warning',
-    },
-    /** Performance thresholds */
-    THRESHOLDS: {
-        /** Max context computation time (ms) - acceptance criterion */
-        CONTEXT_COMPUTATION_MS: 100,
-        /** Max stale lock age (hours) */
-        STALE_LOCK_HOURS: 24,
-    },
-    /** Feature flag keys for .lumenflow.config.yaml */
-    FEATURE_FLAGS: {
-        /** Enable context-aware validation */
-        CONTEXT_VALIDATION: 'context_validation',
-        /** Validation behavior: 'off' | 'warn' | 'error' */
-        VALIDATION_MODE: 'validation_mode',
-        /** Show next steps after successful commands */
-        SHOW_NEXT_STEPS: 'show_next_steps',
-        /** Enable wu:recover command */
-        RECOVERY_COMMAND: 'recovery_command',
-    },
-    /** Validation modes */
-    VALIDATION_MODES: {
-        /** No validation (legacy behavior) */
-        OFF: 'off',
-        /** Show warnings but proceed */
-        WARN: 'warn',
-        /** Block on validation failures */
-        ERROR: 'error',
-    },
-    /** Command names for the registry */
-    COMMANDS: {
-        WU_CREATE: 'wu:create',
-        WU_CLAIM: 'wu:claim',
-        WU_PREP: 'wu:prep',
-        WU_DONE: 'wu:done',
-        WU_BLOCK: 'wu:block',
-        WU_UNBLOCK: 'wu:unblock',
-        WU_STATUS: 'wu:status',
-        WU_RECOVER: 'wu:recover',
-        GATES: 'gates',
-    },
-};
-/**
- * Git hook error messages (WU-1357)
- *
- * Educational, structured messages for git hook blocks.
- * Follows the "message bag" pattern: TITLE, WHY, ACTIONS, HELP, BYPASS.
- *
- * Design principles:
- * - Explain WHY before showing WHAT to do
- * - Provide multiple paths forward (not just one command)
- * - Put emergency bypass LAST with clear warnings
- * - Include help resources for learning
- *
- * @see .husky/hooks/pre-commit.mjs - Primary consumer
- */
-export const HOOK_MESSAGES = {
-    /**
-     * Main branch protection block message components
-     */
-    MAIN_BRANCH_BLOCK: {
-        /** Box drawing for visual structure */
-        BOX: {
-            TOP: '══════════════════════════════════════════════════════════════',
-            DIVIDER: '──────────────────────────────────────────────────────────────',
-        },
-        /** Title shown at the top */
-        TITLE: (branch) => `DIRECT COMMIT TO ${branch.toUpperCase()} BLOCKED`,
-        /** Educational explanation of WHY the block exists */
-        WHY: {
-            HEADER: 'WHY THIS HAPPENS',
-            LINES: [
-                'LumenFlow protects main from direct commits to ensure:',
-                '  • All work is tracked in Work Units (WUs)',
-                '  • Changes can be reviewed and coordinated',
-                '  • Parallel work across lanes stays isolated',
-            ],
-        },
-        /** Action paths - multiple ways forward */
-        ACTIONS: {
-            HEADER: 'WHAT TO DO',
-            HAVE_WU: {
-                HEADER: '1. If you have a Work Unit to implement:',
-                COMMANDS: ['pnpm wu:claim --id WU-XXXX --lane "<Lane>"', 'cd worktrees/<lane>-wu-xxxx'],
-                NOTE: 'Then make your commits there',
-            },
-            NEED_WU: {
-                HEADER: '2. If you need to create a new Work Unit:',
-                COMMANDS: ['pnpm wu:create --lane "<Lane>" --title "Your task"'],
-                NOTE: 'This generates a WU ID, then claim it as above',
-            },
-            LIST_LANES: {
-                HEADER: '3. Not sure what lane to use?',
-                COMMANDS: ['pnpm wu:list-lanes'],
-            },
-        },
-        /** Help resources */
-        HELP: {
-            HEADER: 'NEED HELP?',
-            RESOURCES: [
-                '• Read: LUMENFLOW.md (workflow overview)',
-                '• Read: docs/04-operations/_frameworks/lumenflow/agent/onboarding/',
-                '• Run:  pnpm wu:help',
-            ],
-        },
-        /** Emergency bypass (shown last, with warnings) */
-        BYPASS: {
-            HEADER: 'EMERGENCY BYPASS (logged, use sparingly)',
-            WARNING: 'Bypasses are audit-logged. Only use for genuine emergencies.',
-            COMMAND: 'LUMENFLOW_FORCE=1 LUMENFLOW_FORCE_REASON="<reason>" git commit ...',
-        },
-    },
-    /**
-     * Worktree discipline block message components
-     */
-    WORKTREE_BLOCK: {
-        TITLE: 'LANE BRANCH WORK SHOULD BE IN WORKTREE',
-        WHY: 'Worktrees provide isolation for parallel work. Working on a lane branch from the main checkout bypasses this isolation.',
-    },
-};
-/**
- * Canonical client IDs for client-specific integrations and config keys.
- *
- * Centralizes runtime client identifiers used across init/integrate flows
- * to avoid string literal drift between CLI commands and schema defaults.
- */
-export const LUMENFLOW_CLIENT_IDS = {
-    CLAUDE_CODE: 'claude-code',
-    CODEX_CLI: 'codex-cli',
-    CURSOR: 'cursor',
-    GEMINI_CLI: 'gemini-cli',
-    WINDSURF: 'windsurf',
-};
-/**
- * Claude Code hook script constants (WU-1394)
- *
- * Centralized constants for Claude Code enforcement and recovery hooks.
- * Used by enforcement-generator.ts, enforcement-sync.ts, and init.ts.
- *
- * @see packages/@lumenflow/cli/src/hooks/enforcement-generator.ts
- * @see packages/@lumenflow/cli/src/hooks/enforcement-sync.ts
- */
-export const CLAUDE_HOOKS = {
-    /** Hook script filenames */
-    SCRIPTS: {
-        ENFORCE_WORKTREE: 'enforce-worktree.sh',
-        REQUIRE_WU: 'require-wu.sh',
-        WARN_INCOMPLETE: 'warn-incomplete.sh',
-        PRE_COMPACT_CHECKPOINT: 'pre-compact-checkpoint.sh',
-        SESSION_START_RECOVERY: 'session-start-recovery.sh',
-        /** WU-1471: Auto-checkpoint hook for PostToolUse and SubagentStop events */
-        AUTO_CHECKPOINT: 'auto-checkpoint.sh',
-    },
-    /** Hook command path prefix (uses Claude Code's $CLAUDE_PROJECT_DIR variable) */
-    PATH_PREFIX: '$CLAUDE_PROJECT_DIR/.claude/hooks',
-    /** Hook matchers for settings.json */
-    MATCHERS: {
-        ALL: '.*',
-        WRITE_EDIT: 'Write|Edit',
-        COMPACT: 'compact',
-        RESUME: 'resume',
-        CLEAR: 'clear',
-        /** WU-1471: Matcher for SubagentStop hook event */
-        SUBAGENT_STOP: '.*',
-        /** WU-1502: Matcher for Bash tool PostToolUse */
-        BASH: 'Bash',
-    },
-    /** Template paths (relative to templates directory) */
-    TEMPLATES: {
-        SETTINGS: 'vendors/claude/.claude/settings.json.template',
-        PRE_COMPACT: 'vendors/claude/.claude/hooks/pre-compact-checkpoint.sh',
-        SESSION_START: 'vendors/claude/.claude/hooks/session-start-recovery.sh',
-    },
-};
-/** Build full hook command path from script name */
-export const getHookCommand = (scriptName) => `${CLAUDE_HOOKS.PATH_PREFIX}/${scriptName}`;
-//# sourceMappingURL=wu-context-constants.js.map

package/dist/wu-context-constants.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"wu-context-constants.js","sourceRoot":"","sources":["../src/wu-context-constants.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;GAQG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,uCAAuC;IACvC,cAAc,EAAE;QACd,qCAAqC;QACrC,IAAI,EAAE,MAAM;QACZ,wBAAwB;QACxB,QAAQ,EAAE,UAAU;QACpB,0BAA0B;QAC1B,QAAQ,EAAE,UAAU;QACpB,iDAAiD;QACjD,OAAO,EAAE,SAAS;KACV;IAEV,6BAA6B;IAC7B,WAAW,EAAE;QACX,2CAA2C;QAC3C,cAAc,EAAE,gBAAgB;QAChC,+BAA+B;QAC/B,YAAY,EAAE,cAAc;QAC5B,qCAAqC;QACrC,iBAAiB,EAAE,mBAAmB;QACtC,0CAA0C;QAC1C,eAAe,EAAE,iBAAiB;QAClC,sCAAsC;QACtC,aAAa,EAAE,eAAe;QAC9B,qCAAqC;QACrC,eAAe,EAAE,iBAAiB;QAClC,kCAAkC;QAClC,gBAAgB,EAAE,kBAAkB;QACpC,kCAAkC;QAClC,gBAAgB,EAAE,kBAAkB;QACpC,gCAAgC;QAChC,SAAS,EAAE,WAAW;QACtB,iCAAiC;QACjC,kBAAkB,EAAE,oBAAoB;QACxC,oCAAoC;QACpC,kBAAkB,EAAE,oBAAoB;KAChC;IAEV,4BAA4B;IAC5B,gBAAgB,EAAE;QAChB,4DAA4D;QAC5D,MAAM,EAAE,QAAQ;QAChB,0CAA0C;QAC1C,KAAK,EAAE,OAAO;QACd,yDAAyD;QACzD,IAAI,EAAE,MAAM;QACZ,8CAA8C;QAC9C,OAAO,EAAE,SAAS;QAClB,qEAAqE;QACrE,QAAQ,EAAE,UAAU;KACZ;IAEV,2BAA2B;IAC3B,eAAe,EAAE;QACf,+CAA+C;QAC/C,aAAa,EAAE,eAAe;QAC9B,sDAAsD;QACtD,YAAY,EAAE,cAAc;QAC5B,2CAA2C;QAC3C,kBAAkB,EAAE,oBAAoB;QACxC,0CAA0C;QAC1C,aAAa,EAAE,eAAe;QAC9B,kCAAkC;QAClC,UAAU,EAAE,YAAY;QACxB,iDAAiD;QACjD,iBAAiB,EAAE,mBAAmB;QACtC,0EAA0E;QAC1E,eAAe,EAAE,iBAAiB;KAC1B;IAEV,gCAAgC;IAChC,QAAQ,EAAE;QACR,+BAA+B;QAC/B,KAAK,EAAE,OAAO;QACd,yCAAyC;QACzC,OAAO,EAAE,SAAS;KACV;IAEV,6BAA6B;IAC7B,UAAU,EAAE;QACV,+DAA+D;QAC/D,sBAAsB,EAAE,GAAG;QAC3B,iCAAiC;QACjC,gBAAgB,EAAE,EAAE;KACrB;IAED,mDAAmD;IACnD,aAAa,EAAE;QACb,sCAAsC;QACtC,kBAAkB,EAAE,oBAAoB;QACxC,oDAAoD;QACpD,eAAe,EAAE,iBAAiB;QAClC,gDAAgD;QAChD,eAAe,EAAE,iBAAiB;QAClC,gCAAgC;QAChC,gBAAgB,EAAE,kBAAkB;KAC5B;IAEV,uBAAuB;IACvB,gBAAgB,EAAE;QAChB,sCAAsC;QACtC,GAAG,EAAE,KAAK;QACV,gCAAgC;QAChC,IAAI,EAAE,MAAM;QACZ,mCAAmC;QACnC,KAAK,EAAE,OAAO;KACN;IAEV,qCAAqC;IACrC,QAAQ,EAAE;QACR,SAAS,EAAE,WAAW;QACtB,QAAQ,EAAE,UAAU;QACpB,OAAO,EAAE,SAAS;QAClB,OAAO,EAAE,SAAS;QAClB,QAAQ,EAAE,UAAU;QACpB,UAAU,EAAE,YAAY;QACxB,SAAS,EAAE,WAAW;QACtB,UAAU,EAAE,YAAY;QACxB,KAAK,EAAE,OAAO;KACN;CACF,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B;;OAEG;IACH,iBAAiB,EAAE;QACjB,uCAAuC;QACvC,GAAG,EAAE;YACH,GAAG,EAAE,gEAAgE;YACrE,OAAO,EAAE,gEAAgE;SAC1E;QAED,6BAA6B;QAC7B,KAAK,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,oBAAoB,MAAM,CAAC,WAAW,EAAE,UAAU;QAE7E,sDAAsD;QACtD,GAAG,EAAE;YACH,MAAM,EAAE,kBAAkB;YAC1B,KAAK,EAAE;gBACL,wDAAwD;gBACxD,6CAA6C;gBAC7C,6CAA6C;gBAC7C,+CAA+C;aAChD;SACF;QAED,2CAA2C;QAC3C,OAAO,EAAE;YACP,MAAM,EAAE,YAAY;YACpB,OAAO,EAAE;gBACP,MAAM,EAAE,0CAA0C;gBAClD,QAAQ,EAAE,CAAC,4CAA4C,EAAE,6BAA6B,CAAC;gBACvF,IAAI,EAAE,8BAA8B;aACrC;YACD,OAAO,EAAE;gBACP,MAAM,EAAE,2CAA2C;gBACnD,QAAQ,EAAE,CAAC,oDAAoD,CAAC;gBAChE,IAAI,EAAE,gDAAgD;aACvD;YACD,UAAU,EAAE;gBACV,MAAM,EAAE,+BAA+B;gBACvC,QAAQ,EAAE,CAAC,oBAAoB,CAAC;aACjC;SACF;QAED,qBAAqB;QACrB,IAAI,EAAE;YACJ,MAAM,EAAE,YAAY;YACpB,SAAS,EAAE;gBACT,0CAA0C;gBAC1C,oEAAoE;gBACpE,sBAAsB;aACvB;SACF;QAED,mDAAmD;QACnD,MAAM,EAAE;YACN,MAAM,EAAE,0CAA0C;YAClD,OAAO,EAAE,8DAA8D;YACvE,OAAO,EAAE,oEAAoE;SAC9E;KACF;IAED;;OAEG;IACH,cAAc,EAAE;QACd,KAAK,EAAE,wCAAwC;QAC/C,GAAG,EAAE,yHAAyH;KAC/H;CACO,CAAC;AAEX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,WAAW,EAAE,aAAa;IAC1B,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE,YAAY;IACxB,QAAQ,EAAE,UAAU;CACZ,CAAC;AAKX;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,4BAA4B;IAC5B,OAAO,EAAE;QACP,gBAAgB,EAAE,qBAAqB;QACvC,UAAU,EAAE,eAAe;QAC3B,eAAe,EAAE,oBAAoB;QACrC,sBAAsB,EAAE,2BAA2B;QACnD,sBAAsB,EAAE,2BAA2B;QACnD,4EAA4E;QAC5E,eAAe,EAAE,oBAAoB;KACtC;IAED,iFAAiF;IACjF,WAAW,EAAE,mCAAmC;IAEhD,sCAAsC;IACtC,QAAQ,EAAE;QACR,GAAG,EAAE,IAAI;QACT,UAAU,EAAE,YAAY;QACxB,OAAO,EAAE,SAAS;QAClB,MAAM,EAAE,QAAQ;QAChB,KAAK,EAAE,OAAO;QACd,mDAAmD;QACnD,aAAa,EAAE,IAAI;QACnB,iDAAiD;QACjD,IAAI,EAAE,MAAM;KACb;IAED,uDAAuD;IACvD,SAAS,EAAE;QACT,QAAQ,EAAE,+CAA+C;QACzD,WAAW,EAAE,wDAAwD;QACrE,aAAa,EAAE,wDAAwD;KACxE;CACO,CAAC;AAEX,oDAAoD;AACpD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,UAAkB,EAAU,EAAE,CAC3D,GAAG,YAAY,CAAC,WAAW,IAAI,UAAU,EAAE,CAAC"}

package/dist/wu-create-defaults.d.ts

@@ -1,11 +0,0 @@
-#!/usr/bin/env node
-/**
- * Centralized wu:create defaults (WU-1444)
- *
- * Single source of truth for placeholder text used when creating plan-first WUs.
- */
-export declare const WU_CREATE_DEFAULTS: {
-    readonly AUTO_NOTES_PLACEHOLDER: "(auto) Add implementation notes, rollout context, or a short summary of the plan/conversation.";
-    readonly AUTO_MANUAL_TEST_PLACEHOLDER: "(auto) Manual check: verify acceptance criteria; add automated tests before changing code files.";
-};
-//# sourceMappingURL=wu-create-defaults.d.ts.map

package/dist/wu-create-defaults.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wu-create-defaults.d.ts","sourceRoot":"","sources":["../src/wu-create-defaults.ts"],"names":[],"mappings":";AAGA;;;;GAIG;AAEH,eAAO,MAAM,kBAAkB;;;CAKrB,CAAC"}

package/dist/wu-create-defaults.js

@@ -1,13 +0,0 @@
-#!/usr/bin/env node
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-/**
- * Centralized wu:create defaults (WU-1444)
- *
- * Single source of truth for placeholder text used when creating plan-first WUs.
- */
-export const WU_CREATE_DEFAULTS = {
-    AUTO_NOTES_PLACEHOLDER: '(auto) Add implementation notes, rollout context, or a short summary of the plan/conversation.',
-    AUTO_MANUAL_TEST_PLACEHOLDER: '(auto) Manual check: verify acceptance criteria; add automated tests before changing code files.',
-};
-//# sourceMappingURL=wu-create-defaults.js.map

package/dist/wu-create-defaults.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"wu-create-defaults.js","sourceRoot":"","sources":["../src/wu-create-defaults.ts"],"names":[],"mappings":";AACA,iCAAiC;AACjC,yCAAyC;AACzC;;;;GAIG;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,sBAAsB,EACpB,gGAAgG;IAClG,4BAA4B,EAC1B,kGAAkG;CAC5F,CAAC"}

package/dist/wu-create-validators.d.ts

@@ -1,89 +0,0 @@
-/**
- * WU-1069: Check if a path is a repo-internal path that should be rejected
- *
- * Repo-internal paths start with ./ or .lumenflow/ and indicate the agent
- * is attempting to store plans inside the repository instead of externally.
- *
- * @param {string} path - Path to check
- * @returns {boolean} True if path is repo-internal and should be rejected
- */
-export declare function isRepoInternalPath(path: string): boolean;
-/**
- * WU-1069: Build error message for repo-internal path rejection
- *
- * @param {string} path - The rejected path
- * @returns {string} Error message with correct format examples
- */
-export declare function buildRepoInternalPathError(path: string): string;
-/**
- * Generate a warning message when provided lane differs from inferred lane.
- *
- * Returns empty string if lanes match (no warning needed).
- *
- * @param {string} providedLane - Lane provided by the user
- * @param {string} inferredLane - Lane suggested by inference
- * @param {number} confidence - Confidence score (0-100)
- * @returns {string} Warning message or empty string if lanes match
- */
-export declare function generateLaneMismatchWarning(providedLane: UnsafeAny, inferredLane: UnsafeAny, confidence: UnsafeAny): string;
-/**
- * Check if lane validation should show a suggestion
- *
- * @param {string} providedLane - Lane provided by the user
- * @param {string[]} codePaths - Code paths from WU
- * @param {string} description - WU description
- * @param {Function} inferSubLane - Lane inference function
- * @returns {{ shouldWarn: boolean, warning: string }} Validation result
- */
-export declare function validateLaneWithInference(providedLane: UnsafeAny, codePaths: UnsafeAny, description: UnsafeAny, inferSubLane: UnsafeAny): {
-    shouldWarn: boolean;
-    warning: string;
-    inferredLane?: undefined;
-    confidence?: undefined;
-} | {
-    shouldWarn: boolean;
-    warning: string;
-    inferredLane: any;
-    confidence: any;
-};
-/**
- * WU-1062: Validate spec_refs paths
- *
- * Accepts:
- * - Repo-relative paths: docs/04-operations/plans/WU-XXX-plan.md
- * - External paths: lumenflow://plans/WU-XXX-plan.md
- * - Tilde paths: ~/.lumenflow/plans/WU-XXX-plan.md
- * - Env var paths: $LUMENFLOW_HOME/plans/WU-XXX-plan.md
- *
- * @param {string[]} specRefs - Array of spec reference paths
- * @returns {{ valid: boolean, errors: string[], warnings: string[] }} Validation result
- */
-export declare function validateSpecRefs(specRefs: string[]): {
-    valid: boolean;
-    errors: string[];
-    warnings: string[];
-};
-/**
- * WU-1062: Check if spec_refs contains external paths
- *
- * @param {string[]} specRefs - Array of spec reference paths
- * @returns {boolean} True if UnsafeAny spec_ref is an external path
- */
-export declare function hasExternalSpecRefs(specRefs: string[]): boolean;
-/**
- * WU-1429: Check if spec_refs is non-empty
- *
- * @param {string[]|undefined} specRefs - Array of spec reference paths
- * @returns {boolean} True if spec_refs contains at least one entry
- */
-export declare function hasSpecRefs(specRefs: string[] | undefined): boolean;
-/**
- * WU-1062: Normalize all spec_refs paths
- *
- * Expands external paths to absolute paths while keeping repo-relative paths unchanged.
- *
- * @param {string[]} specRefs - Array of spec reference paths
- * @returns {string[]} Normalized paths
- */
-export declare function normalizeSpecRefs(specRefs: string[]): string[];
-//# sourceMappingURL=wu-create-validators.d.ts.map

package/dist/wu-create-validators.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wu-create-validators.d.ts","sourceRoot":"","sources":["../src/wu-create-validators.ts"],"names":[],"mappings":"AA6BA;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU/D;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,SAAS,EACvB,YAAY,EAAE,SAAS,EACvB,UAAU,EAAE,SAAS,UAoBtB;AAwCD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,SAAS,EACvB,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,SAAS,EACtB,YAAY,EAAE,SAAS;;;;;;;;;;EAqBxB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG;IACpD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CA4CA;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAK/D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,OAAO,CAEnE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAK9D"}

package/dist/wu-create-validators.js

@@ -1,215 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-/**
- * WU Create Validators (WU-2107, WU-1062)
- *
- * Validation helpers for wu:create, including:
- * - Lane inference surfacing (WU-2107)
- * - External spec_refs validation (WU-1062)
- *
- * When agents create WUs, this module helps surface lane inference suggestions
- * to guide better lane selection and improve parallelization.
- *
- * WU-1062: Validates spec_refs paths, accepting both repo-relative paths
- * and external paths (lumenflow://, ~/.lumenflow/, $LUMENFLOW_HOME/).
- *
- * NOTE: This is domain-specific WU workflow code, not a general utility.
- * No external library exists for LumenFlow lane inference validation.
- */
-import { isExternalPath, normalizeSpecRef } from './lumenflow-home.js';
-import { PATH_LITERALS } from './wu-constants.js';
-/** Confidence threshold for showing suggestion (percentage) */
-const CONFIDENCE_THRESHOLD_LOW = 30;
-/** Prefixes that indicate repo-internal paths (WU-1069, WU-1430: Use centralized constants) */
-const REPO_INTERNAL_PREFIXES = [PATH_LITERALS.CURRENT_DIR_PREFIX, PATH_LITERALS.LUMENFLOW_PREFIX];
-/**
- * WU-1069: Check if a path is a repo-internal path that should be rejected
- *
- * Repo-internal paths start with ./ or .lumenflow/ and indicate the agent
- * is attempting to store plans inside the repository instead of externally.
- *
- * @param {string} path - Path to check
- * @returns {boolean} True if path is repo-internal and should be rejected
- */
-export function isRepoInternalPath(path) {
-    return REPO_INTERNAL_PREFIXES.some((prefix) => path.startsWith(prefix));
-}
-/**
- * WU-1069: Build error message for repo-internal path rejection
- *
- * @param {string} path - The rejected path
- * @returns {string} Error message with correct format examples
- */
-export function buildRepoInternalPathError(path) {
-    return (`Rejected repo-internal spec_ref path: "${path}"\n` +
-        `Plans must be stored externally, not inside the repository.\n\n` +
-        `Valid path formats:\n` +
-        `  - lumenflow://plans/WU-XXXX-plan.md (recommended)\n` +
-        `  - ~/.lumenflow/plans/WU-XXXX-plan.md\n` +
-        `  - $LUMENFLOW_HOME/plans/WU-XXXX-plan.md\n\n` +
-        `Use --plan flag to auto-create: pnpm wu:create --plan --id WU-XXXX ...`);
-}
-/**
- * Generate a warning message when provided lane differs from inferred lane.
- *
- * Returns empty string if lanes match (no warning needed).
- *
- * @param {string} providedLane - Lane provided by the user
- * @param {string} inferredLane - Lane suggested by inference
- * @param {number} confidence - Confidence score (0-100)
- * @returns {string} Warning message or empty string if lanes match
- */
-export function generateLaneMismatchWarning(providedLane, inferredLane, confidence) {
-    // Normalize lanes for comparison (handle parent-only vs sub-lane)
-    const normalizedProvided = providedLane.trim();
-    const normalizedInferred = inferredLane.trim();
-    // If lanes match exactly, no warning needed
-    if (normalizedProvided === normalizedInferred) {
-        return '';
-    }
-    // Check if provided is parent-only and inferred is a sub-lane of that parent
-    const inferredParent = normalizedInferred.split(':')[0].trim();
-    if (normalizedProvided === inferredParent) {
-        // User provided parent-only, suggest the specific sub-lane
-        return formatWarningMessage(normalizedInferred, confidence, true);
-    }
-    // Lanes are different, show suggestion
-    return formatWarningMessage(normalizedInferred, confidence, false);
-}
-/**
- * Format the warning message based on confidence level
- *
- * @param {string} suggestedLane - The suggested lane
- * @param {number} confidence - Confidence score (0-100)
- * @param {boolean} isSubLaneSuggestion - True if suggesting sub-lane for parent-only input
- * @returns {string} Formatted warning message
- */
-function formatWarningMessage(suggestedLane, confidence, isSubLaneSuggestion) {
-    const confidenceStr = `${confidence}%`;
-    if (confidence < CONFIDENCE_THRESHOLD_LOW) {
-        return (`Lane suggestion (low confidence ${confidenceStr}): "${suggestedLane}"\n` +
-            `Run: pnpm wu:infer-lane --id WU-XXX to verify\n` +
-            `See: .lumenflow.lane-inference.yaml for lane taxonomy`);
-    }
-    if (isSubLaneSuggestion) {
-        return (`Suggested sub-lane (${confidenceStr} confidence): "${suggestedLane}"\n` +
-            `Using specific sub-lanes improves parallelization.\n` +
-            `Run: pnpm wu:infer-lane --id WU-XXX to verify`);
-    }
-    return (`Lane inference suggests: "${suggestedLane}" (${confidenceStr} confidence)\n` +
-        `Consider using the inferred lane for better lane distribution.\n` +
-        `Run: pnpm wu:infer-lane --id WU-XXX to verify`);
-}
-/**
- * Check if lane validation should show a suggestion
- *
- * @param {string} providedLane - Lane provided by the user
- * @param {string[]} codePaths - Code paths from WU
- * @param {string} description - WU description
- * @param {Function} inferSubLane - Lane inference function
- * @returns {{ shouldWarn: boolean, warning: string }} Validation result
- */
-export function validateLaneWithInference(providedLane, codePaths, description, inferSubLane) {
-    // Skip inference if no code paths provided
-    if (!codePaths || codePaths.length === 0) {
-        return { shouldWarn: false, warning: '' };
-    }
-    try {
-        const { lane: inferredLane, confidence } = inferSubLane(codePaths, description);
-        const warning = generateLaneMismatchWarning(providedLane, inferredLane, confidence);
-        return {
-            shouldWarn: warning.length > 0,
-            warning,
-            inferredLane,
-            confidence,
-        };
-    }
-    catch {
-        // Inference failed, don't block creation
-        return { shouldWarn: false, warning: '' };
-    }
-}
-/**
- * WU-1062: Validate spec_refs paths
- *
- * Accepts:
- * - Repo-relative paths: docs/04-operations/plans/WU-XXX-plan.md
- * - External paths: lumenflow://plans/WU-XXX-plan.md
- * - Tilde paths: ~/.lumenflow/plans/WU-XXX-plan.md
- * - Env var paths: $LUMENFLOW_HOME/plans/WU-XXX-plan.md
- *
- * @param {string[]} specRefs - Array of spec reference paths
- * @returns {{ valid: boolean, errors: string[], warnings: string[] }} Validation result
- */
-export function validateSpecRefs(specRefs) {
-    const errors = [];
-    const warnings = [];
-    if (!specRefs || specRefs.length === 0) {
-        return { valid: true, errors, warnings };
-    }
-    for (const ref of specRefs) {
-        // Check for empty refs
-        if (!ref || ref.trim().length === 0) {
-            errors.push('Empty spec_ref detected');
-            continue;
-        }
-        // WU-1069: Reject repo-internal paths (paths starting with ./ or .lumenflow/)
-        // This prevents agents from storing plans inside the repository
-        if (isRepoInternalPath(ref)) {
-            errors.push(buildRepoInternalPathError(ref));
-            continue;
-        }
-        // External paths are valid (will be resolved at runtime)
-        if (isExternalPath(ref)) {
-            // Add informational warning about external paths
-            warnings.push(`External spec_ref: "${ref}" - ensure plan exists at ${normalizeSpecRef(ref)}`);
-            continue;
-        }
-        // Repo-relative paths should follow conventions (docs/ without ./ prefix)
-        const isValidRepoPath = ref.startsWith('docs/') || ref.endsWith('.md');
-        if (!isValidRepoPath) {
-            warnings.push(`Unconventional spec_ref path: "${ref}" - consider using docs/04-operations/plans/ or lumenflow://plans/`);
-        }
-    }
-    return {
-        valid: errors.length === 0,
-        errors,
-        warnings,
-    };
-}
-/**
- * WU-1062: Check if spec_refs contains external paths
- *
- * @param {string[]} specRefs - Array of spec reference paths
- * @returns {boolean} True if UnsafeAny spec_ref is an external path
- */
-export function hasExternalSpecRefs(specRefs) {
-    if (!specRefs || specRefs.length === 0) {
-        return false;
-    }
-    return specRefs.some((ref) => isExternalPath(ref));
-}
-/**
- * WU-1429: Check if spec_refs is non-empty
- *
- * @param {string[]|undefined} specRefs - Array of spec reference paths
- * @returns {boolean} True if spec_refs contains at least one entry
- */
-export function hasSpecRefs(specRefs) {
-    return Array.isArray(specRefs) && specRefs.length > 0;
-}
-/**
- * WU-1062: Normalize all spec_refs paths
- *
- * Expands external paths to absolute paths while keeping repo-relative paths unchanged.
- *
- * @param {string[]} specRefs - Array of spec reference paths
- * @returns {string[]} Normalized paths
- */
-export function normalizeSpecRefs(specRefs) {
-    if (!specRefs || specRefs.length === 0) {
-        return [];
-    }
-    return specRefs.map((ref) => normalizeSpecRef(ref));
-}
-//# sourceMappingURL=wu-create-validators.js.map

package/dist/wu-create-validators.js.map

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