@lumenflow/core 2.15.1 → 2.16.0

package/dist/wu-paths-constants.d.ts

@@ -0,0 +1,311 @@
+/**
+ * Path and File System Constants
+ *
+ * WU-1549: Extracted from wu-constants.ts for domain-specific modularity.
+ * Contains LumenFlow directory paths, file extensions, config files, filesystem
+ * constants, build artifacts, PHI configuration, and path manipulation helpers.
+ *
+ * @module wu-paths-constants
+ */
+/**
+ * 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;
+}
+/**
+ * File system constants
+ *
+ * WU-923: Centralized to eliminate hardcoded strings
+ */
+export declare const FILE_SYSTEM: {
+    /** Standard file encoding */
+    ENCODING: string;
+    /** UTF-8 encoding (alias for compatibility) */
+    UTF8: string;
+};
+/**
+ * Configuration file paths
+ *
+ * WU-923: Centralized config file names
+ */
+export declare const CONFIG_FILES: {
+    /** LumenFlow main config */
+    LUMENFLOW_CONFIG: string;
+    /** Lane inference taxonomy */
+    LANE_INFERENCE: string;
+};
+/**
+ * Directory paths within the monorepo
+ *
+ * Centralized directory path strings.
+ */
+export declare const DIRECTORIES: {
+    APPS_WEB: string;
+    WORKTREES: string;
+    AI: string;
+    CLAUDE: string;
+    CLAUDE_HOOKS: string;
+    DOCS: string;
+    PACKAGES: string;
+    TOOLS: string;
+    MEMORY_BANK: string;
+    WU_DIR: string;
+    INITIATIVES_DIR: string;
+    BACKLOG_PATH: string;
+    STATUS_PATH: string;
+};
+/**
+ * Build artifact cleanup globs
+ *
+ * Centralized glob patterns for worktree artifact cleanup.
+ */
+export declare const BUILD_ARTIFACT_GLOBS: {
+    /** Common dist directories inside worktrees */
+    DIST_DIRS: string[];
+    /** TypeScript build info files */
+    TSBUILDINFO_FILES: string[];
+};
+/**
+ * Build artifact cleanup ignore patterns
+ *
+ * Centralized ignore globs for artifact cleanup.
+ */
+export declare const BUILD_ARTIFACT_IGNORES: string[];
+/**
+ * Script file paths
+ *
+ * Centralized paths to validation scripts.
+ */
+export declare const SCRIPT_PATHS: {
+    /** Prompt registry validation */
+    VALIDATE_PROMPT_REGISTRY: string;
+};
+/**
+ * File extensions
+ *
+ * Centralized file extension strings to avoid magic strings.
+ */
+export declare const FILE_EXTENSIONS: {
+    /** Newline-delimited JSON format */
+    NDJSON: string;
+    /** Markdown format */
+    MARKDOWN: string;
+    /** YAML format */
+    YAML: string;
+    /** Log format */
+    LOG: string;
+    /** Stamp files (completion markers) */
+    STAMP: string;
+};
+/**
+ * Path patterns for WU-related files
+ */
+export declare const PATH_PATTERNS: {
+    /** Matches WU YAML paths in both legacy and current locations */
+    WU_YAML: RegExp;
+    /** Matches stamp file paths */
+    STAMP: RegExp;
+};
+/**
+ * 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;
+    /** .lumenflow path prefix for internal path detection (WU-1430) */
+    LUMENFLOW_PREFIX: string;
+    /** Current directory prefix for repo-internal paths (WU-1430) */
+    CURRENT_DIR_PREFIX: string;
+};
+/**
+ * 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;
+};
+/**
+ * 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 declare 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 declare const LUMENFLOW_PATHS: {
+    /** Base directory for all LumenFlow runtime data */
+    BASE: string;
+    /** WU state store directory */
+    STATE_DIR: string;
+    /** Stamp directory (WU completion markers) */
+    STAMPS_DIR: string;
+    /** Archive directory for old WU events (WU-1430) */
+    ARCHIVE_DIR: string;
+    /** Merge lock file (runtime coordination, WU-1747) */
+    MERGE_LOCK: string;
+    /** Base telemetry directory */
+    TELEMETRY: string;
+    /** Flow log file (WU flow events) */
+    FLOW_LOG: string;
+    /** Agent sessions directory */
+    SESSIONS: string;
+    /** Agent incidents directory */
+    INCIDENTS: string;
+    /** Git commands log file */
+    COMMANDS_LOG: string;
+    /** Memory layer directory */
+    MEMORY_DIR: string;
+    /** Memory layer JSONL file */
+    MEMORY_JSONL: string;
+    /** WU-1539: Memory signals JSONL file */
+    MEMORY_SIGNALS: string;
+    /** Audit log for tool calls */
+    AUDIT_LOG: string;
+    /** Feedback drafts directory */
+    FEEDBACK_DRAFTS: string;
+    /** Feedback index file */
+    FEEDBACK_INDEX: string;
+    /** Current session file */
+    SESSION_CURRENT: string;
+    /** WU events log */
+    WU_EVENTS: string;
+    /** Lock files directory (lane locks - persisted) */
+    LOCKS_DIR: string;
+    /** Force bypass audit log */
+    FORCE_BYPASSES: string;
+    /** WU-1539: Skip-gates audit log */
+    SKIP_GATES_AUDIT: string;
+    /** WU-1539: Skip-COS-gates audit log */
+    SKIP_COS_GATES_AUDIT: string;
+    /** Test baseline file for ratchet pattern (WU-1430) */
+    TEST_BASELINE: string;
+    /** Templates directory (WU-1430) */
+    TEMPLATES_DIR: string;
+    /** Spawn prompt templates (WU-1430) */
+    SPAWN_PROMPT_DIR: string;
+    /** Template manifest file (WU-1430) */
+    TEMPLATE_MANIFEST: string;
+    /** Skills directory for agent skills (WU-1430) */
+    SKILLS_DIR: string;
+    /** Agents directory for agent definitions (WU-1430) */
+    AGENTS_DIR: string;
+    /** Methodology log for spawn telemetry (WU-1430) */
+    METHODOLOGY_LOG: string;
+    /** Prompt metrics cache (WU-1430) */
+    PROMPT_METRICS: string;
+    /** Prompt lint results (WU-1430) */
+    PROMPT_LINT: string;
+    /** Recovery markers directory (WU-1430) */
+    RECOVERY_DIR: string;
+    /** Checkpoints directory (WU-1430) */
+    CHECKPOINTS_DIR: string;
+    /** WU-1471: Hook counters directory for auto-checkpoint interval tracking */
+    HOOK_COUNTERS_DIR: string;
+    /** Cache directory under user home (WU-1430) */
+    HOME_CACHE: string;
+    /**
+     * 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: string;
+};
+/**
+ * File tool constants (WU-1403)
+ *
+ * Centralized strings for file:read, file:write, file:edit tools.
+ * Prevents duplicate string literals and hardcoded magic values.
+ */
+export declare const FILE_TOOLS: {
+    /** Tool name prefixes */
+    NAMES: {
+        READ: string;
+        WRITE: string;
+        EDIT: string;
+        DELETE: string;
+    };
+    /** Tool domain */
+    DOMAIN: string;
+    /** Permission levels */
+    PERMISSIONS: {
+        READ: string;
+        WRITE: string;
+    };
+    /** Worktree instruction templates (WU-1403: provides reusable instruction strings) */
+    WORKTREE_INSTRUCTIONS: {
+        CLAIM_COMMAND: string;
+        CD_COMMAND: string;
+        DOC_REFERENCE: string;
+    };
+};
+/**
+ * PHI (Protected Health Information) error codes (WU-1404)
+ *
+ * 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 */
+    PHI_DETECTED: string;
+    /** 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;
+};
+//# sourceMappingURL=wu-paths-constants.d.ts.map

package/dist/wu-paths-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-paths-constants.d.ts","sourceRoot":"","sources":["../src/wu-paths-constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAY,SAAQ,KAAK;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW;IACtB,6BAA6B;;IAG7B,+CAA+C;;CAEhD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY;IACvB,4BAA4B;;IAG5B,8BAA8B;;CAE/B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;CAevB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;IAC/B,+CAA+C;;IAU/C,kCAAkC;;CAEnC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,UAAuD,CAAC;AAE3F;;;;GAIG;AACH,eAAO,MAAM,YAAY;IACvB,iCAAiC;;CAElC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe;IAC1B,oCAAoC;;IAGpC,sBAAsB;;IAGtB,kBAAkB;;IAGlB,iBAAiB;;IAGjB,uCAAuC;;CAExC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB,iEAAiE;;IAGjE,+BAA+B;;CAEhC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa;IACxB,+DAA+D;;IAG/D,yCAAyC;;IAGzC,oCAAoC;;IAGpC,mCAAmC;;IAGnC,mEAAmE;;IAGnE,iEAAiE;;CAElE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;IAC7B,gDAAgD;;IAGhD,8CAA8C;;CAE/C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,qBAAqB,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,eAAe;IAC1B,oDAAoD;;IAGpD,+BAA+B;;IAG/B,8CAA8C;;IAG9C,oDAAoD;;IAGpD,sDAAsD;;IAGtD,+BAA+B;;IAG/B,qCAAqC;;IAGrC,+BAA+B;;IAG/B,gCAAgC;;IAGhC,4BAA4B;;IAG5B,6BAA6B;;IAG7B,8BAA8B;;IAG9B,yCAAyC;;IAGzC,+BAA+B;;IAG/B,gCAAgC;;IAGhC,0BAA0B;;IAG1B,2BAA2B;;IAG3B,oBAAoB;;IAGpB,oDAAoD;;IAGpD,6BAA6B;;IAG7B,oCAAoC;;IAGpC,wCAAwC;;IAGxC,uDAAuD;;IAGvD,oCAAoC;;IAGpC,uCAAuC;;IAGvC,uCAAuC;;IAGvC,kDAAkD;;IAGlD,uDAAuD;;IAGvD,oDAAoD;;IAGpD,qCAAqC;;IAGrC,oCAAoC;;IAGpC,2CAA2C;;IAG3C,sCAAsC;;IAGtC,6EAA6E;;IAG7E,gDAAgD;;IAGhD;;;;;;;;;;;OAWG;;CAEJ,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,UAAU;IACrB,yBAAyB;;;;;;;IAQzB,kBAAkB;;IAGlB,wBAAwB;;;;;IAMxB,sFAAsF;;;;;;CAMvF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU;IACrB,8CAA8C;;IAG9C,4CAA4C;;CAE7C,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU;IACrB;;;OAGG;;IAGH;;OAEG;;CAEJ,CAAC"}

package/dist/wu-paths-constants.js

@@ -0,0 +1,308 @@
+/**
+ * Path and File System Constants
+ *
+ * WU-1549: Extracted from wu-constants.ts for domain-specific modularity.
+ * Contains LumenFlow directory paths, file extensions, config files, filesystem
+ * constants, build artifacts, PHI configuration, and path manipulation helpers.
+ *
+ * @module wu-paths-constants
+ */
+import path from 'node:path';
+import { tmpdir } from 'node:os';
+/**
+ * File system constants
+ *
+ * WU-923: Centralized to eliminate hardcoded strings
+ */
+export const FILE_SYSTEM = {
+    /** Standard file encoding */
+    ENCODING: 'utf8',
+    /** UTF-8 encoding (alias for compatibility) */
+    UTF8: 'utf8',
+};
+/**
+ * Configuration file paths
+ *
+ * WU-923: Centralized config file names
+ */
+export const CONFIG_FILES = {
+    /** LumenFlow main config */
+    LUMENFLOW_CONFIG: '.lumenflow.config.yaml',
+    /** 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: 'docs/04-operations/tasks/wu',
+    INITIATIVES_DIR: 'docs/04-operations/tasks/initiatives',
+    // WU-1814: Paths for active WU detection
+    BACKLOG_PATH: 'docs/04-operations/tasks/backlog.md',
+    STATUS_PATH: 'docs/04-operations/tasks/status.md',
+};
+/**
+ * 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.
+ */
+export const BUILD_ARTIFACT_IGNORES = ['**/node_modules/**', '**/.git/**', '**/.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',
+    /** Log format */
+    LOG: '.log',
+    /** Stamp files (completion markers) */
+    STAMP: '.done',
+};
+/**
+ * Path patterns for WU-related files
+ */
+export const PATH_PATTERNS = {
+    /** Matches WU YAML paths in both legacy and current locations */
+    WU_YAML: /(?:memory-bank|docs\/04-operations)\/tasks\/wu\/(WU-\d+)\.ya?ml$/i,
+    /** Matches stamp file paths */
+    STAMP: /\.lumenflow\/stamps\/(WU-\d+)\.done$/i,
+};
+/**
+ * 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-1430) */
+    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 spawn 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)',
+    },
+};
+/**
+ * PHI (Protected Health Information) error codes (WU-1404)
+ *
+ * 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 */
+    PHI_DETECTED: 'PHI_DETECTED',
+    /** 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',
+};
+//# sourceMappingURL=wu-paths-constants.js.map

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

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

package/dist/wu-paths.d.ts

@@ -76,6 +76,12 @@ export declare function createWuPaths(options?: {
      * @returns Path to initiatives directory
      */
     INITIATIVES_DIR: () => string;
