@lumenflow/core 3.1.3 → 3.2.1

package/dist/work-classifier.js.map

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

package/dist/worktree-ownership.d.ts

@@ -0,0 +1,51 @@
+/**
+ * WU-2278: Worktree Ownership Validation
+ *
+ * Validates that a WU can only clean up its own worktree.
+ * Prevents cross-agent worktree deletion during parallel execution.
+ *
+ * Note: No external library exists for LumenFlow-specific worktree ownership
+ * validation - this is internal workflow tooling.
+ *
+ * @module worktree-ownership
+ */
+/**
+ * Extract WU ID from worktree path
+ *
+ * Worktree paths follow pattern: worktrees/<lane>-wu-<id>
+ * Examples:
+ *   - worktrees/operations-wu-100 -> WU-100
+ *   - worktrees/operations-tooling-wu-2278 -> WU-2278
+ *   - worktrees/experience-chat-wu-500 -> WU-500
+ *
+ * @param {string} worktreePath - Path to worktree
+ * @returns {string|null} Extracted WU ID (uppercase) or null if not found
+ */
+export declare function extractWUFromWorktreePath(worktreePath: UnsafeAny): string | null;
+/**
+ * Validate that the WU can safely clean up the given worktree
+ *
+ * Blocks deletion when:
+ * - Worktree path contains a different WU ID
+ *
+ * Allows deletion when:
+ * - Worktree path is null/undefined (nothing to clean up)
+ * - Worktree path matches the WU ID
+ * - Worktree path doesn't follow WU naming convention (manual worktree)
+ *
+ * @param {Object} params - Validation parameters
+ * @param {string|null|undefined} params.worktreePath - Path to worktree
+ * @param {string} params.wuId - WU ID attempting cleanup (e.g., "WU-100")
+ * @returns {{ valid: boolean, error?: string }} Validation result
+ */
+export declare function validateWorktreeOwnership({ worktreePath, wuId, }: {
+    worktreePath: string | null | undefined;
+    wuId: string;
+}): {
+    valid: boolean;
+    error?: undefined;
+} | {
+    valid: boolean;
+    error: string;
+};
+//# sourceMappingURL=worktree-ownership.d.ts.map

package/dist/worktree-ownership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-ownership.d.ts","sourceRoot":"","sources":["../src/worktree-ownership.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,SAAS,iBAYhE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CAAC,EACxC,YAAY,EACZ,IAAI,GACL,EAAE;IACD,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC;CACd;;;;;;EA4BA"}

package/dist/worktree-ownership.js

@@ -0,0 +1,77 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * WU-2278: Worktree Ownership Validation
+ *
+ * Validates that a WU can only clean up its own worktree.
+ * Prevents cross-agent worktree deletion during parallel execution.
+ *
+ * Note: No external library exists for LumenFlow-specific worktree ownership
+ * validation - this is internal workflow tooling.
+ *
+ * @module worktree-ownership
+ */
+/**
+ * Extract WU ID from worktree path
+ *
+ * Worktree paths follow pattern: worktrees/<lane>-wu-<id>
+ * Examples:
+ *   - worktrees/operations-wu-100 -> WU-100
+ *   - worktrees/operations-tooling-wu-2278 -> WU-2278
+ *   - worktrees/experience-chat-wu-500 -> WU-500
+ *
+ * @param {string} worktreePath - Path to worktree
+ * @returns {string|null} Extracted WU ID (uppercase) or null if not found
+ */
+export function extractWUFromWorktreePath(worktreePath) {
+    if (!worktreePath || typeof worktreePath !== 'string') {
+        return null;
+    }
+    // Match wu-<id> pattern at end of path (case insensitive)
+    const match = worktreePath.match(/wu-(\d+)(?:\/)?$/i);
+    if (!match) {
+        return null;
+    }
+    return `WU-${match[1]}`;
+}
+/**
+ * Validate that the WU can safely clean up the given worktree
+ *
+ * Blocks deletion when:
+ * - Worktree path contains a different WU ID
+ *
+ * Allows deletion when:
+ * - Worktree path is null/undefined (nothing to clean up)
+ * - Worktree path matches the WU ID
+ * - Worktree path doesn't follow WU naming convention (manual worktree)
+ *
+ * @param {Object} params - Validation parameters
+ * @param {string|null|undefined} params.worktreePath - Path to worktree
+ * @param {string} params.wuId - WU ID attempting cleanup (e.g., "WU-100")
+ * @returns {{ valid: boolean, error?: string }} Validation result
+ */
+export function validateWorktreeOwnership({ worktreePath, wuId, }) {
+    // No worktree path = nothing to validate
+    if (!worktreePath) {
+        return { valid: true };
+    }
+    const worktreeWuId = extractWUFromWorktreePath(worktreePath);
+    // If worktree doesn't follow WU naming, allow cleanup (manual worktree)
+    if (!worktreeWuId) {
+        return {
+            valid: false,
+            error: `Worktree ownership mismatch: cannot determine owner of ${worktreePath}`,
+        };
+    }
+    // Normalize WU IDs for comparison (case insensitive)
+    const normalizedWorktreeId = worktreeWuId.toUpperCase();
+    const normalizedWuId = wuId.toUpperCase();
+    if (normalizedWorktreeId !== normalizedWuId) {
+        return {
+            valid: false,
+            error: `Worktree ownership mismatch: worktree belongs to ${normalizedWorktreeId}, but ${normalizedWuId} attempted cleanup. This could delete another agent's work.`,
+        };
+    }
+    return { valid: true };
+}
+//# sourceMappingURL=worktree-ownership.js.map

