@lumenflow/cli 5.4.0 → 5.7.12

package/packs/software-delivery/src/constants/wu-id-format.ts

@@ -1,327 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: LicenseRef-LumenFlow-Proprietary
-
-/**
- * WU ID Format Primitives (WU-2552)
- *
- * Canonical zero-padded WU ID primitives. All ID formatting, parsing,
- * and regex construction flows through this module so that width, strict
- * mode, and prefix can be centrally configured via workspace.yaml
- * `software_delivery.wu_id.{width,strict,prefix}`.
- *
- * Design principles:
- * - Pure functions, no I/O, no config reads (caller supplies config).
- * - Hardcoded choices: separator '-', lowercase digits, padding char '0',
- *   starting number 1, gap-fill policy 'never reuse'.
- * - `wuIdRegex` is intentionally permissive (matches both padded and unpadded
- *   digit counts) so that consumers scanning files for legacy + canonical
- *   IDs stay backward compatible during the transition. Strict canonical
- *   form is enforced separately via `isCanonicalWuId`.
- *
- * @module wu-id-format
- */
-
-import { existsSync, readdirSync, readFileSync } from 'node:fs';
-import { createError, ErrorCodes } from '@lumenflow/kernel/primitives/error-handler';
-import { readSoftwareDeliveryConfig } from '../config/workspace-reader.js';
-
-/** Minimum allowed zero-padding width. */
-export const WU_ID_WIDTH_MIN = 1;
-
-/** Maximum allowed zero-padding width. */
-export const WU_ID_WIDTH_MAX = 6;
-
-/**
- * Prefix validation pattern: uppercase letter start, followed by 1-9 more
- * uppercase-alphanumeric characters, terminated by a dash. Matches 'WU-',
- * 'TASK-', 'STORY-', 'TICKET-', 'JIRA123-'. Rejects lowercase, missing dash,
- * single-char prefixes, and over-long prefixes.
- */
-export const WU_ID_PREFIX_PATTERN = /^[A-Z][A-Z0-9]{1,9}-$/;
-
-/** Canonical WU ID configuration. */
-export interface WuIdConfig {
-  /** Zero-padding width. Default 4 (WU-0001). */
-  width: number;
-  /**
-   * Strict mode. When true, non-canonical legacy IDs are flagged as errors
-   * by wu:doctor and wu:create canonicalizes --id input. When false, legacy
-   * IDs are tolerated as warnings for incremental migration.
-   */
-  strict: boolean;
-  /** Canonical prefix including trailing dash. Default 'WU-'. */
-  prefix: string;
-}
-
-/** Default WU ID configuration. */
-export const WU_ID_DEFAULTS: WuIdConfig = Object.freeze({
-  width: 4,
-  strict: true,
-  prefix: 'WU-',
-});
-
-/**
- * Validate and resolve a partial WU ID config against the defaults.
- *
- * @throws {Error} If width is not an integer in [1, 6] or prefix does not
- *   match {@link WU_ID_PREFIX_PATTERN}.
- */
-export function validateWuIdConfig(partial: Partial<WuIdConfig> = {}): WuIdConfig {
-  const width = partial.width ?? WU_ID_DEFAULTS.width;
-  const strict = partial.strict ?? WU_ID_DEFAULTS.strict;
-  const prefix = partial.prefix ?? WU_ID_DEFAULTS.prefix;
-
-  if (!Number.isInteger(width) || width < WU_ID_WIDTH_MIN || width > WU_ID_WIDTH_MAX) {
-    throw createError(
-      ErrorCodes.VALIDATION_ERROR,
-      `Invalid wu_id.width: ${String(width)}. Must be an integer between ${WU_ID_WIDTH_MIN} and ${WU_ID_WIDTH_MAX}.`,
-    );
-  }
-
-  if (typeof prefix !== 'string' || !WU_ID_PREFIX_PATTERN.test(prefix)) {
-    throw createError(
-      ErrorCodes.VALIDATION_ERROR,
-      `Invalid wu_id.prefix: "${String(prefix)}". Must match ${WU_ID_PREFIX_PATTERN} (e.g., 'WU-', 'TASK-', 'STORY-').`,
-    );
-  }
-
-  return { width, strict, prefix };
-}
-
-/**
- * Format an integer as a canonical WU ID.
- *
- * Zero-pads to the configured width. If the integer exceeds 10^width, the
- * result is wider than width (overflow is preserved, never truncated).
- *
- * @throws {Error} If n is not a positive integer.
- */
-export function formatWuId(n: number, config: Partial<WuIdConfig> = {}): string {
-  if (!Number.isInteger(n) || n < 1) {
-    throw createError(
-      ErrorCodes.VALIDATION_ERROR,
-      `Invalid WU number: ${String(n)}. Must be a positive integer.`,
-    );
-  }
-  const { width, prefix } = validateWuIdConfig(config);
-  return `${prefix}${String(n).padStart(width, '0')}`;
-}
-
-/**
- * Parse a WU ID (or YAML/stamp filename) into its prefix and numeric parts.
- *
- * Returns null for any input that does not match the configured prefix or
- * does not carry a positive integer body. Accepts both canonical padded and
- * legacy unpadded forms.
- *
- * Strips `.yaml` and `.done` extensions before parsing.
- */
-export function parseWuId(
-  id: string,
-  config: Partial<WuIdConfig> = {},
-): { prefix: string; num: number } | null {
-  if (typeof id !== 'string' || id.length === 0) {
-    return null;
-  }
-  const { prefix } = validateWuIdConfig(config);
-  const stripped = id.replace(/\.(yaml|done)$/, '');
-  if (!stripped.startsWith(prefix)) {
-    return null;
-  }
-  const body = stripped.slice(prefix.length);
-  if (!/^\d+$/.test(body)) {
-    return null;
-  }
-  const num = parseInt(body, 10);
-  if (!Number.isFinite(num) || num < 1) {
-    return null;
-  }
-  return { prefix, num };
-}
-
-/**
- * Build an anchored regex that matches WU IDs (both padded and unpadded
- * digit counts) for the configured prefix. Intended for file scans and
- * consumers that previously hardcoded `/^WU-\d+$/`.
- *
- * Strict canonical-form enforcement lives in {@link isCanonicalWuId}, not here.
- */
-export function wuIdRegex(config: Partial<WuIdConfig> = {}): RegExp {
-  // eslint-disable-next-line security/detect-non-literal-regexp -- prefix escaped
-  return new RegExp(`^${wuIdBodyPattern(config)}$`);
-}
-
-/**
- * Return an unanchored pattern string (for embedding in longer regexes)
- * that matches the WU id body — the configured prefix followed by one
- * or more digits. Consumers that previously hardcoded `WU-\\d+` inside
- * a larger regex should use this helper so prefix configuration
- * (`software_delivery.wu_id.prefix`) is honored.
- *
- * The pattern does NOT include anchors; callers decide whether to
- * anchor with `^`/`$` or embed in a path/substring match.
- */
-export function wuIdBodyPattern(config: Partial<WuIdConfig> = {}): string {
-  const { prefix } = validateWuIdConfig(config);
-  const escaped = prefix.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-  return `${escaped}\\d+`;
-}
-
-/**
- * Return true if the given string is a canonical WU ID for the configured
- * width and prefix. Canonical means:
- * - Prefix matches.
- * - Digit body is at least `width` characters long.
- * - The digit body is not shorter than width (no unpadded legacy).
- * - Overflow (body wider than width) is allowed so the sequence never truncates.
- */
-export function isCanonicalWuId(id: string, config: Partial<WuIdConfig> = {}): boolean {
-  const { width, prefix } = validateWuIdConfig(config);
-  if (typeof id !== 'string' || !id.startsWith(prefix)) {
-    return false;
-  }
-  const body = id.slice(prefix.length);
-  if (!/^\d+$/.test(body)) {
-    return false;
-  }
-  return body.length >= width;
-}
-
-/**
- * Canonicalize a (possibly legacy) WU ID to the canonical form for the
- * configured width. Returns null for unparseable input or prefix mismatch.
- *
- * Already-canonical IDs are returned unchanged. Overflow IDs (wider than
- * width) are preserved.
- */
-export function canonicalizeWuId(id: string, config: Partial<WuIdConfig> = {}): string | null {
-  const parsed = parseWuId(id, config);
-  if (!parsed) {
-    return null;
-  }
-  return formatWuId(parsed.num, config);
-}
-
-/**
- * Load the canonical WU id config from workspace.yaml
- * `software_delivery.wu_id.{width,strict,prefix}`.
- *
- * Falls back to {@link WU_ID_DEFAULTS} when the block is absent, so
- * existing repos without any wu_id config continue to see WU- prefixed
- * ids (backward compatible) with the only visible change being
- * zero-padding on newly-generated ids.
- *
- * @param options.projectRoot - Optional override for the project root.
- */
-export function loadWuIdConfig(options: { projectRoot?: string } = {}): WuIdConfig {
-  const cwd = options.projectRoot ?? process.cwd();
-  let section: Record<string, unknown>;
-  try {
-    section = readSoftwareDeliveryConfig(cwd);
-  } catch {
-    // Graceful fallback when workspace.yaml is absent/unreadable — matches
-    // core's non-strictWorkspace behaviour.
-    return validateWuIdConfig({});
-  }
-  // Accept both snake_case (canonical YAML) and camelCase (post-normalization)
-  // spellings so this primitive stays callable whether the caller passes a raw
-  // YAML section or a pre-normalized shape.
-  const wuIdBlock =
-    (section['wuId'] as Partial<WuIdConfig> | undefined) ??
-    (section['wu_id'] as Partial<WuIdConfig> | undefined);
-  return validateWuIdConfig(wuIdBlock ?? {});
-}
-
-/** Inputs for {@link scanExistingWuNumbers}. */
-export interface ScanExistingWuNumbersInput {
-  /** Absolute path to the WU YAML directory. */
-  wuDir: string;
-  /** Absolute path to the stamps directory. */
-  stampsDir: string;
-  /** Absolute path to `wu-events.jsonl` (may or may not exist). */
-  eventsPath: string;
-}
-
-/**
- * Scan every existing WU id integer across the yaml directory, stamps
- * directory, and event log. Used by wu:create for integer-level
- * collision detection so `WU-14` and `WU-0014` can never coexist.
- *
- * Results are deduplicated across sources. Entries whose prefix does
- * not match the configured prefix are ignored. Extension suffixes
- * (`.yaml`, `.done`) are stripped before parsing.
- */
-export function scanExistingWuNumbers(
-  input: ScanExistingWuNumbersInput,
-  config: Partial<WuIdConfig> = {},
-): Set<number> {
-  const result = new Set<number>();
-
-  const addFromEntries = (entries: readonly string[]): void => {
-    for (const entry of entries) {
-      const parsed = parseWuId(entry, config);
-      if (parsed) {
-        result.add(parsed.num);
-      }
-    }
-  };
-
-  if (existsSync(input.wuDir)) {
-    addFromEntries(readdirSync(input.wuDir));
-  }
-  if (existsSync(input.stampsDir)) {
-    addFromEntries(readdirSync(input.stampsDir));
-  }
-  if (existsSync(input.eventsPath)) {
-    try {
-      const content = readFileSync(input.eventsPath, { encoding: 'utf-8' });
-      for (const line of content.split('\n')) {
-        const trimmed = line.trim();
-        if (trimmed.length === 0) continue;
-        try {
-          const event = JSON.parse(trimmed) as {
-            wuId?: string;
-            from?: string;
-            to?: string;
-          };
-          for (const candidate of [event.wuId, event.from, event.to]) {
-            if (typeof candidate === 'string') {
-              const parsed = parseWuId(candidate, config);
-              if (parsed) {
-                result.add(parsed.num);
-              }
-            }
-          }
-        } catch {
-          // Ignore malformed lines; the events file is allowed to have gaps.
-        }
-      }
-    } catch {
-      // Read errors fall through; caller treats this as "no known ids".
-    }
-  }
-
-  return result;
-}
-
-/**
- * Returns true when `num` is already present in the given set.
- * Thin wrapper for call-site readability at the wu:create integration point.
- */
-export function integerCollides(existing: ReadonlySet<number>, num: number): boolean {
-  return existing.has(num);
-}
-
-/**
- * Returns true when the given WU number is within the width-exhaustion
- * warning band (>= 90% of 10^width) but still below the width ceiling.
- *
- * Numbers that already exceed the width capacity return false so the
- * warning only fires once, not on every subsequent overflow id.
- */
-export function isWidthExhaustionWarning(num: number, config: Partial<WuIdConfig> = {}): boolean {
-  const { width } = validateWuIdConfig(config);
-  const capacity = Math.pow(10, width);
-  const threshold = capacity * 0.9;
-  return num >= threshold && num < capacity;
-}

