@lumenflow/core 2.9.0 → 2.10.0

package/dist/index.d.ts

@@ -62,6 +62,7 @@ export * from './recovery/index.js';
 export * from './context-validation-integration.js';
 export { CONTEXT_VALIDATION } from './wu-constants.js';
 export type { ValidationErrorCode, PredicateSeverity, ValidationMode } from './wu-constants.js';
+export { CLAUDE_HOOKS, getHookCommand } from './wu-constants.js';
 export { LocationType } from './domain/context.schemas.js';
 export { RecoveryIssueCode, RecoveryActionType } from './domain/recovery.schemas.js';
 export type { ILocationResolver, IGitStateReader, IWuStateReader } from './ports/context.ports.js';

package/dist/index.js

@@ -98,6 +98,8 @@ export * from './recovery/index.js';
 export * from './context-validation-integration.js';
 // WU-1090: Context validation constants
 export { CONTEXT_VALIDATION } from './wu-constants.js';
+// WU-1394: Claude Code hook constants for enforcement and recovery
+export { CLAUDE_HOOKS, getHookCommand } from './wu-constants.js';
 // WU-1126: Enum-style constants for port interfaces (const + type pairs)
 // These provide named constants to avoid magic string literals in code
 // The const objects serve as both runtime values AND types via TypeScript's const/type pattern

package/dist/wu-constants.d.ts

@@ -1021,6 +1021,7 @@ export declare const DIRECTORIES: {
     WORKTREES: string;
     AI: string;
     CLAUDE: string;
+    CLAUDE_HOOKS: string;
     DOCS: string;
     PACKAGES: string;
     TOOLS: string;
@@ -1030,6 +1031,43 @@ export declare const DIRECTORIES: {
     BACKLOG_PATH: string;
     STATUS_PATH: string;
 };
+/**
+ * Claude Code hook script constants (WU-1394)
+ *
+ * Centralized constants for Claude Code enforcement and recovery hooks.
+ * Used by enforcement-generator.ts, enforcement-sync.ts, and init.ts.
+ *
+ * @see packages/@lumenflow/cli/src/hooks/enforcement-generator.ts
+ * @see packages/@lumenflow/cli/src/hooks/enforcement-sync.ts
+ */
+export declare const CLAUDE_HOOKS: {
+    /** Hook script filenames */
+    readonly SCRIPTS: {
+        readonly ENFORCE_WORKTREE: "enforce-worktree.sh";
+        readonly REQUIRE_WU: "require-wu.sh";
+        readonly WARN_INCOMPLETE: "warn-incomplete.sh";
+        readonly PRE_COMPACT_CHECKPOINT: "pre-compact-checkpoint.sh";
+        readonly SESSION_START_RECOVERY: "session-start-recovery.sh";
+    };
+    /** Hook command path prefix (uses Claude Code's $CLAUDE_PROJECT_DIR variable) */
+    readonly PATH_PREFIX: "$CLAUDE_PROJECT_DIR/.claude/hooks";
+    /** Hook matchers for settings.json */
+    readonly MATCHERS: {
+        readonly ALL: ".*";
+        readonly WRITE_EDIT: "Write|Edit";
+        readonly COMPACT: "compact";
+        readonly RESUME: "resume";
+        readonly CLEAR: "clear";
+    };
+    /** Template paths (relative to templates directory) */
+    readonly TEMPLATES: {
+        readonly SETTINGS: "vendors/claude/.claude/settings.json.template";
+        readonly PRE_COMPACT: "vendors/claude/.claude/hooks/pre-compact-checkpoint.sh";
+        readonly SESSION_START: "vendors/claude/.claude/hooks/session-start-recovery.sh";
+    };
+};
+/** Build full hook command path from script name */
+export declare const getHookCommand: (scriptName: string) => string;
 /**
  * ESLint cache strategy values
  */

package/dist/wu-constants.js

@@ -1066,6 +1066,7 @@ export const DIRECTORIES = {
     WORKTREES: 'worktrees/',
     AI: 'ai/',
     CLAUDE: '.claude/',
+    CLAUDE_HOOKS: '.claude/hooks/',
     DOCS: 'docs/',
     PACKAGES: 'packages/',
     TOOLS: 'tools/',
@@ -1076,6 +1077,43 @@ export const DIRECTORIES = {
     BACKLOG_PATH: 'docs/04-operations/tasks/backlog.md',
     STATUS_PATH: 'docs/04-operations/tasks/status.md',
 };
+/**
+ * Claude Code hook script constants (WU-1394)
+ *
+ * Centralized constants for Claude Code enforcement and recovery hooks.
+ * Used by enforcement-generator.ts, enforcement-sync.ts, and init.ts.
+ *
+ * @see packages/@lumenflow/cli/src/hooks/enforcement-generator.ts
+ * @see packages/@lumenflow/cli/src/hooks/enforcement-sync.ts
+ */
+export const CLAUDE_HOOKS = {
+    /** Hook script filenames */
+    SCRIPTS: {
+        ENFORCE_WORKTREE: 'enforce-worktree.sh',
+        REQUIRE_WU: 'require-wu.sh',
+        WARN_INCOMPLETE: 'warn-incomplete.sh',
+        PRE_COMPACT_CHECKPOINT: 'pre-compact-checkpoint.sh',
+        SESSION_START_RECOVERY: 'session-start-recovery.sh',
+    },
+    /** Hook command path prefix (uses Claude Code's $CLAUDE_PROJECT_DIR variable) */
+    PATH_PREFIX: '$CLAUDE_PROJECT_DIR/.claude/hooks',
+    /** Hook matchers for settings.json */
+    MATCHERS: {
+        ALL: '.*',
+        WRITE_EDIT: 'Write|Edit',
+        COMPACT: 'compact',
+        RESUME: 'resume',
+        CLEAR: 'clear',
+    },
+    /** Template paths (relative to templates directory) */
+    TEMPLATES: {
+        SETTINGS: 'vendors/claude/.claude/settings.json.template',
+        PRE_COMPACT: 'vendors/claude/.claude/hooks/pre-compact-checkpoint.sh',
+        SESSION_START: 'vendors/claude/.claude/hooks/session-start-recovery.sh',
+    },
+};
+/** Build full hook command path from script name */
+export const getHookCommand = (scriptName) => `${CLAUDE_HOOKS.PATH_PREFIX}/${scriptName}`;
 /**
  * ESLint cache strategy values
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/core",
-  "version": "2.9.0",
+  "version": "2.10.0",
   "description": "Core WU lifecycle tools for LumenFlow workflow framework",
   "keywords": [
     "lumenflow",
@@ -99,7 +99,7 @@
     "vitest": "^4.0.17"
   },
   "peerDependencies": {
-    "@lumenflow/memory": "2.9.0"
+    "@lumenflow/memory": "2.10.0"
   },
   "peerDependenciesMeta": {
     "@lumenflow/memory": {