package/dist/worktree-ownership.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-ownership.js","sourceRoot":"","sources":["../src/worktree-ownership.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,yBAAyB,CAAC,YAAuB;IAC/D,IAAI,CAAC,YAAY,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0DAA0D;IAC1D,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACtD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,MAAM,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,yBAAyB,CAAC,EACxC,YAAY,EACZ,IAAI,GAIL;IACC,yCAAyC;IACzC,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,MAAM,YAAY,GAAG,yBAAyB,CAAC,YAAY,CAAC,CAAC;IAE7D,wEAAwE;IACxE,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,0DAA0D,YAAY,EAAE;SAChF,CAAC;IACJ,CAAC;IAED,qDAAqD;IACrD,MAAM,oBAAoB,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;IACxD,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAE1C,IAAI,oBAAoB,KAAK,cAAc,EAAE,CAAC;QAC5C,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,oDAAoD,oBAAoB,SAAS,cAAc,6DAA6D;SACpK,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC"}

package/dist/worktree-scanner.d.ts

@@ -0,0 +1,118 @@
+/**
+ * @typedef {object} WorktreeInfo
+ * @property {string} path - Absolute path to worktree
+ * @property {string} sha - Current commit SHA
+ * @property {string} branch - Branch name or "(detached HEAD)"
+ * @property {boolean} isMain - Whether this is the main worktree
+ * @property {string} [wuId] - WU ID if this is a lane worktree
+ */
+/**
+ * @typedef {object} WorktreeStatus
+ * @property {boolean} hasUncommittedChanges - Whether there are uncommitted changes
+ * @property {number} uncommittedFileCount - Number of uncommitted files
+ * @property {string[]} uncommittedFiles - List of uncommitted file paths
+ * @property {string} lastActivityTimestamp - ISO timestamp of last git activity
+ * @property {string} [error] - Error message if git commands failed
+ */
+/**
+ * @typedef {object} WorktreeScanResult
+ * @property {(WorktreeInfo & WorktreeStatus)[]} worktrees - All WU worktrees with status
+ * @property {(WorktreeInfo & WorktreeStatus)[]} worktreesWithUncommittedWork - Worktrees with uncommitted changes
+ * @property {object} summary - Summary statistics
+ * @property {number} summary.totalWorktrees - Total number of WU worktrees
+ * @property {number} summary.withUncommittedChanges - Number with uncommitted changes
+ * @property {number} summary.totalUncommittedFiles - Total uncommitted files across all worktrees
+ */
+/**
+ * Parses git worktree list output into structured data.
+ *
+ * @param {string} output - Raw output from `git worktree list`
+ * @returns {WorktreeInfo[]} Parsed worktree information
+ *
+ * @example
+ * const info = parseWorktreeList('/workspace/user/project abc1234 [main]');
+ * // Returns: [{ path: '/workspace/user/project', sha: 'abc1234', branch: 'main', isMain: true }]
+ */
+export declare function parseWorktreeList(output: UnsafeAny): {
+    path: string;
+    sha: string;
+    branch: string;
+    isMain: boolean;
+    wuId?: string;
+}[];
+/**
+ * Gets the status of a single worktree including uncommitted changes.
+ *
+ * @param {string} worktreePath - Path to the worktree
+ * @param {object} [options] - Options
+ * @param {WorktreeScannerOptions} [options] - Options
+ * @returns {Promise<WorktreeStatus>} Worktree status
+ *
+ * @example
+ * const status = await getWorktreeStatus('/path/to/worktree');
+ * if (status.hasUncommittedChanges) {
+ *   console.log(`Found ${status.uncommittedFileCount} uncommitted files`);
+ * }
+ */
+interface WorktreeScannerOptions {
+    /** Custom exec function for testing */
+    execAsync?: (cmd: string) => Promise<{
+        stdout: string;
+        stderr: string;
+    }>;
+}
+export declare function getWorktreeStatus(worktreePath: UnsafeAny, options?: WorktreeScannerOptions): Promise<{
+    hasUncommittedChanges: boolean;
+    uncommittedFileCount: number;
+    uncommittedFiles: string[];
+    lastActivityTimestamp: string;
+    error?: string;
+}>;
+/**
+ * Scans all worktrees and returns their status.
+ *
+ * Excludes the main worktree and focuses on WU worktrees (lane branches).
+ *
+ * @param {string} basePath - Path to main repository
+ * @param {WorktreeScannerOptions} [options] - Options
+ * @returns {Promise<WorktreeScanResult>} Scan results with all worktrees and summary
+ *
+ * @example
+ * const result = await scanWorktrees('/path/to/repo');
+ * for (const wt of result.worktreesWithUncommittedWork) {
+ *   console.log(`${wt.wuId}: ${wt.uncommittedFileCount} uncommitted files`);
+ * }
+ */
+export declare function scanWorktrees(basePath: UnsafeAny, options?: WorktreeScannerOptions): Promise<{
+    worktrees: {
+        hasUncommittedChanges: boolean;
+        uncommittedFileCount: number;
+        uncommittedFiles: string[];
+        lastActivityTimestamp: string;
+        error?: string;
+        path: string;
+        sha: string;
+        branch: string;
+        isMain: boolean;
+        wuId?: string;
+    }[];
+    worktreesWithUncommittedWork: {
+        hasUncommittedChanges: boolean;
+        uncommittedFileCount: number;
+        uncommittedFiles: string[];
+        lastActivityTimestamp: string;
+        error?: string;
+        path: string;
+        sha: string;
+        branch: string;
+        isMain: boolean;
+        wuId?: string;
+    }[];
+    summary: {
+        totalWorktrees: number;
+        withUncommittedChanges: number;
+        totalUncommittedFiles: number;
+    };
+}>;
+export {};
+//# sourceMappingURL=worktree-scanner.d.ts.map