package/packs/software-delivery/src/constants/wu-paths-constants.ts

@@ -1,384 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: LicenseRef-LumenFlow-Proprietary
-
-/**
- * Path and File System Constants
- *
- * WU-1549: Extracted from wu-constants.ts for bounded-concern modularity.
- * Contains LumenFlow directory paths, file extensions, config files, filesystem
- * constants, build artifacts, and path manipulation helpers.
- *
- * @module wu-paths-constants
- */
-
-import path from 'node:path';
-import { tmpdir } from 'node:os';
-import { GIT_DIRECTORY_NAME, WORKSPACE_CONFIG_FILE_NAME } from './config-contract.js';
-import { DEFAULT_DOCS_LAYOUT, DOCS_LAYOUT_PRESETS } from './docs-layout-presets.js';
-
-const DEFAULT_DOCS_PATHS = DOCS_LAYOUT_PRESETS[DEFAULT_DOCS_LAYOUT];
-
-/**
- * WU-1548: Shared Node.js filesystem error interface.
- *
- * Consolidates duplicated NodeFsError definitions that existed across
- * memory-store.ts, mem-triage-core.ts, mem-signal-core.ts, mem-ready-core.ts,
- * signal-cleanup-core.ts, and wu-events-cleanup.ts.
- *
- * Use this interface when catching fs errors and checking the `code` property
- * (e.g., 'ENOENT', 'EACCES', 'EPERM').
- */
-export interface NodeFsError extends Error {
-  code?: string;
-}
-
-const UTF8_ENCODING = 'utf8' as const;
-
-/**
- * File system constants
- *
- * WU-923: Centralized to eliminate hardcoded strings
- */
-export const FILE_SYSTEM = {
-  /** Standard file encoding */
-  ENCODING: UTF8_ENCODING,
-
-  /** UTF-8 encoding (alias for compatibility) */
-  UTF8: UTF8_ENCODING,
-};
-
-/**
- * Configuration file paths
- *
- * WU-923: Centralized config file names
- */
-export const CONFIG_FILES = {
-  /** Canonical workspace config */
-  WORKSPACE_CONFIG: WORKSPACE_CONFIG_FILE_NAME,
-
-  /** Lane inference taxonomy */
-  LANE_INFERENCE: '.lumenflow.lane-inference.yaml',
-};
-
-/**
- * Directory paths within the monorepo
- *
- * Centralized directory path strings.
- */
-export const DIRECTORIES = {
-  APPS_WEB: 'apps/web/',
-  WORKTREES: 'worktrees/',
-  AI: 'ai/',
-  CLAUDE: '.claude/',
-  CLAUDE_HOOKS: '.claude/hooks/',
-  DOCS: 'docs/',
-  PACKAGES: 'packages/',
-  TOOLS: 'tools/',
-  MEMORY_BANK: 'memory-bank/',
-  WU_DIR: `${DEFAULT_DOCS_PATHS.tasks}/wu`,
-  INITIATIVES_DIR: `${DEFAULT_DOCS_PATHS.tasks}/initiatives`,
-  // WU-1814: Paths for active WU detection
-  BACKLOG_PATH: `${DEFAULT_DOCS_PATHS.tasks}/backlog.md`,
-  STATUS_PATH: `${DEFAULT_DOCS_PATHS.tasks}/status.md`,
-};
-
-/**
- * Shared agent/client surface paths.
- *
- * Keeps vendor overlay and shared projection roots centralized so runtime code
- * does not scatter hardcoded path literals through CLI/core packages.
- */
-export const AGENT_SURFACES = {
-  /** Claude-projected skills directory */
-  CLAUDE_SKILLS_DIR: '.claude/skills',
-
-  /** Claude agent overlay directory */
-  CLAUDE_AGENTS_DIR: '.claude/agents',
-
-  /** Shared cross-vendor projected skills directory */
-  SHARED_SKILLS_DIR: '.agents/skills',
-
-  /** Codex agent overlay directory */
-  CODEX_AGENTS_DIR: '.codex/agents',
-
-  /** Gemini projected skills directory */
-  GEMINI_SKILLS_DIR: '.gemini/skills',
-
-  /** Gemini agent overlay directory */
-  GEMINI_AGENTS_DIR: '.gemini/agents',
-};
-
-/**
- * Build artifact cleanup globs
- *
- * Centralized glob patterns for worktree artifact cleanup.
- */
-export const BUILD_ARTIFACT_GLOBS = {
-  /** Common dist directories inside worktrees */
-  DIST_DIRS: [
-    'packages/*/dist',
-    'packages/**/dist',
-    'apps/*/dist',
-    'apps/**/dist',
-    'tools/*/dist',
-    'tools/**/dist',
-  ],
-
-  /** TypeScript build info files */
-  TSBUILDINFO_FILES: ['**/*.tsbuildinfo'],
-};
-
-/**
- * Build artifact cleanup ignore patterns
- *
- * Centralized ignore globs for artifact cleanup.
- */
-const GIT_ARTIFACT_IGNORE_GLOB = `**/${GIT_DIRECTORY_NAME}/**`;
-export const BUILD_ARTIFACT_IGNORES = [
-  '**/node_modules/**',
-  GIT_ARTIFACT_IGNORE_GLOB,
-  '**/.turbo/**',
-];
-
-/**
- * Script file paths
- *
- * Centralized paths to validation scripts.
- */
-export const SCRIPT_PATHS = {
-  /** Prompt registry validation */
-  VALIDATE_PROMPT_REGISTRY: 'tools/validate-prompt-registry.js',
-};
-
-/**
- * File extensions
- *
- * Centralized file extension strings to avoid magic strings.
- */
-export const FILE_EXTENSIONS = {
-  /** Newline-delimited JSON format */
-  NDJSON: '.ndjson',
-
-  /** Markdown format */
-  MARKDOWN: '.md',
-
-  /** YAML format */
-  YAML: '.yaml',
-
-  /** YAML alternate extension */
-  YML: '.yml',
-
-  /** JSON format */
-  JSON: '.json',
-
-  /** Log format */
-  LOG: '.log',
-
-  /** Stamp files (completion markers) */
-  STAMP: '.done',
-};
-
-/**
- * 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: /\/+$/,
-
-  /** .lumenflow path prefix for internal path detection (WU-1430) */
-  LUMENFLOW_PREFIX: '.lumenflow/',
-
-  /** Current directory prefix for repo-internal paths (WU-1430) */
-  CURRENT_DIR_PREFIX: './',
-};
-
-/**
- * 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,
-};
-
-/**
- * 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
- *
- * Centralized paths for .lumenflow directory structure to eliminate hardcoded strings.
- * Used by telemetry, agent-session, agent-incidents, memory, and commands-logger modules.
- */
-export const LUMENFLOW_PATHS = {
-  /** Base directory for all LumenFlow runtime data */
-  BASE: '.lumenflow',
-
-  /** WU state store directory */
-  STATE_DIR: '.lumenflow/state',
-
-  /** Stamp directory (WU completion markers) */
-  STAMPS_DIR: '.lumenflow/stamps',
-
-  /** Archive directory for old WU events (WU-1430) */
-  ARCHIVE_DIR: '.lumenflow/archive',
-
-  /** Merge lock file (runtime coordination, WU-1747) */
-  MERGE_LOCK: '.lumenflow/merge.lock',
-
-  /** Base telemetry directory */
-  TELEMETRY: '.lumenflow/telemetry',
-
-  /** Flow log file (WU flow events) */
-  FLOW_LOG: '.lumenflow/flow.log',
-
-  /** Agent sessions directory */
-  SESSIONS: '.lumenflow/sessions',
-
-  /** Agent incidents directory */
-  INCIDENTS: '.lumenflow/incidents',
-
-  /** Git commands log file */
-  COMMANDS_LOG: '.lumenflow/commands.log',
-
-  /** Memory layer directory */
-  MEMORY_DIR: '.lumenflow/memory',
-
-  /** Memory layer JSONL file */
-  MEMORY_JSONL: '.lumenflow/memory/memory.jsonl',
-
-  /** WU-1539: Memory signals JSONL file */
-  MEMORY_SIGNALS: '.lumenflow/memory/signals.jsonl',
-
-  /** Audit log for tool calls */
-  AUDIT_LOG: '.lumenflow/telemetry/tools.ndjson',
-
-  /** Feedback drafts directory */
-  FEEDBACK_DRAFTS: '.lumenflow/feedback-drafts',
-
-  /** Feedback index file */
-  FEEDBACK_INDEX: '.lumenflow/feedback-index.ndjson',
-
-  /** Current session file */
-  SESSION_CURRENT: '.lumenflow/sessions/current.json',
-
-  /** WU events log */
-  WU_EVENTS: '.lumenflow/state/wu-events.jsonl',
-
-  /** Lock files directory (lane locks - persisted) */
-  LOCKS_DIR: '.lumenflow/locks',
-
-  /** Force bypass audit log */
-  FORCE_BYPASSES: '.lumenflow/force-bypasses.log',
-
-  /** WU-1539: Skip-gates audit log */
-  SKIP_GATES_AUDIT: '.lumenflow/skip-gates-audit.log',
-
-  /** WU-1539: Skip-COS-gates audit log */
-  SKIP_COS_GATES_AUDIT: '.lumenflow/skip-cos-gates-audit.log',
-
-  /** Test baseline file for ratchet pattern (WU-1430) */
-  TEST_BASELINE: '.lumenflow/test-baseline.json',
-
-  /** Templates directory (WU-1430) */
-  TEMPLATES_DIR: '.lumenflow/templates',
-
-  /** Spawn prompt templates (WU-1674) */
-  SPAWN_PROMPT_DIR: '.lumenflow/templates/spawn-prompt',
-
-  /** Template manifest file (WU-1430) */
-  TEMPLATE_MANIFEST: '.lumenflow/templates/manifest.yaml',
-
-  /** Skills directory for agent skills (WU-1430) */
-  SKILLS_DIR: '.lumenflow/skills',
-
-  /** Agents directory for agent definitions (WU-1430) */
-  AGENTS_DIR: '.lumenflow/agents',
-
-  /** Methodology log for delegation telemetry (WU-1430) */
-  METHODOLOGY_LOG: '.lumenflow/telemetry/methodology.ndjson',
-
-  /** Prompt metrics cache (WU-1430) */
-  PROMPT_METRICS: '.lumenflow/telemetry/prompt-metrics.json',
-
-  /** Prompt lint results (WU-1430) */
-  PROMPT_LINT: '.lumenflow/telemetry/prompt-lint.ndjson',
-
-  /** Recovery markers directory (WU-1430) */
-  RECOVERY_DIR: '.lumenflow/recovery',
-
-  /** Checkpoints directory (WU-1430) */
-  CHECKPOINTS_DIR: '.lumenflow/checkpoints',
-
-  /** WU-1471: Hook counters directory for auto-checkpoint interval tracking */
-  HOOK_COUNTERS_DIR: '.lumenflow/state/hook-counters',
-
-  /** Cache directory under user home (WU-1430) */
-  HOME_CACHE: 'cache',
-
-  /**
-   * 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),
-};
-
-/**
- * File tool constants (WU-1403)
- *
- * Centralized strings for file:read, file:write, file:edit tools.
- * Prevents duplicate string literals and hardcoded magic values.
- */
-export const FILE_TOOLS = {
-  /** Tool name prefixes */
-  NAMES: {
-    READ: 'file:read',
-    WRITE: 'file:write',
-    EDIT: 'file:edit',
-    DELETE: 'file:delete',
-  },
-
-  /** Tool domain */
-  DOMAIN: 'file',
-
-  /** Permission levels */
-  PERMISSIONS: {
-    READ: 'read',
-    WRITE: 'write',
-  },
-
-  /** Worktree instruction templates (WU-1403: provides reusable instruction strings) */
-  WORKTREE_INSTRUCTIONS: {
-    CLAIM_COMMAND: 'pnpm wu:claim --id <wu-id> --lane "<lane>"',
-    CD_COMMAND: 'cd worktrees/<lane>-<wu-id>/',
-    DOC_REFERENCE: 'CLAUDE.md §2 (Worktree Discipline)',
-  },
-};