@lumenflow/core 3.2.0 → 3.2.1

package/dist/wu-paths-constants.js

@@ -0,0 +1,273 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * 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';
+const UTF8_ENCODING = 'utf8';
+/**
+ * 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.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',
+    /** Delegation prompt templates (WU-1674) */
+    DELEGATION_PROMPT_DIR: '.lumenflow/templates/delegation-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)',
+    },
+};
+//# 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

@@ -0,0 +1,211 @@
+/**
+ * Resolve repo root from an absolute file path by traversing up N directory levels.
+ *
+ * @param absolutePath - Absolute path to a file within the repo
+ * @param depth - Number of directory levels to traverse up
+ * @returns Absolute path to repo root
+ */
+export declare function resolveRepoRoot(absolutePath: string, depth: number): string;
+/**
+ * Get the state store directory path from backlog.md path.
+ *
+ * WU-1523: Now computes depth dynamically from configured backlog path
+ * instead of using a hardcoded depth constant. This fixes empty backlog.md
+ * and status.md rendering in scaffolded projects with non-default docs structures.
+ *
+ * @param backlogPath - Absolute path to backlog.md
+ * @returns Absolute path to state store directory
+ */
+export declare function getStateStoreDirFromBacklog(backlogPath: string): string;
+/**
+ * Create WU paths object with configurable base paths
+ *
+ * @param options - Options for path generation
+ * @param options.projectRoot - Override project root
+ * @returns WU paths object
+ */
+export declare function createWuPaths(options?: {
+    projectRoot?: string;
+}): {
+    /**
+     * Get path to WU YAML file
+     * @param id - WU ID (e.g., 'WU-123')
+     * @returns Path to WU YAML file
+     */
+    WU: (id: string) => string;
+    /**
+     * Get path to WU directory
+     * @returns Path to WU directory
+     */
+    WU_DIR: () => string;
+    /**
+     * Get path to status.md
+     * @returns Path to status.md
+     */
+    STATUS: () => string;
+    /**
+     * Get path to backlog.md
+     * @returns Path to backlog.md
+     */
+    BACKLOG: () => string;
+    /**
+     * Get path to stamps directory
+     * @returns Path to stamps directory
+     */
+    STAMPS_DIR: () => string;
+    /**
+     * Get path to WU done stamp file
+     * @param id - WU ID (e.g., 'WU-123')
+     * @returns Path to stamp file
+     */
+    STAMP: (id: string) => string;
+    /**
+     * Get path to state directory
+     * @returns Path to state directory
+     */
+    STATE_DIR: () => string;
+    /**
+     * Get path to initiatives directory
+     * @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
+     */
+    WORKTREES_DIR: () => string;
+    /**
+     * Get path to plans directory
+     * @returns Path to plans directory (WU-1301)
+     */
+    PLANS_DIR: () => string;
+    /**
+     * Get path to templates directory
+     * @returns Path to templates directory (WU-1310)
+     */
+    TEMPLATES_DIR: () => string;
+    /**
+     * Get path to onboarding directory
+     * @returns Path to onboarding directory (WU-1310)
+     */
+    ONBOARDING_DIR: () => string;
+};
+/**
+ * Default WU paths using default config
+ * For backwards compatibility with existing code
+ */
+export declare const WU_PATHS: {
+    /**
+     * Get path to WU YAML file
+     * @param id - WU ID (e.g., 'WU-123')
+     * @returns Path to WU YAML file
+     */
+    WU: (id: string) => string;
+    /**
+     * Get path to WU directory
+     * @returns Path to WU directory
+     */
+    WU_DIR: () => string;
+    /**
+     * Get path to status.md
+     * @returns Path to status.md
+     */
+    STATUS: () => string;
+    /**
+     * Get path to backlog.md
+     * @returns Path to backlog.md
+     */
+    BACKLOG: () => string;
+    /**
+     * Get path to stamps directory
+     * @returns Path to stamps directory
+     */
+    STAMPS_DIR: () => string;
+    /**
+     * Get path to WU done stamp file
+     * @param id - WU ID (e.g., 'WU-123')
+     * @returns Path to stamp file
+     */
+    STAMP: (id: string) => string;
+    /**
+     * Get path to state directory
+     * @returns Path to state directory
+     */
+    STATE_DIR: () => string;
+    /**
+     * Get path to initiatives directory
+     * @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
+     */
+    WORKTREES_DIR: () => string;
+    /**
+     * Get path to plans directory
+     * @returns Path to plans directory (WU-1301)
+     */
+    PLANS_DIR: () => string;
+    /**
+     * Get path to templates directory
+     * @returns Path to templates directory (WU-1310)
+     */
+    TEMPLATES_DIR: () => string;
+    /**
+     * Get path to onboarding directory
+     * @returns Path to onboarding directory (WU-1310)
+     */
+    ONBOARDING_DIR: () => string;
+};
+/**
+ * Generate default worktree path from WU document
+ *
+ * @param doc - WU document with lane and id fields
+ * @returns Worktree path or null if inputs are invalid
+ */
+export declare function defaultWorktreeFrom(doc: {
+    lane?: string;
+    id?: string;
+} | null | undefined): string | null;
+/**
+ * Resolve a repo-root-relative path to an absolute path using project root.
+ *
+ * @param relativePath - Path relative to project root
+ * @param moduleUrl - import.meta.url of the calling module (for backwards compat)
+ * @returns Absolute path resolved from project root
+ */
+export declare function resolveFromProjectRoot(relativePath: string, moduleUrl?: string): string;
+/**
+ * Get absolute path to WU YAML file
+ *
+ * @param id - WU ID (e.g., 'WU-123')
+ * @param options - Options
+ * @returns Absolute path to WU YAML file
+ */
+export declare function getAbsoluteWuPath(id: string, options?: {
+    projectRoot?: string;
+}): string;
+/**
+ * Get absolute path to stamp file
+ *
+ * @param id - WU ID (e.g., 'WU-123')
+ * @param options - Options
+ * @returns Absolute path to stamp file
+ */
+export declare function getAbsoluteStampPath(id: string, options?: {
+    projectRoot?: string;
+}): string;
+//# sourceMappingURL=wu-paths.d.ts.map

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

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