package/dist/worktree-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-scanner.d.ts","sourceRoot":"","sources":["../src/worktree-scanner.ts"],"names":[],"mappings":"AAmCA;;;;;;;GAOG;AAEH;;;;;;;GAOG;AAEH;;;;;;;;GAQG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS;UAoB3B,MAAM;SAAO,MAAM;YAAU,MAAM;YAAU,OAAO;WAAS,MAAM;IAiB1F;AAED;;;;;;;;;;;;;GAaG;AACH,UAAU,sBAAsB;IAC9B,uCAAuC;IACvC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1E;AAED,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,SAAS,EACvB,OAAO,GAAE,sBAA2B;2BAMX,OAAO;0BACR,MAAM;sBACV,MAAM,EAAE;2BACH,MAAM;YACrB,MAAM;GAmCjB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,GAAE,sBAA2B;;+BAxDlE,OAAO;8BACR,MAAM;0BACV,MAAM,EAAE;+BACH,MAAM;gBACrB,MAAM;cAlDM,MAAM;aAAO,MAAM;gBAAU,MAAM;gBAAU,OAAO;eAAS,MAAM;;;+BA8ChE,OAAO;8BACR,MAAM;0BACV,MAAM,EAAE;+BACH,MAAM;gBACrB,MAAM;cAlDM,MAAM;aAAO,MAAM;gBAAU,MAAM;gBAAU,OAAO;eAAS,MAAM;;;;;;;GA0I1F"}

