@lumenflow/core 1.3.0 → 1.3.3

package/dist/wu-constants.d.ts

@@ -40,6 +40,10 @@ export declare const GIT_REFS: {
     ORIGIN_MAIN: string;
     /** Current HEAD ref */
     HEAD: string;
+    /** Upstream ref */
+    UPSTREAM: string;
+    /** Range of upstream..HEAD */
+    UPSTREAM_RANGE: string;
     /** Fetch head ref */
     FETCH_HEAD: string;
 };
@@ -258,6 +262,22 @@ export declare const CONSISTENCY_TYPES: {
     ORPHAN_WORKTREE_DONE: string;
     /** Stamp file exists but WU YAML status is not 'done' (partial wu:done failure) */
     STAMP_EXISTS_YAML_NOT_DONE: string;
+    /** WU is claimed but its worktree directory is missing */
+    MISSING_WORKTREE_CLAIMED: string;
+};
+/**
+ * Consistency check messages
+ */
+export declare const CONSISTENCY_MESSAGES: {
+    MISSING_WORKTREE_CLAIMED: (id: any, status: any, worktreePath: any) => string;
+    MISSING_WORKTREE_CLAIMED_REPAIR: string;
+};
+/**
+ * Worktree warning messages
+ */
+export declare const WORKTREE_WARNINGS: {
+    MISSING_TRACKED_HEADER: string;
+    MISSING_TRACKED_LINE: (worktreePath: any) => string;
 };
 /**
  * File system constants
@@ -364,6 +384,55 @@ export declare const DEFAULTS: {
     MAX_COMMIT_SUBJECT: number;
     /** Parent directory traversal depth from tools/lib to project root */
     PROJECT_ROOT_DEPTH: number;
+    /**
+     * Default email domain for username -> email conversion
+     * WU-1068: Made configurable, no longer hardcoded to patientpath.co.uk
+     * @see user-normalizer.ts - Infers from git config first
+     */
+    EMAIL_DOMAIN: string;
+};
+/**
+ * Process argv indices (WU-1068)
+ *
+ * Centralized indices for process.argv access to eliminate magic numbers.
+ * In Node.js: argv[0] = node, argv[1] = script, argv[2+] = args
+ */
+export declare const ARGV_INDICES: {
+    /** Node executable path */
+    NODE: number;
+    /** Script path */
+    SCRIPT: number;
+    /** First user argument */
+    FIRST_ARG: number;
+    /** Second user argument */
+    SECOND_ARG: number;
+};
+/**
+ * Display limits for CLI output (WU-1068)
+ *
+ * Centralized limits for truncating display strings to avoid magic numbers.
+ */
+export declare const DISPLAY_LIMITS: {
+    /** Maximum items to show in lists before truncating */
+    LIST_ITEMS: number;
+    /** Maximum items to show in short lists */
+    SHORT_LIST: number;
+    /** Maximum characters for content preview */
+    CONTENT_PREVIEW: number;
+    /** Maximum characters for short preview */
+    SHORT_PREVIEW: number;
+    /** Maximum characters for title display */
+    TITLE: number;
+    /** Maximum characters for truncated title */
+    TRUNCATED_TITLE: number;
+    /** Maximum characters for command preview */
+    CMD_PREVIEW: number;
+    /** Maximum lines to preview from files */
+    FILE_LINES: number;
+    /** Maximum commits to show in lists */
+    COMMITS: number;
+    /** Maximum overlaps to display */
+    OVERLAPS: number;
 };
 /**
  * YAML serialization options
@@ -404,6 +473,59 @@ export declare const BOX: {
     /** Side border for content lines */
     SIDE: string;
 };