+    /**
+     * Get path to initiative YAML file
+     * @param id - Initiative ID (e.g., 'INIT-001')
+     * @returns Path to initiative YAML file
+     */
+    INITIATIVE: (id: string) => string;
     /**
      * Get path to worktrees directory
      * @returns Path to worktrees directory
@@ -144,6 +150,12 @@ export declare const WU_PATHS: {
      * @returns Path to initiatives directory
      */
     INITIATIVES_DIR: () => string;
+    /**
+     * Get path to initiative YAML file
+     * @param id - Initiative ID (e.g., 'INIT-001')
+     * @returns Path to initiative YAML file
+     */
+    INITIATIVE: (id: string) => string;
     /**
      * Get path to worktrees directory
      * @returns Path to worktrees directory

package/dist/wu-paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wu-paths.d.ts","sourceRoot":"","sources":["../src/wu-paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqBH;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAM3E;AAmBD;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAKvE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO;IAIhE;;;;OAIG;aACM,MAAM;IAEf;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;;OAIG;gBACS,MAAM;IAElB;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;EAGN;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ;IAhFjB;;;;OAIG;aACM,MAAM;IAEf;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;;OAIG;gBACS,MAAM;IAElB;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;CASgC,CAAC;AAExC;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GACrD,MAAM,GAAG,IAAI,CAiBf;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CASvF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAI5F;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAI/F"}
+{"version":3,"file":"wu-paths.d.ts","sourceRoot":"","sources":["../src/wu-paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqBH;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAM3E;AAmBD;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAKvE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO;IAIhE;;;;OAIG;aACM,MAAM;IAEf;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;;OAIG;gBACS,MAAM;IAElB;;;OAGG;;IAGH;;;OAGG;;IAGH;;;;OAIG;qBACc,MAAM;IAEvB;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;EAGN;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ;IAvFjB;;;;OAIG;aACM,MAAM;IAEf;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;;OAIG;gBACS,MAAM;IAElB;;;OAGG;;IAGH;;;OAGG;;IAGH;;;;OAIG;qBACc,MAAM;IAEvB;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;CASgC,CAAC;AAExC;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GACrD,MAAM,GAAG,IAAI,CAiBf;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CASvF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAI5F;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAI/F"}

package/dist/wu-paths.js

@@ -12,7 +12,7 @@ import { getConfig, getProjectRoot as getProjectRootFromConfig } from './lumenfl
  * Directory depth constants for path resolution.
  * These define how many levels deep each standard file is from repo root.
  */
-const PATH_DEPTHS = {
+const _PATH_DEPTHS = {
     /** backlog.md is 4 levels deep: docs/04-operations/tasks/backlog.md */
     BACKLOG: 4,
     /** status.md is 4 levels deep: docs/04-operations/tasks/status.md */
@@ -120,6 +120,12 @@ export function createWuPaths(options = {}) {
          * @returns Path to initiatives directory
          */
         INITIATIVES_DIR: () => config.directories.initiativesDir,
+        /**
+         * Get path to initiative YAML file
+         * @param id - Initiative ID (e.g., 'INIT-001')
+         * @returns Path to initiative YAML file
+         */
+        INITIATIVE: (id) => path.join(config.directories.initiativesDir, `${id}.yaml`),
         /**
          * Get path to worktrees directory
          * @returns Path to worktrees directory