package/dist/worktree-scanner.js

@@ -0,0 +1,171 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Worktree Scanner (WU-1748)
+ *
+ * Scans existing git worktrees to detect uncommitted changes.
+ * Provides cross-agent visibility for abandoned WU work.
+ *
+ * Features:
+ * - Parses git worktree list output
+ * - Detects uncommitted changes per worktree
+ * - Reports last activity timestamp
+ * - Identifies potentially abandoned WUs
+ *
+ * @see {@link packages/@lumenflow/cli/src/lib/__tests__/worktree-scanner.test.ts} - Tests
+ */
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+const execAsync = promisify(exec);
+/**
+ * Regex pattern to extract WU ID from lane branch name
+ * Matches patterns like: lane/operations/wu-1234, lane/operations-tooling/wu-1234
+ */
+const WU_ID_PATTERN = /wu-(\d+)$/i;
+/**
+ * Regex pattern to parse git worktree list output line
+ * Format: /path/to/worktree  SHA1 [branch] or (detached HEAD)
+ */
+const WORKTREE_LINE_PATTERN = /^(\S+)\s+(\S+)\s+(?:\[([^\]]+)\]|\(([^)]+)\))$/;
+/**
+ * @typedef {object} WorktreeInfo
+ * @property {string} path - Absolute path to worktree
+ * @property {string} sha - Current commit SHA
+ * @property {string} branch - Branch name or "(detached HEAD)"
+ * @property {boolean} isMain - Whether this is the main worktree
+ * @property {string} [wuId] - WU ID if this is a lane worktree
+ */
+/**
+ * @typedef {object} WorktreeStatus
+ * @property {boolean} hasUncommittedChanges - Whether there are uncommitted changes
+ * @property {number} uncommittedFileCount - Number of uncommitted files
+ * @property {string[]} uncommittedFiles - List of uncommitted file paths
+ * @property {string} lastActivityTimestamp - ISO timestamp of last git activity
+ * @property {string} [error] - Error message if git commands failed
+ */
+/**
+ * @typedef {object} WorktreeScanResult
+ * @property {(WorktreeInfo & WorktreeStatus)[]} worktrees - All WU worktrees with status
+ * @property {(WorktreeInfo & WorktreeStatus)[]} worktreesWithUncommittedWork - Worktrees with uncommitted changes
+ * @property {object} summary - Summary statistics
+ * @property {number} summary.totalWorktrees - Total number of WU worktrees
+ * @property {number} summary.withUncommittedChanges - Number with uncommitted changes
+ * @property {number} summary.totalUncommittedFiles - Total uncommitted files across all worktrees
+ */
+/**
+ * Parses git worktree list output into structured data.
+ *
+ * @param {string} output - Raw output from `git worktree list`
+ * @returns {WorktreeInfo[]} Parsed worktree information
+ *
+ * @example
+ * const info = parseWorktreeList('/workspace/user/project abc1234 [main]');
+ * // Returns: [{ path: '/workspace/user/project', sha: 'abc1234', branch: 'main', isMain: true }]
+ */
+export function parseWorktreeList(output) {
+    if (!output || !output.trim()) {
+        return [];
+    }
+    const lines = output.trim().split('\n');
+    const worktrees = [];
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        const match = trimmed.match(WORKTREE_LINE_PATTERN);
+        if (!match)
+            continue;
+        const [, path, sha, bracketBranch, parenBranch] = match;
+        const branch = bracketBranch || parenBranch;
+        const isMain = branch === 'main' || branch === 'master';
+        /** @type {WorktreeInfo} */
+        const info = {
+            path,
+            sha,
+            branch,
+            isMain,
+        };
+        // Extract WU ID from lane branch name
+        const wuMatch = branch.match(WU_ID_PATTERN);
+        if (wuMatch) {
+            info.wuId = `WU-${wuMatch[1]}`;
+        }
+        worktrees.push(info);
+    }
+    return worktrees;
+}
+export async function getWorktreeStatus(worktreePath, options = {}) {
+    const runCmd = options.execAsync || execAsync;
+    /** @type {WorktreeStatus} */
+    const status = {
+        hasUncommittedChanges: false,
+        uncommittedFileCount: 0,
+        uncommittedFiles: [],
+        lastActivityTimestamp: '',
+    };
+    try {
+        // Get uncommitted changes via git status --porcelain
+        const statusResult = await runCmd(`git -C "${worktreePath}" status --porcelain`);
+        // Note: Don't trim() the whole output as it would remove leading space from first line
+        // Git status --porcelain format: XY filename (2 chars + space + path)
+        const statusOutput = statusResult.stdout;
+        if (statusOutput && statusOutput.trim()) {
+            const files = statusOutput
+                .split('\n')
+                .filter((line) => line.length > 3) // Filter empty lines
+                .map((line) => line.slice(3).trim()); // Remove XY prefix and trim path
+            status.uncommittedFiles = files;
+            status.uncommittedFileCount = files.length;
+            status.hasUncommittedChanges = files.length > 0;
+        }
+        // Get last activity timestamp from git log
+        const logResult = await runCmd(`git -C "${worktreePath}" log -1 --format=%aI 2>/dev/null || echo ""`);
+        status.lastActivityTimestamp = logResult.stdout.trim();
+    }
+    catch (error) {
+        status.error = error instanceof Error ? error.message : String(error);
+    }
+    return status;
+}
+/**
+ * Scans all worktrees and returns their status.
+ *
+ * Excludes the main worktree and focuses on WU worktrees (lane branches).
+ *
+ * @param {string} basePath - Path to main repository
+ * @param {WorktreeScannerOptions} [options] - Options
+ * @returns {Promise<WorktreeScanResult>} Scan results with all worktrees and summary
+ *
+ * @example
+ * const result = await scanWorktrees('/path/to/repo');
+ * for (const wt of result.worktreesWithUncommittedWork) {
+ *   console.log(`${wt.wuId}: ${wt.uncommittedFileCount} uncommitted files`);
+ * }
+ */
+export async function scanWorktrees(basePath, options = {}) {
+    const runCmd = options.execAsync || execAsync;
+    // Get worktree list
+    const listResult = await runCmd(`git -C "${basePath}" worktree list`);
+    const allWorktrees = parseWorktreeList(listResult.stdout);
+    // Filter to WU worktrees only (exclude main)
+    const wuWorktrees = allWorktrees.filter((wt) => !wt.isMain && wt.wuId);
+    // Get status for each WU worktree
+    const worktreesWithStatus = await Promise.all(wuWorktrees.map(async (wt) => {
+        const status = await getWorktreeStatus(wt.path, { execAsync: runCmd });
+        return { ...wt, ...status };
+    }));
+    // Filter to those with uncommitted changes
+    const worktreesWithUncommittedWork = worktreesWithStatus.filter((wt) => wt.hasUncommittedChanges);
+    // Calculate summary
+    const summary = {
+        totalWorktrees: worktreesWithStatus.length,
+        withUncommittedChanges: worktreesWithUncommittedWork.length,
+        totalUncommittedFiles: worktreesWithStatus.reduce((sum, wt) => sum + wt.uncommittedFileCount, 0),
+    };
+    return {
+        worktrees: worktreesWithStatus,
+        worktreesWithUncommittedWork,
+        summary,
+    };
+}
+//# sourceMappingURL=worktree-scanner.js.map