+/**
+ * Cleanup guard constants
+ */
+export declare const CLEANUP_GUARD: {
+    REASONS: {
+        UNCOMMITTED_CHANGES: string;
+        UNPUSHED_COMMITS: string;
+        STATUS_NOT_DONE: string;
+        MISSING_STAMP: string;
+        PR_NOT_MERGED: string;
+    };
+    TITLES: {
+        BLOCKED: string;
+        NEXT_STEPS: string;
+    };
+    MESSAGES: {
+        UNCOMMITTED_CHANGES: string;
+        UNPUSHED_COMMITS: string;
+        STATUS_NOT_DONE: string;
+        MISSING_STAMP: string;
+        PR_NOT_MERGED: string;
+    };
+    NEXT_STEPS: {
+        DEFAULT: {
+            text: string;
+            appendId: boolean;
+        }[];
+        UNCOMMITTED_CHANGES: {
+            text: string;
+            appendId: boolean;
+        }[];
+        UNPUSHED_COMMITS: {
+            text: string;
+            appendId: boolean;
+        }[];
+        STATUS_NOT_DONE: {
+            text: string;
+            appendId: boolean;
+        }[];
+        MISSING_STAMP: {
+            text: string;
+            appendId: boolean;
+        }[];
+        PR_NOT_MERGED: {
+            text: string;
+            appendId: boolean;
+        }[];
+    };
+    PR_CHECK: {
+        START: string;
+        RESULT: string;
+    };
+};
 /**
  * Git display constants
  *
@@ -459,6 +581,8 @@ export declare const GIT_FLAGS: {
     DELETE: string;
     /** Delete branch (force - even if not merged) */
     DELETE_FORCE: string;
+    /** Delete remote branch flag (for git push --delete) */
+    DELETE_REMOTE: string;
     /** Hard reset flag */
     HARD: string;
     /** Soft reset flag */
@@ -471,6 +595,12 @@ export declare const GIT_FLAGS: {
     NO_VERIFY: string;
     /** No GPG sign flag (skip commit signing) */
     NO_GPG_SIGN: string;
+    /** One-line log format */
+    ONELINE: string;
+    /** List heads only (for ls-remote) */
+    HEADS: string;
+    /** Path separator (separates git options from file paths) */
+    PATH_SEPARATOR: string;
 };
 /**
  * Git commands
@@ -485,8 +615,14 @@ export declare const GIT_COMMANDS: {
     RESET: string;
     /** List tree objects (check file existence on branch) */
     LS_TREE: string;
+    /** List remote references */
+    LS_REMOTE: string;
+    /** Push command */
+    PUSH: string;
     /** Git diff command */
     DIFF: string;
+    /** Git log command */
+    LOG: string;
     /** Git merge-base command */
     MERGE_BASE: string;
     /** Git rev-parse command */
