@lumenflow/core 2.2.1 → 2.3.1

package/dist/wu-constants.js

@@ -4,16 +4,15 @@
  * Centralized constants for wu- scripts to ensure consistency and DRY compliance.
  * Single source of truth for magic strings, section headings, and patterns.
  *
- * Part of WU-1214: Extract hardcoded strings to wu-constants.mjs
+ * Part of WU-1214: Extract hardcoded strings to wu-constants.ts
  * Part of WU-1240: Consolidated toKebab using change-case library
  *
- * @see {@link tools/wu-done.mjs} - Primary consumer
- * @see {@link tools/wu-claim.mjs} - Branch/worktree creation
- * @see {@link tools/lib/wu-schema.mjs} - PLACEHOLDER_SENTINEL (already centralized)
+ * @see {@link packages/@lumenflow/cli/src/wu-done.ts} - Primary consumer
+ * @see {@link packages/@lumenflow/cli/src/wu-claim.ts} - Branch/worktree creation
+ * @see {@link packages/@lumenflow/cli/src/lib/wu-schema.ts} - PLACEHOLDER_SENTINEL (already centralized)
  */
 import path from 'node:path';
-import { existsSync } from 'node:fs';
-import { createRequire } from 'node:module';
+import { tmpdir } from 'node:os';
 import { kebabCase } from 'change-case';
 /**
  * Git branch names
@@ -78,7 +77,7 @@ export const WU_STATUS = {
 /**
  * WU status groups for state management (WU-1742)
  *
- * Used by state-bootstrap.mjs to categorize YAML statuses.
+ * Used by state-bootstrap.ts to categorize YAML statuses.
  */
 export const WU_STATUS_GROUPS = {
     /** Statuses representing unclaimed work (not tracked in state store) */
@@ -118,7 +117,7 @@ export const INCIDENT_SEVERITY = {
     MINOR: 'minor',
     INFO: 'info',
 };
-// Note: PATHS object removed in WU-1240 - use WU_PATHS from wu-paths.mjs instead
+// Note: PATHS object removed in WU-1240 - use WU_PATHS from wu-paths.ts instead
 /**
  * Backlog section headings (with emojis)
  *
@@ -157,7 +156,7 @@ export const STATUS_SECTIONS = {
 /**
  * Regex patterns for WU operations
  *
- * Note: WU_ID pattern is also in wu-schema.mjs for Zod validation
+ * Note: WU_ID pattern is also in wu-schema.ts for Zod validation
  */
 export const PATTERNS = {
     /** WU identifier format: WU-123 */
@@ -269,7 +268,7 @@ export const LOG_PREFIX = {
     REPAIR: '[wu:repair]',
     CONSISTENCY: '[wu-consistency]',
     PREFLIGHT: '[wu-preflight]',
-    INIT_PLAN: '[init:plan]',
+    INITIATIVE_PLAN: '[initiative:plan]',
 };
 /**
  * Consistency check types (WU-1276)
@@ -481,7 +480,7 @@ export const YAML_OPTIONS = {
 /**
  * UI display constants
  *
- * WU-1281: Centralized from hardcoded values in wu-done.mjs
+ * WU-1281: Centralized from hardcoded values in wu-done.ts
  */
 export const UI = {
     /** Width for error/info boxes in console output */
@@ -527,6 +526,7 @@ export const CLEANUP_GUARD = {
         MISSING_STAMP: 'WU stamp is missing. Refusing to delete.',
         PR_NOT_MERGED: 'PR is not merged (or cannot be verified). Refusing to delete.',
     },
+    /* eslint-disable sonarjs/no-duplicate-string -- Intentional: cleanup instructions repeated for each error type for readability */
     NEXT_STEPS: {
         DEFAULT: [
             { text: '1. Resolve the issue above', appendId: false },
@@ -556,6 +556,7 @@ export const CLEANUP_GUARD = {
             { text: '2. Re-run: pnpm wu:cleanup --id', appendId: true },
         ],
     },
+    /* eslint-enable sonarjs/no-duplicate-string */
     PR_CHECK: {
         START: 'Verifying PR merge status...',
         RESULT: 'PR merge verification via',
@@ -586,14 +587,14 @@ export const GIT = {
  * P0 incident: 2025-12-10 server crash due to recursive fork bomb.
  *
  * @see tools/shims/git - The git shim that blocks destructive commands
- * @see tools/lib/wu-helpers.mjs - Uses REAL_GIT to avoid recursion
+ * @see tools/lib/wu-helpers.ts - Uses REAL_GIT to avoid recursion
  */
 export const REAL_GIT = '/usr/bin/git';
 /**
  * Git command flags
  *
  * Centralized git flag constants to eliminate hardcoded strings.
- * Used by git-adapter.mjs and other git operation utilities.
+ * Used by git-adapter.ts and other git operation utilities.
  */
 export const GIT_FLAGS = {
     /** Show abbreviated ref names (for branch name resolution) */
@@ -717,8 +718,8 @@ export const WU_TYPES = {
  * Defines how a WU exposes its functionality to users.
  * Used to ensure backend features have corresponding UI coverage.
  *
- * @see {@link tools/lib/wu-schema.mjs} - Schema validation
- * @see {@link packages/linters/wu-schema-linter.mjs} - Linter validation
+ * @see {@link packages/@lumenflow/cli/src/lib/wu-schema.ts} - Schema validation
+ * @see {@link packages/linters/wu-schema-linter.ts} - Linter validation
  */
 export const WU_EXPOSURE = {
     /** User-facing UI changes (pages, components, widgets) */
@@ -805,7 +806,7 @@ export const EMOJI = {
  * WU-1337: Centralized defaults for auto-repair in schema validation
  * DRY principle: Single source of truth for optional field defaults
  *
- * Used by wu-schema.mjs Zod transformations to provide sensible defaults
+ * Used by wu-schema.ts Zod transformations to provide sensible defaults
  * when agents omit optional fields, reducing validation errors.
  */
 export const WU_DEFAULTS = {
@@ -842,7 +843,7 @@ export const WU_DEFAULTS = {
  * 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
+ * @see {@link packages/@lumenflow/cli/src/lib/lane-validator.ts} - Validation logic
  */
 export const LANE_PATH_PATTERNS = {
     /**
@@ -865,7 +866,7 @@ export const LANE_PATH_PATTERNS = {
 /**
  * Process detection constants for background process warning (WU-1381)
  *
- * Used by process-detector.mjs to identify processes that may interfere
+ * Used by process-detector.ts to identify processes that may interfere
  * with wu:done gates execution.
  */
 export const PROCESS_DETECTION = {
@@ -962,7 +963,7 @@ export const SCRIPTS = {
 /**
  * Gate names for quality gates
  *
- * Centralized gate identifiers for gates.mjs and telemetry.
+ * Centralized gate identifiers for gates.ts and telemetry.
  */
 export const GATE_NAMES = {
     /** WU-2252: Invariants check (runs first, non-bypassable) */
@@ -982,11 +983,13 @@ export const GATE_NAMES = {
     INTEGRATION_TEST: 'integration-test',
     /** WU-2315: System map validation (warn-only until orphan docs are indexed) */
     SYSTEM_MAP_VALIDATE: 'system-map:validate',
+    /** WU-1191: Lane health check (overlap detection) */
+    LANE_HEALTH: 'lane-health',
 };
 /**
  * Gate command sentinels (special values for non-shell commands)
  *
- * These are not shell commands but trigger special handling in gates.mjs.
+ * These are not shell commands but trigger special handling in gates.ts.
  */
 export const GATE_COMMANDS = {
     /** WU-2252: Triggers invariants check */
@@ -1002,64 +1005,6 @@ export const GATE_COMMANDS = {
     /** WU-2062: Triggers tiered test execution based on risk */
     TIERED_TEST: 'tiered-test',
 };
-const require = createRequire(import.meta.url);
-const NOOP_NODE_COMMAND = 'node -e "process.exit(0)"';
-function resolveNodeModulePath(modulePath) {
-    try {
-        return require.resolve(modulePath);
-    }
-    catch {
-        return null;
-    }
-}
-function resolveRepoPath(relativePath, requireExists = false) {
-    const candidate = path.join(process.cwd(), relativePath);
-    if (requireExists && !existsSync(candidate)) {
-        return null;
-    }
-    return candidate;
-}
-function buildNodeCommand({ modulePath, repoPath, allowMissing = false, repoPathRequiresExistence = false, }) {
-    const resolved = modulePath ? resolveNodeModulePath(modulePath) : null;
-    if (resolved) {
-        return `node ${resolved}`;
-    }
-    const fallback = repoPath ? resolveRepoPath(repoPath, repoPathRequiresExistence) : null;
-    if (fallback) {
-        return `node ${fallback}`;
-    }
-    if (allowMissing) {
-        return NOOP_NODE_COMMAND;
-    }
-    if (repoPath) {
-        return `node ${resolveRepoPath(repoPath)}`;
-    }
-    if (modulePath) {
-        return `node ${modulePath}`;
-    }
-    return NOOP_NODE_COMMAND;
-}
-/**
- * Tool paths for scripts
- *
- * Centralized paths to tool scripts.
- */
-export const TOOL_PATHS = {
-    VALIDATE_BACKLOG_SYNC: buildNodeCommand({
-        modulePath: '@lumenflow/cli/dist/validate-backlog-sync.js',
-        repoPath: 'packages/@lumenflow/cli/dist/validate-backlog-sync.js',
-    }),
-    SUPABASE_DOCS_LINTER: buildNodeCommand({
-        repoPath: 'packages/linters/supabase-docs-linter.js',
-        allowMissing: true,
-        repoPathRequiresExistence: true,
-    }),
-    /** WU-2315: System map validator script */
-    SYSTEM_MAP_VALIDATE: buildNodeCommand({
-        modulePath: '@lumenflow/core/dist/system-map-validator.js',
-        repoPath: 'packages/@lumenflow/core/dist/system-map-validator.js',
-    }),
-};
 /**
  * CLI mode flags
  *
@@ -1156,6 +1101,22 @@ export const EXIT_CODES = {
     /** Fatal or distinct failure exit code */
     FAILURE: 2,
 };
+/**
+ * Stream error codes
+ *
+ * WU-1233: Error codes for stream operations (stdout/stderr).
+ * Used by StreamErrorHandler for graceful pipe closure handling.
+ */
+export const STREAM_ERRORS = {
+    /**
+     * EPIPE error code
+     *
+     * Occurs when writing to a pipe whose read end has been closed.
+     * This is normal behavior when CLI output is piped through head/tail.
+     * Unix convention: exit with code 0 on EPIPE (consumer got what it needed).
+     */
+    EPIPE: 'EPIPE',
+};
 /**
  * ESLint command names
  *
@@ -1278,16 +1239,6 @@ export const AUDIT_ARGS = {
  * Centralized paths to validation scripts.
  */
 export const SCRIPT_PATHS = {
-    /** Gates runner */
-    GATES: buildNodeCommand({
-        modulePath: '@lumenflow/cli/dist/gates.js',
-        repoPath: 'packages/@lumenflow/cli/dist/gates.js',
-    }),
-    /** WU YAML validation */
-    VALIDATE: buildNodeCommand({
-        modulePath: '@lumenflow/cli/dist/validate.js',
-        repoPath: 'packages/@lumenflow/cli/dist/validate.js',
-    }),
     /** Prompt registry validation */
     VALIDATE_PROMPT_REGISTRY: 'tools/validate-prompt-registry.js',
 };
@@ -1315,6 +1266,13 @@ export const ERROR_CODES = {
     /** Timeout error code */
     ETIMEDOUT: 'ETIMEDOUT',
 };
+/**
+ * WU-1174: Lock directory name constant
+ *
+ * Defined separately so it can be used both in LUMENFLOW_PATHS.LOCK_DIR
+ * and for test isolation in cleanup-lock.ts/merge-lock.ts.
+ */
+export const LOCK_DIR_NAME = '.lumenflow-locks';
 /**
  * LumenFlow directory paths
  *
@@ -1356,10 +1314,23 @@ export const LUMENFLOW_PATHS = {
     SESSION_CURRENT: '.lumenflow/sessions/current.json',
     /** WU events log */
     WU_EVENTS: '.lumenflow/state/wu-events.jsonl',
-    /** Lock files directory */
+    /** Lock files directory (lane locks - persisted) */
     LOCKS_DIR: '.lumenflow/locks',
     /** Force bypass audit log */
     FORCE_BYPASSES: '.lumenflow/force-bypasses.log',
+    /**
+     * WU-1174: Runtime lock directory for merge/cleanup locks
+     *
+     * These locks are transient and should NOT be created in the main checkout
+     * because wu:done runs from main. Using os.tmpdir() ensures:
+     * 1. Locks don't pollute the git working tree
+     * 2. Locks work across processes on the same machine
+     * 3. No "Working tree is not clean" errors if process crashes
+     *
+     * Note: Lane locks still use LOCKS_DIR (.lumenflow/locks) because they need
+     * to persist across sessions and be visible to other agents.
+     */
+    LOCK_DIR: path.join(tmpdir(), LOCK_DIR_NAME),
 };
 /**
  * @deprecated Use LUMENFLOW_PATHS instead. Will be removed in v2.0.
@@ -1421,6 +1392,7 @@ export const PATH_LITERALS = {
     /** Plan file suffix for WU plans */
     PLAN_FILE_SUFFIX: '-plan.md',
     /** Trailing slash regex pattern */
+    // eslint-disable-next-line sonarjs/slow-regex -- False positive: simple end-anchor regex, no catastrophic backtracking possible
     TRAILING_SLASH_REGEX: /\/+$/,
 };
 /**
@@ -1484,7 +1456,7 @@ export function getLaneBranch(lane, id) {
     return `lane/${laneKebab}/${idLower}`;
 }
 // Note: getWuYamlPath and getStampPath removed in WU-1240
-// Use WU_PATHS.WU(id) and WU_PATHS.STAMP(id) from wu-paths.mjs instead
+// Use WU_PATHS.WU(id) and WU_PATHS.STAMP(id) from wu-paths.ts instead
 /**
  * File tool constants (WU-1403)
  *
@@ -1557,8 +1529,8 @@ export const PHI_CONFIG = {
  * Constants for the readiness summary box displayed after wu:create and wu:edit.
  * Provides visual feedback on whether WU is ready for wu:claim.
  *
- * @see tools/wu-create.mjs - displayReadinessSummary()
- * @see tools/wu-edit.mjs - displayReadinessSummary()
+ * @see tools/wu-create.ts - displayReadinessSummary()
+ * @see tools/wu-edit.ts - displayReadinessSummary()
  */
 export const READINESS_UI = {
     /** Box width (inner content area) */
@@ -1800,6 +1772,7 @@ export const CONTEXT_VALIDATION = {
     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',

package/dist/wu-done-branch-only.d.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /**
  * Branch-Only mode completion workflow for wu:done
- * Extracted from wu-done.mjs (WU-1215 refactoring)
+ * Extracted from wu-done.ts (WU-1215 refactoring)
  *
  * Flow:
  * 1. Switch to main branch

package/dist/wu-done-branch-only.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /**
  * Branch-Only mode completion workflow for wu:done
- * Extracted from wu-done.mjs (WU-1215 refactoring)
+ * Extracted from wu-done.ts (WU-1215 refactoring)
  *
  * Flow:
  * 1. Switch to main branch

package/dist/wu-done-docs-generate.d.ts

@@ -11,7 +11,7 @@
  * Pathspecs for files that affect generated documentation.
  * When any of these files change, docs:generate should be run.
  *
- * Based on .husky/hooks/docs-sync.mjs patterns, expanded to match
+ * Based on .husky/hooks/docs-sync.ts patterns, expanded to match
  * all files that can affect CLI/config documentation.
  */
 export declare const DOC_SOURCE_PATHSPECS: readonly ["tools/generate-cli-docs.ts", "packages/@lumenflow/core/src/arg-parser.ts", "packages/@lumenflow/core/src/lumenflow-config-schema.ts", "packages/@lumenflow/core/src/index.ts", "packages/@lumenflow/cli/package.json", "packages/@lumenflow/cli/src/"];

package/dist/wu-done-docs-generate.js

@@ -14,7 +14,7 @@ import { STDIO, PKG_MANAGER, SCRIPTS, PRETTIER_FLAGS } from './wu-constants.js';
  * Pathspecs for files that affect generated documentation.
  * When any of these files change, docs:generate should be run.
  *
- * Based on .husky/hooks/docs-sync.mjs patterns, expanded to match
+ * Based on .husky/hooks/docs-sync.ts patterns, expanded to match
  * all files that can affect CLI/config documentation.
  */
 export const DOC_SOURCE_PATHSPECS = [

package/dist/wu-done-messages.d.ts

@@ -1,8 +1,8 @@
 /**
- * @file wu-done-messages.mjs
+ * @file wu-done-messages.ts
  * @description Constants and message templates for wu-done operations
  * WU-1159: Eliminate string literals (DRY/SOLID compliance)
- * WU-1281: Use centralized LOG_PREFIX and EMOJI from wu-constants.mjs
+ * WU-1281: Use centralized LOG_PREFIX and EMOJI from wu-constants.ts
  *
  * All log messages, error messages, and text templates extracted to constants.
  * Prevents duplication and makes text maintainable.

package/dist/wu-done-messages.js

@@ -1,8 +1,8 @@
 /**
- * @file wu-done-messages.mjs
+ * @file wu-done-messages.ts
  * @description Constants and message templates for wu-done operations
  * WU-1159: Eliminate string literals (DRY/SOLID compliance)
- * WU-1281: Use centralized LOG_PREFIX and EMOJI from wu-constants.mjs
+ * WU-1281: Use centralized LOG_PREFIX and EMOJI from wu-constants.ts
  *
  * All log messages, error messages, and text templates extracted to constants.
  * Prevents duplication and makes text maintainable.

package/dist/wu-done-metadata.d.ts

@@ -3,7 +3,7 @@
  */
 /**
  * Generate commit message for WU completion
- * Extracted from wu-done.mjs (WU-1215 Phase 2 Extraction #1 Helper)
+ * Extracted from wu-done.ts (WU-1215 Phase 2 Extraction #1 Helper)
  * @param {string} id - WU ID (e.g., "WU-1215")
  * @param {string} title - WU title
  * @param {number} maxLength - Maximum commit header length from commitlint config
@@ -26,7 +26,7 @@ export declare function validateMetadataFilesExist({ statusPath, backlogPath }:
 }): void;
 /**
  * Update all metadata files for WU completion
- * Extracted from wu-done.mjs (WU-1215 Phase 2 Extraction #1 Helper)
+ * Extracted from wu-done.ts (WU-1215 Phase 2 Extraction #1 Helper)
  * WU-1572: Made async for WUStateStore integration
  * @param {object} params - Parameters object
  * @param {string} params.id - WU ID
@@ -82,7 +82,7 @@ export declare function collectMetadataToTransaction({ id, title, doc, wuPath, s
 }): Promise<void>;
 /**
  * Stage and format metadata files
- * Extracted from wu-done.mjs (WU-1215 Phase 2 Extraction #1 Helper)
+ * Extracted from wu-done.ts (WU-1215 Phase 2 Extraction #1 Helper)
  * @param {object} params - Parameters object
  * @param {string} params.id - WU ID (for error reporting)
  * @param {string} params.wuPath - Path to WU YAML file

package/dist/wu-done-metadata.js

@@ -18,7 +18,7 @@ import { writeWU } from './wu-yaml.js';
 const execAsync = promisify(execCallback);
 /**
  * Generate commit message for WU completion
- * Extracted from wu-done.mjs (WU-1215 Phase 2 Extraction #1 Helper)
+ * Extracted from wu-done.ts (WU-1215 Phase 2 Extraction #1 Helper)
  * @param {string} id - WU ID (e.g., "WU-1215")
  * @param {string} title - WU title
  * @param {number} maxLength - Maximum commit header length from commitlint config
@@ -71,7 +71,7 @@ export function validateMetadataFilesExist({ statusPath, backlogPath }) {
 }
 /**
  * Update all metadata files for WU completion
- * Extracted from wu-done.mjs (WU-1215 Phase 2 Extraction #1 Helper)
+ * Extracted from wu-done.ts (WU-1215 Phase 2 Extraction #1 Helper)
  * WU-1572: Made async for WUStateStore integration
  * @param {object} params - Parameters object
  * @param {string} params.id - WU ID
@@ -156,7 +156,7 @@ export async function collectMetadataToTransaction({ id, title, doc, wuPath, sta
 }
 /**
  * Stage and format metadata files
- * Extracted from wu-done.mjs (WU-1215 Phase 2 Extraction #1 Helper)
+ * Extracted from wu-done.ts (WU-1215 Phase 2 Extraction #1 Helper)
  * @param {object} params - Parameters object
  * @param {string} params.id - WU ID (for error reporting)
  * @param {string} params.wuPath - Path to WU YAML file

package/dist/wu-done-pr.d.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /**
  * PR mode completion workflow for wu:done
- * Extracted from wu-done.mjs (WU-1215 refactoring)
+ * Extracted from wu-done.ts (WU-1215 refactoring)
  *
  * PR mode creates a GitHub PR instead of auto-merging to main.
  * Used for:

package/dist/wu-done-pr.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /**
  * PR mode completion workflow for wu:done
- * Extracted from wu-done.mjs (WU-1215 refactoring)
+ * Extracted from wu-done.ts (WU-1215 refactoring)
  *
  * PR mode creates a GitHub PR instead of auto-merging to main.
  * Used for:
@@ -13,6 +13,7 @@ import { execSync } from 'node:child_process';
 import { getGitForCwd } from './git-adapter.js';
 import { createError, ErrorCodes } from './error-handler.js';
 import { LOG_PREFIX, EMOJI, REMOTES, STDIO } from './wu-constants.js';
+import { createWuPaths } from './wu-paths.js';
 /**
  * @typedef {Object} PRContext
  * @property {string} branch - Lane branch name
@@ -105,7 +106,8 @@ export async function createPR(context) {
  * @returns {string} PR body markdown
  */
 export function buildPRBody(doc, id) {
-    const wuPath = `docs/04-operations/tasks/wu/${id}.yaml`;
+    const paths = createWuPaths();
+    const wuPath = paths.WU(id);
     const description = doc.description || doc.problem || '';
     const acceptance = doc.acceptance_criteria || doc.acceptance || {};
     let body = `## Summary\n\n${description}\n\n`;

package/dist/wu-done-preflight.d.ts

@@ -1,7 +1,6 @@
 /**
  * Preflight validation helpers for wu:done.
  */
-import { execSync as execSyncImport } from 'node:child_process';
 import { validatePreflight } from './wu-preflight-validators.js';
 /**
  * WU-1781: Build preflight error message with actionable guidance
@@ -20,6 +19,14 @@ export declare function executePreflightCodePathValidation(id: any, paths: any,
     missingCodePaths: any[];
     missingTestPaths: any[];
     abortedBeforeGates: boolean;
+    suggestedTestPaths?: undefined;
+} | {
+    valid: boolean;
+    errors: any[];
+    missingCodePaths: any[];
+    missingTestPaths: any[];
+    suggestedTestPaths: {};
+    abortedBeforeGates: boolean;
 }>;
 /**
  * WU-1805: Build preflight code_paths error message with actionable guidance
@@ -28,21 +35,24 @@ export declare function buildPreflightCodePathErrorMessage(id: any, result: any)
 /**
  * WU-1781: Run tasks:validate as preflight check before any git operations
  */
-export interface ExecSyncOverrideOptions {
-    /** Override execSync for testing (default: child_process.execSync) */
-    execSyncFn?: typeof execSyncImport;
-}
-export declare function runPreflightTasksValidation(id: any, options?: ExecSyncOverrideOptions): {
+export declare function runPreflightTasksValidation(id: any): {
     valid: boolean;
-    errors: any;
+    errors: string[];
     abortedBeforeMerge: boolean;
     localMainModified: boolean;
-    hasStampStatusError: any;
+    hasStampStatusError: boolean;
 };
 /**
  * WU-2308: Validate all pre-commit hooks with worktree context
  */
-export declare function validateAllPreCommitHooks(id: any, worktreePath?: any, options?: ExecSyncOverrideOptions): {
+export interface ValidateAllPreCommitHooksOptions {
+    runGates?: (options: {
+        cwd?: string;
+        docsOnly?: boolean;
+        wuId?: string;
+    }) => Promise<boolean>;
+}
+export declare function validateAllPreCommitHooks(id: any, worktreePath?: any, options?: ValidateAllPreCommitHooksOptions): Promise<{
     valid: boolean;
     errors: any[];
-};
+}>;