package/dist/worktree-scanner.js.map

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

package/dist/worktree-symlink.d.ts

@@ -0,0 +1,98 @@
+/**
+ * List of nested package/app paths that have their own node_modules
+ *
+ * pnpm monorepos create node_modules in each package with symlinks
+ * to the .pnpm store. turbo typecheck and tests need these to resolve imports.
+ *
+ * WU-1068: Removed @exampleapp references. Only @lumenflow packages are
+ * relevant to the LumenFlow framework. Project-specific paths should be
+ * configured in workspace.yaml.
+ *
+ * @type {string[]}
+ */
+export declare const NESTED_PACKAGE_PATHS: string[];
+interface WorktreePathSymlinkResult {
+    hasWorktreeSymlinks: boolean;
+    brokenSymlinks: string[];
+}
+interface LoggerLike {
+    info?: (message: string) => void;
+    warn?: (message: string) => void;
+}
+interface SymlinkResult {
+    created: boolean;
+    skipped: boolean;
+    refused?: boolean;
+    reason?: string;
+    error?: Error;
+}
+interface NestedSymlinkResult {
+    created: number;
+    skipped: number;
+    errors: Error[];
+}
+interface WorkspaceBinArtifactSeedResult {
+    created: number;
+    skipped: number;
+    errors: Error[];
+}
+/**
+ * Check if a node_modules directory contains symlinks pointing into worktrees
+ *
+ * WU-2238: When pnpm install runs inside a worktree, it can create symlinks
+ * that point to the worktree's .pnpm store. When that worktree is removed,
+ * these symlinks become broken and cause ERR_MODULE_NOT_FOUND.
+ *
+ * @param {string} nodeModulesPath - Absolute path to node_modules directory
+ * @returns {{hasWorktreeSymlinks: boolean, brokenSymlinks: string[]}}
+ */
+export declare function hasWorktreePathSymlinks(nodeModulesPath: string): WorktreePathSymlinkResult;
+/**
+ * Pre-seed bin artifact roots (for example dist/) in a fresh worktree from main checkout.
+ *
+ * This prevents pnpm install from emitting noisy ENOENT bin-link warnings for workspace packages
+ * whose bin entries point at build artifacts that are not tracked in git.
+ */
+export declare function symlinkWorkspaceBinArtifactRoots(worktreePath: string, mainRepoPath: string, logger?: LoggerLike | null): WorkspaceBinArtifactSeedResult;
+/**
+ * Create symlink to node_modules in a newly created worktree
+ *
+ * This enables immediate pnpm command execution without manual symlink creation.
+ * The symlink is relative for portability across different project locations.
+ *
+ * WU-2238: When mainRepoPath is provided, checks if the target node_modules
+ * contains symlinks pointing into worktrees. If so, refuses to create the
+ * symlink to prevent inheriting broken module resolution.
+ *
+ * @param {string} worktreePath - Absolute path to the worktree directory
+ * @param {object} [logger] - Logger object with info/warn methods (defaults to console)
+ * @param {string} [mainRepoPath] - Optional: Absolute path to main repo for worktree-path check
+ * @returns {{created: boolean, skipped: boolean, refused?: boolean, reason?: string, error?: Error}}
+ *
+ * @example
+ * // In wu-claim.ts after worktree creation:
+ * symlinkNodeModules('/path/to/worktrees/operations-tooling-wu-1443');
+ */
+export declare function symlinkNodeModules(worktreePath: string, logger?: LoggerLike, mainRepoPath?: string | null): SymlinkResult;
+/**
+ * Create symlinks for nested package node_modules in a worktree
+ *
+ * WU-1579: pnpm monorepos have node_modules in each package containing
+ * symlinks to the .pnpm store. turbo typecheck needs these to resolve
+ * package imports correctly.
+ *
+ * @param {string} worktreePath - Absolute path to the worktree directory
+ * @param {string} mainRepoPath - Absolute path to the main repository root
+ * @param {object} [logger] - Logger object with info/warn methods (defaults to silent)
+ * @returns {{created: number, skipped: number, errors: Error[]}}
+ *
+ * @example
+ * // In wu-claim.ts after worktree creation:
+ * symlinkNestedNodeModules(
+ *   '/path/to/worktrees/operations-tooling-wu-1579',
+ *   '/path/to/main-repo'
+ * );
+ */
+export declare function symlinkNestedNodeModules(worktreePath: string, mainRepoPath: string, logger?: LoggerLike | null): NestedSymlinkResult;
+export {};
+//# sourceMappingURL=worktree-symlink.d.ts.map

package/dist/worktree-symlink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-symlink.d.ts","sourceRoot":"","sources":["../src/worktree-symlink.ts"],"names":[],"mappings":"AAqFA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,UAahC,CAAC;AAQF,UAAU,yBAAyB;IACjC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,UAAU,UAAU;IAClB,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED,UAAU,aAAa;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,UAAU,mBAAmB;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB;AAED,UAAU,8BAA8B;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB;AAuED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,eAAe,EAAE,MAAM,GAAG,yBAAyB,CAwB1F;AA+ID;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,MAAM,GAAE,UAAU,GAAG,IAAW,GAC/B,8BAA8B,CAwDhC;AAmCD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,MAAM,GAAE,UAAoB,EAC5B,YAAY,GAAE,MAAM,GAAG,IAAW,GACjC,aAAa,CAmCf;AA+ED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,MAAM,GAAE,UAAU,GAAG,IAAW,GAC/B,mBAAmB,CA0CrB"}