@lumenflow/core 2.0.0 → 2.1.1

package/dist/domain/context.schemas.d.ts

@@ -15,6 +15,28 @@ import { z } from 'zod';
  * Mirrors CONTEXT_VALIDATION.LOCATION_TYPES from wu-constants.ts
  */
 export declare const LOCATION_TYPE_VALUES: readonly ["main", "worktree", "detached", "unknown"];
+/**
+ * LocationType enum for use in code
+ *
+ * Provides named constants for location types to avoid magic string literals.
+ *
+ * @example
+ * import { LocationType } from '@lumenflow/core';
+ *
+ * if (location.type === LocationType.MAIN) {
+ *   // In main checkout
+ * }
+ */
+export declare const LocationType: {
+    /** Main checkout (not a worktree) */
+    readonly MAIN: "main";
+    /** Inside a worktree */
+    readonly WORKTREE: "worktree";
+    /** Detached HEAD state */
+    readonly DETACHED: "detached";
+    /** Unknown location (not a git repo or error) */
+    readonly UNKNOWN: "unknown";
+};
 /**
  * Schema for location types
  */
@@ -139,7 +161,7 @@ export declare const WuContextSchema: z.ZodObject<{
         errorMessage: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
-export type LocationType = z.infer<typeof LocationTypeSchema>;
+export type LocationType = (typeof LocationType)[keyof typeof LocationType];
 export type LocationContext = z.infer<typeof LocationContextSchema>;
 export type GitState = z.infer<typeof GitStateSchema>;
 export type WuStateResult = z.infer<typeof WuStateResultSchema>;

package/dist/domain/context.schemas.js

@@ -15,6 +15,28 @@ import { z } from 'zod';
  * Mirrors CONTEXT_VALIDATION.LOCATION_TYPES from wu-constants.ts
  */
 export const LOCATION_TYPE_VALUES = ['main', 'worktree', 'detached', 'unknown'];
+/**
+ * LocationType enum for use in code
+ *
+ * Provides named constants for location types to avoid magic string literals.
+ *
+ * @example
+ * import { LocationType } from '@lumenflow/core';
+ *
+ * if (location.type === LocationType.MAIN) {
+ *   // In main checkout
+ * }
+ */
+export const LocationType = {
+    /** Main checkout (not a worktree) */
+    MAIN: 'main',
+    /** Inside a worktree */
+    WORKTREE: 'worktree',
+    /** Detached HEAD state */
+    DETACHED: 'detached',
+    /** Unknown location (not a git repo or error) */
+    UNKNOWN: 'unknown',
+};
 /**
  * Schema for location types
  */

package/dist/domain/index.js

@@ -8,10 +8,12 @@
  * @module domain
  */
 // Context schemas (primary definitions for location, git, wu state)
+// Includes LocationType enum constant
 export * from './context.schemas.js';
 // Validation schemas (excludes re-exports from context.schemas)
 export { VALIDATION_ERROR_CODE_VALUES, ValidationErrorCodeSchema, PREDICATE_SEVERITY_VALUES, PredicateSeveritySchema, ValidationErrorSchema, ValidationWarningSchema, ValidationResultSchema, CommandPredicateConfigSchema, CommandDefinitionConfigSchema, } from './validation.schemas.js';
 // Recovery schemas
+// Includes RecoveryIssueCode and RecoveryActionType enum constants
 export * from './recovery.schemas.js';
 // Orchestration schemas (existing)
 export * from './orchestration.schemas.js';

package/dist/domain/recovery.schemas.d.ts

@@ -15,6 +15,32 @@ import { z } from 'zod';
  * Mirrors CONTEXT_VALIDATION.RECOVERY_ISSUES from wu-constants.ts
  */
 export declare const RECOVERY_ISSUE_CODE_VALUES: readonly ["PARTIAL_CLAIM", "ORPHAN_CLAIM", "INCONSISTENT_STATE", "ORPHAN_BRANCH", "STALE_LOCK", "LEFTOVER_WORKTREE"];
+/**
+ * RecoveryIssueCode enum for use in code
+ *
+ * Provides named constants for recovery issue codes to avoid magic string literals.
+ *
+ * @example
+ * import { RecoveryIssueCode } from '@lumenflow/core';
+ *
+ * if (issue.code === RecoveryIssueCode.PARTIAL_CLAIM) {
+ *   // Handle partial claim issue
+ * }
+ */
+export declare const RecoveryIssueCode: {
+    /** Worktree exists but WU status is "ready" */
+    readonly PARTIAL_CLAIM: "PARTIAL_CLAIM";
+    /** WU is "in_progress" but worktree does not exist */
+    readonly ORPHAN_CLAIM: "ORPHAN_CLAIM";
+    /** YAML status differs from state store */
+    readonly INCONSISTENT_STATE: "INCONSISTENT_STATE";
+    /** Branch exists but worktree does not */
+    readonly ORPHAN_BRANCH: "ORPHAN_BRANCH";
+    /** Lock file from different WU */
+    readonly STALE_LOCK: "STALE_LOCK";
+    /** WU is done but worktree was not cleaned up */
+    readonly LEFTOVER_WORKTREE: "LEFTOVER_WORKTREE";
+};
 /**
  * Schema for recovery issue codes
  */
@@ -32,6 +58,28 @@ export declare const RecoveryIssueCodeSchema: z.ZodEnum<{
  * Mirrors CONTEXT_VALIDATION.RECOVERY_ACTIONS from wu-constants.ts
  */
 export declare const RECOVERY_ACTION_TYPE_VALUES: readonly ["resume", "reset", "nuke", "cleanup"];
+/**
+ * RecoveryActionType enum for use in code
+ *
+ * Provides named constants for recovery action types to avoid magic string literals.
+ *
+ * @example
+ * import { RecoveryActionType } from '@lumenflow/core';
+ *
+ * if (action.type === RecoveryActionType.RESUME) {
+ *   // Resume the WU
+ * }
+ */
+export declare const RecoveryActionType: {
+    /** Reconcile state and continue working (preserves work) */
+    readonly RESUME: "resume";
+    /** Discard worktree, reset WU to ready */
+    readonly RESET: "reset";
+    /** Remove all artifacts completely (requires --force) */
+    readonly NUKE: "nuke";
+    /** Remove leftover worktree (for done WUs) */
+    readonly CLEANUP: "cleanup";
+};
 /**
  * Schema for recovery action types
  */
@@ -108,8 +156,8 @@ export declare const RecoveryAnalysisSchema: z.ZodObject<{
     }, z.core.$strip>>;
     wuId: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
-export type RecoveryIssueCode = z.infer<typeof RecoveryIssueCodeSchema>;
-export type RecoveryActionType = z.infer<typeof RecoveryActionTypeSchema>;
+export type RecoveryIssueCode = (typeof RecoveryIssueCode)[keyof typeof RecoveryIssueCode];
+export type RecoveryActionType = (typeof RecoveryActionType)[keyof typeof RecoveryActionType];
 export type RecoveryIssue = z.infer<typeof RecoveryIssueSchema>;
 export type RecoveryAction = z.infer<typeof RecoveryActionSchema>;
 export type RecoveryAnalysis = z.infer<typeof RecoveryAnalysisSchema>;

package/dist/domain/recovery.schemas.js

@@ -22,6 +22,32 @@ export const RECOVERY_ISSUE_CODE_VALUES = [
     'STALE_LOCK',
     'LEFTOVER_WORKTREE',
 ];
+/**
+ * RecoveryIssueCode enum for use in code
+ *
+ * Provides named constants for recovery issue codes to avoid magic string literals.
+ *
+ * @example
+ * import { RecoveryIssueCode } from '@lumenflow/core';
+ *
+ * if (issue.code === RecoveryIssueCode.PARTIAL_CLAIM) {
+ *   // Handle partial claim issue
+ * }
+ */
+export const RecoveryIssueCode = {
+    /** Worktree exists but WU status is "ready" */
+    PARTIAL_CLAIM: 'PARTIAL_CLAIM',
+    /** WU is "in_progress" but worktree does not exist */
+    ORPHAN_CLAIM: 'ORPHAN_CLAIM',
+    /** YAML status differs from state store */
+    INCONSISTENT_STATE: 'INCONSISTENT_STATE',
+    /** Branch exists but worktree does not */
+    ORPHAN_BRANCH: 'ORPHAN_BRANCH',
+    /** Lock file from different WU */
+    STALE_LOCK: 'STALE_LOCK',
+    /** WU is done but worktree was not cleaned up */
+    LEFTOVER_WORKTREE: 'LEFTOVER_WORKTREE',
+};
 /**
  * Schema for recovery issue codes
  */
@@ -32,6 +58,28 @@ export const RecoveryIssueCodeSchema = z.enum(RECOVERY_ISSUE_CODE_VALUES);
  * Mirrors CONTEXT_VALIDATION.RECOVERY_ACTIONS from wu-constants.ts
  */
 export const RECOVERY_ACTION_TYPE_VALUES = ['resume', 'reset', 'nuke', 'cleanup'];
+/**
+ * RecoveryActionType enum for use in code
+ *
+ * Provides named constants for recovery action types to avoid magic string literals.
+ *
+ * @example
+ * import { RecoveryActionType } from '@lumenflow/core';
+ *
+ * if (action.type === RecoveryActionType.RESUME) {
+ *   // Resume the WU
+ * }
+ */
+export const RecoveryActionType = {
+    /** Reconcile state and continue working (preserves work) */
+    RESUME: 'resume',
+    /** Discard worktree, reset WU to ready */
+    RESET: 'reset',
+    /** Remove all artifacts completely (requires --force) */
+    NUKE: 'nuke',
+    /** Remove leftover worktree (for done WUs) */
+    CLEANUP: 'cleanup',
+};
 /**
  * Schema for recovery action types
  */

package/dist/gates-config.js

@@ -98,6 +98,25 @@ export const GATE_PRESETS = {
         lint: 'dotnet build --no-restore -warnaserror',
         test: 'dotnet test --no-restore',
     },
+    // WU-1118: Java/JVM, Ruby, and PHP presets
+    java: {
+        format: 'mvn spotless:check || ./gradlew spotlessCheck',
+        lint: 'mvn checkstyle:check || ./gradlew checkstyleMain',
+        typecheck: 'mvn compile -DskipTests || ./gradlew compileJava',
+        test: 'mvn test || ./gradlew test',
+    },
+    ruby: {
+        setup: 'bundle install',
+        format: 'bundle exec rubocop --format simple --fail-level W',
+        lint: 'bundle exec rubocop',
+        test: 'bundle exec rspec',
+    },
+    php: {
+        setup: 'composer install',
+        format: 'vendor/bin/php-cs-fixer fix --dry-run --diff',
+        lint: 'vendor/bin/phpstan analyse',
+        test: 'vendor/bin/phpunit',
+    },
 };
 /**
  * Parse a gate command configuration into executable form

package/dist/index.d.ts

@@ -54,7 +54,9 @@ export * from './validation/index.js';
 export * from './recovery/index.js';
 export * from './context-validation-integration.js';
 export { CONTEXT_VALIDATION } from './wu-constants.js';
-export type { LocationType, ValidationErrorCode, RecoveryActionType, RecoveryIssueCode, PredicateSeverity, ValidationMode, } from './wu-constants.js';
+export type { ValidationErrorCode, PredicateSeverity, ValidationMode } 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';
 export type { ICommandRegistry } from './ports/validation.ports.js';
 export type { IRecoveryAnalyzer } from './ports/recovery.ports.js';

package/dist/index.js

@@ -84,6 +84,11 @@ export * from './recovery/index.js';
 export * from './context-validation-integration.js';
 // WU-1090: Context validation constants
 export { CONTEXT_VALIDATION } 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
+export { LocationType } from './domain/context.schemas.js';
+export { RecoveryIssueCode, RecoveryActionType } from './domain/recovery.schemas.js';
 // WU-1093: Domain schemas for context-aware validation (Zod schemas)
 // Note: Types like LocationContext, GitState are already exported from context/index.js
 // so we only export the Zod schemas, not the inferred types.

package/package.json

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