@@ -654,6 +790,9 @@ export declare const WU_DEFAULTS: {
  *
  * Validation is advisory only - never blocks wu:claim or wu:done.
  *
+ * WU-1068: Removed hardcoded @patientpath references. These patterns
+ * should be configured in .lumenflow.config.yaml per-project.
+ *
  * @see {@link tools/lib/lane-validator.mjs} - Validation logic
  */
 export declare const LANE_PATH_PATTERNS: {
@@ -856,6 +995,8 @@ export declare const PKG_COMMANDS: {
  * Package names (monorepo workspaces)
  *
  * Centralized package names for --filter usage.
+ * WU-1068: Changed from @patientpath to @lumenflow for framework reusability.
+ * Project-specific packages should be configured in .lumenflow.config.yaml.
  */
 export declare const PACKAGES: {
     WEB: string;
@@ -1133,6 +1274,32 @@ export declare const STRING_LITERALS: {
     /** Forward slash */
     SLASH: string;
 };
+/**
+ * Path-related constants
+ *
+ * WU-1062: Centralized path literals for lumenflow-home and spec-branch operations.
+ */
+export declare const PATH_LITERALS: {
+    /** Tilde prefix for home directory expansion (e.g., ~/path) */
+    TILDE_PREFIX: string;
+    /** Tilde character for home directory */
+    TILDE: string;
+    /** Plan file suffix for WU plans */
+    PLAN_FILE_SUFFIX: string;
+    /** Trailing slash regex pattern */
+    TRAILING_SLASH_REGEX: RegExp;
+};
+/**
+ * Slice lengths for path operations
+ *
+ * WU-1062: Magic numbers extracted for path manipulation.
+ */
+export declare const PATH_SLICE_LENGTHS: {
+    /** Length of '~/' prefix for tilde expansion */
+    TILDE_PREFIX_LENGTH: number;
+    /** Length of '/' for leading slash removal */
+    LEADING_SLASH_LENGTH: number;
+};
 /**
  * Convert lane name to kebab-case using change-case library
  *
@@ -1199,6 +1366,9 @@ export declare const FILE_TOOLS: {
  *
  * Error codes for PHI detection in file tools.
  * Used by file:write and file:edit to block PHI leakage.
+ *
+ * WU-1068: PHI scanning is healthcare-specific functionality.
+ * Enable via PHI_CONFIG.ENABLED flag or .lumenflow.config.yaml phi.enabled: true
  */
 export declare const PHI_ERRORS: {
     /** PHI detected in content - write blocked */
@@ -1206,6 +1376,29 @@ export declare const PHI_ERRORS: {
     /** PHI override requested - audit logged */
     PHI_OVERRIDE_ALLOWED: string;
 };
+/**
+ * PHI scanning configuration (WU-1068)
+ *
+ * Controls whether PHI (Protected Health Information) scanning is enabled.
+ * This is healthcare-specific functionality (NHS numbers, UK postcodes)
+ * that should only be enabled for healthcare projects.
+ *
+ * Projects can enable via:
+ * 1. Setting PHI_CONFIG.ENABLED = true in code
+ * 2. Setting LUMENFLOW_PHI_ENABLED=1 environment variable
+ * 3. Adding phi.enabled: true to .lumenflow.config.yaml
+ */
+export declare const PHI_CONFIG: {
+    /**
+     * Whether PHI scanning is enabled
+     * Default: false - projects must explicitly opt-in
+     */
+    ENABLED: boolean;
+    /**
+     * Whether to block on PHI detection (true) or just warn (false)
+     */
+    BLOCKING: boolean;
+};
 /**
  * Readiness summary UI constants (WU-1620)
  *

package/dist/wu-constants.js

@@ -42,6 +42,10 @@ export const GIT_REFS = {
     ORIGIN_MAIN: 'origin/main',
     /** Current HEAD ref */
     HEAD: 'HEAD',
+    /** Upstream ref */
+    UPSTREAM: '@{u}',
+    /** Range of upstream..HEAD */
+    UPSTREAM_RANGE: '@{u}..HEAD',
     /** Fetch head ref */
     FETCH_HEAD: 'FETCH_HEAD',
 };
@@ -273,6 +277,22 @@ export const CONSISTENCY_TYPES = {
     ORPHAN_WORKTREE_DONE: 'ORPHAN_WORKTREE_DONE',
     /** Stamp file exists but WU YAML status is not 'done' (partial wu:done failure) */
     STAMP_EXISTS_YAML_NOT_DONE: 'STAMP_EXISTS_YAML_NOT_DONE',
+    /** WU is claimed but its worktree directory is missing */
+    MISSING_WORKTREE_CLAIMED: 'MISSING_WORKTREE_CLAIMED',
+};
+/**
+ * Consistency check messages
+ */
+export const CONSISTENCY_MESSAGES = {
+    MISSING_WORKTREE_CLAIMED: (id, status, worktreePath) => `WU ${id} is '${status}' but worktree path is missing (${worktreePath})`,
+    MISSING_WORKTREE_CLAIMED_REPAIR: 'Recover worktree or re-claim WU',
+};
+/**
+ * Worktree warning messages
+ */
+export const WORKTREE_WARNINGS = {
+    MISSING_TRACKED_HEADER: 'Tracked worktrees missing on disk (possible manual deletion):',
+    MISSING_TRACKED_LINE: (worktreePath) => `Missing: ${worktreePath}`,
 };
 /**
  * File system constants
@@ -386,6 +406,55 @@ export const DEFAULTS = {
     MAX_COMMIT_SUBJECT: 100,
     /** Parent directory traversal depth from tools/lib to project root */
     PROJECT_ROOT_DEPTH: 2,
+    /**
+     * Default email domain for username -> email conversion
+     * WU-1068: Made configurable, no longer hardcoded to patientpath.co.uk
+     * @see user-normalizer.ts - Infers from git config first
+     */
+    EMAIL_DOMAIN: 'example.com',
+};
+/**
+ * Process argv indices (WU-1068)
+ *
+ * Centralized indices for process.argv access to eliminate magic numbers.
+ * In Node.js: argv[0] = node, argv[1] = script, argv[2+] = args
+ */
+export const ARGV_INDICES = {
+    /** Node executable path */
+    NODE: 0,
+    /** Script path */
+    SCRIPT: 1,
+    /** First user argument */
+    FIRST_ARG: 2,
+    /** Second user argument */
+    SECOND_ARG: 3,
+};
+/**
+ * Display limits for CLI output (WU-1068)
+ *
+ * Centralized limits for truncating display strings to avoid magic numbers.
+ */
+export const DISPLAY_LIMITS = {
+    /** Maximum items to show in lists before truncating */
+    LIST_ITEMS: 5,
+    /** Maximum items to show in short lists */
+    SHORT_LIST: 3,
+    /** Maximum characters for content preview */
+    CONTENT_PREVIEW: 200,
+    /** Maximum characters for short preview */
+    SHORT_PREVIEW: 60,
+    /** Maximum characters for title display */
+    TITLE: 50,
+    /** Maximum characters for truncated title */
+    TRUNCATED_TITLE: 40,
+    /** Maximum characters for command preview */
+    CMD_PREVIEW: 60,
+    /** Maximum lines to preview from files */
+    FILE_LINES: 10,
+    /** Maximum commits to show in lists */
+    COMMITS: 50,
+    /** Maximum overlaps to display */
+    OVERLAPS: 3,
 };
 /**
  * YAML serialization options
@@ -426,6 +495,62 @@ export const BOX = {
     /** Side border for content lines */
     SIDE: '║',
 };
+/**
+ * Cleanup guard constants
+ */
+export const CLEANUP_GUARD = {
+    REASONS: {
+        UNCOMMITTED_CHANGES: 'UNCOMMITTED_CHANGES',
+        UNPUSHED_COMMITS: 'UNPUSHED_COMMITS',
+        STATUS_NOT_DONE: 'STATUS_NOT_DONE',
+        MISSING_STAMP: 'MISSING_STAMP',
+        PR_NOT_MERGED: 'PR_NOT_MERGED',
+    },
+    TITLES: {
+        BLOCKED: 'CLEANUP BLOCKED',
+        NEXT_STEPS: 'Next steps:',
+    },
+    MESSAGES: {
+        UNCOMMITTED_CHANGES: 'Worktree has uncommitted changes. Refusing to delete.',
+        UNPUSHED_COMMITS: 'Worktree has unpushed commits. Refusing to delete.',
+        STATUS_NOT_DONE: 'WU YAML status is not done. Refusing to delete.',
+        MISSING_STAMP: 'WU stamp is missing. Refusing to delete.',
+        PR_NOT_MERGED: 'PR is not merged (or cannot be verified). Refusing to delete.',
+    },
+    NEXT_STEPS: {
+        DEFAULT: [
+            { text: '1. Resolve the issue above', appendId: false },
+            { text: '2. Re-run: pnpm wu:cleanup --id', appendId: true },
+        ],
+        UNCOMMITTED_CHANGES: [
+            { text: '1. Commit or stash changes in the worktree', appendId: false },
+            { text: '2. Re-run: pnpm wu:cleanup --id', appendId: true },
+        ],
+        UNPUSHED_COMMITS: [
+            { text: '1. Push the lane branch to origin', appendId: false },
+            { text: '2. Re-run: pnpm wu:cleanup --id', appendId: true },
+        ],
+        STATUS_NOT_DONE: [
+            {
+                text: `1. Complete the WU with ${LOG_PREFIX.DONE} (creates stamp + done status)`,
+                appendId: false,
+            },
+            { text: '2. Re-run: pnpm wu:cleanup --id', appendId: true },
+        ],
+        MISSING_STAMP: [
+            { text: '1. Run wu:done to create the stamp file', appendId: false },
+            { text: '2. Re-run: pnpm wu:cleanup --id', appendId: true },
+        ],
+        PR_NOT_MERGED: [
+            { text: '1. Merge the PR in GitHub', appendId: false },
+            { text: '2. Re-run: pnpm wu:cleanup --id', appendId: true },
+        ],
+    },
+    PR_CHECK: {
+        START: 'Verifying PR merge status...',
+        RESULT: 'PR merge verification via',
+    },
+};
 /**
  * Git display constants
  *
@@ -481,6 +606,8 @@ export const GIT_FLAGS = {
     DELETE: '-d',
     /** Delete branch (force - even if not merged) */
     DELETE_FORCE: '-D',
+    /** Delete remote branch flag (for git push --delete) */
+    DELETE_REMOTE: '--delete',
     /** Hard reset flag */
     HARD: '--hard',
     /** Soft reset flag */
@@ -493,6 +620,12 @@ export const GIT_FLAGS = {
     NO_VERIFY: '--no-verify',
     /** No GPG sign flag (skip commit signing) */
     NO_GPG_SIGN: '--no-gpg-sign',
+    /** One-line log format */
+    ONELINE: '--oneline',
+    /** List heads only (for ls-remote) */
+    HEADS: '--heads',
+    /** Path separator (separates git options from file paths) */
+    PATH_SEPARATOR: '--',
 };
 /**
  * Git commands
@@ -507,8 +640,14 @@ export const GIT_COMMANDS = {
     RESET: 'reset',
     /** List tree objects (check file existence on branch) */
     LS_TREE: 'ls-tree',
+    /** List remote references */
+    LS_REMOTE: 'ls-remote',
+    /** Push command */
+    PUSH: 'push',
     /** Git diff command */
     DIFF: 'diff',
+    /** Git log command */
+    LOG: 'log',
     /** Git merge-base command */
     MERGE_BASE: 'merge-base',
     /** Git rev-parse command */
@@ -690,6 +829,9 @@ export const WU_DEFAULTS = {
  *
  * Validation is advisory only - never blocks wu:claim or wu:done.
  *
+ * WU-1068: Removed hardcoded @patientpath references. These patterns
+ * should be configured in .lumenflow.config.yaml per-project.
+ *
  * @see {@link tools/lib/lane-validator.mjs} - Validation logic
  */
 export const LANE_PATH_PATTERNS = {
@@ -698,7 +840,7 @@ export const LANE_PATH_PATTERNS = {
      * These paths belong to the Intelligence lane.
      */
     Operations: {
-        exclude: ['ai/prompts/**', 'packages/@patientpath/prompts/**', 'apps/web/src/lib/prompts/**'],
+        exclude: ['ai/prompts/**', 'apps/web/src/lib/prompts/**'],
         allowExceptions: [],
     },
     /**
@@ -895,12 +1037,14 @@ export const PKG_COMMANDS = {
  * Package names (monorepo workspaces)
  *
  * Centralized package names for --filter usage.
+ * WU-1068: Changed from @patientpath to @lumenflow for framework reusability.
+ * Project-specific packages should be configured in .lumenflow.config.yaml.
  */
 export const PACKAGES = {
     WEB: 'web',
-    APPLICATION: '@patientpath/application',
-    DOMAIN: '@patientpath/domain',
-    INFRASTRUCTURE: '@patientpath/infrastructure',
+    APPLICATION: '@lumenflow/core',
+    DOMAIN: '@lumenflow/core',
+    INFRASTRUCTURE: '@lumenflow/cli',
 };
 /**
  * Directory paths within the monorepo
@@ -1173,6 +1317,32 @@ export const STRING_LITERALS = {
     /** Forward slash */
     SLASH: '/',
 };
+/**
+ * Path-related constants
+ *
+ * WU-1062: Centralized path literals for lumenflow-home and spec-branch operations.
+ */
+export const PATH_LITERALS = {
+    /** Tilde prefix for home directory expansion (e.g., ~/path) */
+    TILDE_PREFIX: '~/',
+    /** Tilde character for home directory */
+    TILDE: '~',
+    /** Plan file suffix for WU plans */
+    PLAN_FILE_SUFFIX: '-plan.md',
+    /** Trailing slash regex pattern */
+    TRAILING_SLASH_REGEX: /\/+$/,
+};
+/**
+ * Slice lengths for path operations
+ *
+ * WU-1062: Magic numbers extracted for path manipulation.
+ */
+export const PATH_SLICE_LENGTHS = {
+    /** Length of '~/' prefix for tilde expansion */
+    TILDE_PREFIX_LENGTH: 2,
+    /** Length of '/' for leading slash removal */
+    LEADING_SLASH_LENGTH: 1,
+};
 /**
  * Convert lane name to kebab-case using change-case library
  *
@@ -1257,6 +1427,9 @@ export const FILE_TOOLS = {
  *
  * Error codes for PHI detection in file tools.
  * Used by file:write and file:edit to block PHI leakage.
+ *
+ * WU-1068: PHI scanning is healthcare-specific functionality.
+ * Enable via PHI_CONFIG.ENABLED flag or .lumenflow.config.yaml phi.enabled: true
  */
 export const PHI_ERRORS = {
     /** PHI detected in content - write blocked */
@@ -1264,6 +1437,29 @@ export const PHI_ERRORS = {
     /** PHI override requested - audit logged */
     PHI_OVERRIDE_ALLOWED: 'PHI_OVERRIDE_ALLOWED',
 };
+/**
+ * PHI scanning configuration (WU-1068)
+ *
+ * Controls whether PHI (Protected Health Information) scanning is enabled.
+ * This is healthcare-specific functionality (NHS numbers, UK postcodes)
+ * that should only be enabled for healthcare projects.
+ *
+ * Projects can enable via:
+ * 1. Setting PHI_CONFIG.ENABLED = true in code
+ * 2. Setting LUMENFLOW_PHI_ENABLED=1 environment variable
+ * 3. Adding phi.enabled: true to .lumenflow.config.yaml
+ */
+export const PHI_CONFIG = {
+    /**
+     * Whether PHI scanning is enabled
+     * Default: false - projects must explicitly opt-in
+     */
+    ENABLED: process.env.LUMENFLOW_PHI_ENABLED === '1',
+    /**
+     * Whether to block on PHI detection (true) or just warn (false)
+     */
+    BLOCKING: process.env.LUMENFLOW_PHI_BLOCKING === '1',
+};
 /**
  * Readiness summary UI constants (WU-1620)
  *

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

@@ -1,14 +1,36 @@
 /**
- * WU Create Validators (WU-2107)
+ * WU Create Validators (WU-2107, WU-1062)
  *
- * Validation helpers for wu:create, including lane inference surfacing.
+ * 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.
  */
+/**
+ * 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.
  *
@@ -40,3 +62,36 @@ export declare function validateLaneWithInference(providedLane: any, codePaths:
     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 any spec_ref is an external path
+ */
+export declare function hasExternalSpecRefs(specRefs: string[]): 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[];