@higher.archi/boe 1.0.30 → 1.0.31

package/src/engines/state-machine/types.ts

@@ -17,6 +17,14 @@ import {
  * Action to execute on state entry, exit, or during transition.
  * Uses the same familiar syntax as forward chaining actions.
  */
+export const ActionTypes = {
+  set: 'set',
+  emit: 'emit',
+  call: 'call',
+  log: 'log',
+} as const;
+export type ActionType = typeof ActionTypes[keyof typeof ActionTypes];
+
 export type StateMachineActionItem =
   | { set: Record<string, any> }           // Set context properties: { set: { paidAt: '$now' } }
   | { emit: string; data?: Record<string, any> }  // Emit event: { emit: 'OrderPaid', data: { orderId: '$context.orderId' } }

package/src/engines/utility/index.ts

@@ -14,6 +14,8 @@
 export type {
   // Semantic priority types
   SemanticPriority,
+  NormalizationMethod,
+  UtilityAggregation,
   // Criterion types
   UtilityCriterion,
   CompiledUtilityCriterion,
@@ -33,6 +35,9 @@ export type {
 
 // Semantic priority utilities
 export {
+  SemanticPriorities,
+  NormalizationMethods,
+  UtilityAggregations,
   SEMANTIC_PRIORITY_VALUES,
   isSemanticPriority
 } from './types';

package/src/engines/utility/types.ts

@@ -33,7 +33,14 @@ import {
  * }
  * ```
  */
-export type SemanticPriority = 'critical' | 'high' | 'medium' | 'low' | 'not-important';
+export const SemanticPriorities = {
+  critical: 'critical',
+  high: 'high',
+  medium: 'medium',
+  low: 'low',
+  notImportant: 'not-important',
+} as const;
+export type SemanticPriority = typeof SemanticPriorities[keyof typeof SemanticPriorities];
 
 /**
  * Base numeric values for semantic priorities (before normalization).
@@ -133,10 +140,23 @@ export type UtilityRule = BaseRule & {
 /**
  * Utility ruleset configuration
  */
+export const NormalizationMethods = {
+  minMax: 'min-max',
+  zScore: 'z-score',
+  none: 'none',
+} as const;
+export type NormalizationMethod = typeof NormalizationMethods[keyof typeof NormalizationMethods];
+
+export const UtilityAggregations = {
+  weightedSum: 'weighted-sum',
+  weightedProduct: 'weighted-product',
+} as const;
+export type UtilityAggregation = typeof UtilityAggregations[keyof typeof UtilityAggregations];
+
 export type UtilityConfig = {
   mode: 'utility';
-  normalization: 'min-max' | 'z-score' | 'none';
-  aggregation: 'weighted-sum' | 'weighted-product';
+  normalization: NormalizationMethod;
+  aggregation: UtilityAggregation;
 };
 
 /**

package/src/index.ts

@@ -35,6 +35,8 @@ export { SentimentEngine } from './engines/sentiment';
 export { NegotiationEngine } from './engines/negotiation';
 export { DecayEngine } from './engines/decay';
 export { LoyaltyEngine } from './engines/loyalty';
+export { MenuEngineeringEngine } from './engines/menu-engineering';
+export { RecipeCostingEngine } from './engines/recipe-costing';
 
 // ========================================
 // Core Types & Utilities
@@ -87,7 +89,8 @@ export {
   ScoringStrategy,
   compileScoringRuleSet,
   scoringStrategy,
-  createScoreFunction
+  createScoreFunction,
+  ScoringMethods
 } from './engines/scoring';
 export type {
   ScoringRule,
@@ -166,6 +169,7 @@ export {
   compileBayesianRule,
   bayesianStrategy,
   parseLikelihood,
+  SemanticLikelihoods,
   SEMANTIC_LIKELIHOODS
 } from './engines/bayesian';
 export type {
@@ -189,7 +193,8 @@ export type {
 export {
   MonteCarloStrategy,
   compileMonteCarloRuleSet,
-  monteCarloStrategy
+  monteCarloStrategy,
+  EstimateTypes
 } from './engines/monte-carlo';
 export type {
   MonteCarloVariable,
@@ -207,9 +212,11 @@ export {
   StateMachineStrategy,
   compileStateMachine,
   compileStateMachineDefinition,
-  stateMachineStrategy
+  stateMachineStrategy,
+  ActionTypes
 } from './engines/state-machine';
 export type {
+  ActionType,
   StateMachineDefinition,
   StateMachineConfig,
   StateDefinition,
@@ -232,6 +239,10 @@ export type {
   Preference,
   PreferenceWeight,
   SemanticWeight,
+  ConstraintStrategyType,
+  VariableOrdering,
+  ValueOrdering,
+  OptimizeMode,
   ConstraintRuleSet,
   ConstraintConfig,
   CompiledConstraintRuleSet,
@@ -241,17 +252,29 @@ export type {
   ConstraintAllResult,
   ScoredSolution
 } from './engines/constraint';
-export { SEMANTIC_WEIGHTS } from './engines/constraint';
+export {
+  SEMANTIC_WEIGHTS,
+  SemanticConstraintWeights,
+  ConstraintStrategies,
+  VariableOrderings,
+  ValueOrderings,
+  OptimizeModes
+} from './engines/constraint';
 
 // Utility/MCDM
 export {
   UtilityStrategy,
   compileUtilityRuleSet,
   compileUtilityRule,
-  utilityStrategy
+  utilityStrategy,
+  SemanticPriorities,
+  NormalizationMethods,
+  UtilityAggregations
 } from './engines/utility';
 export type {
   UtilityCriterion,
+  NormalizationMethod,
+  UtilityAggregation,
   UtilityRule,
   UtilityRuleSet,
   UtilityConfig,
@@ -269,9 +292,16 @@ export type {
 // Defeasible
 export {
   DefeasibleEngine,
-  compileDefeasibleRuleSet
+  compileDefeasibleRuleSet,
+  RuleStrengths,
+  ConclusionStatuses,
+  SemanticDefeatStrengths,
+  SemanticCredibilityLevels,
+  DefeasibleAggregations,
+  ConflictResolutions
 } from './engines/defeasible';
 export type {
+  ConflictResolution,
   DefeasibleRule,
   DefeasibleRuleSet,
   DefeasibleConfig,
@@ -286,6 +316,7 @@ export {
   ExpertStrategy,
   compileExpertRuleSet,
   expertStrategy,
+  SemanticConfidences,
   compileTemplate,
   interpolate,
   hasInterpolation,
@@ -329,6 +360,9 @@ export {
   round,
   calculateDiscount,
   applyMinMax,
+  // Constants
+  PricingModeNames,
+  MetricFormats,
   // Currency utilities
   CURRENCIES,
   getCurrencyInfo
@@ -337,6 +371,8 @@ export type {
   // Currency types
   CurrencyCode,
   CurrencyInfo,
+  PricingModeName,
+  MetricFormat,
   // Rule types
   PricingRule,
   PricingRuleSet,
@@ -390,6 +426,8 @@ export {
   compileEnsembleRuleSet,
   ensembleStrategy,
   summarizeEnsemble,
+  FusionStrategies,
+  AgreementLevels,
   bayesianMember, fuzzyMember, monteCarloMember, expertMember, scoringMember
 } from './engines/ensemble';
 export type {
@@ -419,6 +457,11 @@ export {
   RankingExecutor,
   compileRankingRuleSet,
   rankingStrategy,
+  RankingStrategies,
+  RankingDirections,
+  PercentileLabels,
+  Movements,
+  KFactorPresets,
   K_FACTOR_VALUES,
   isKFactorPreset,
   resolvePercentileLabel,
@@ -455,6 +498,11 @@ export {
   PredictionExecutor,
   compilePredictionRuleSet,
   predictionStrategy,
+  PredictionStrategies,
+  TrendDirections,
+  SmoothingPresets,
+  HorizonPresets,
+  ConfidenceBrackets,
   SMOOTHING_PRESET_VALUES,
   HORIZON_PRESET_VALUES,
   isSmoothingPreset,
@@ -493,6 +541,8 @@ export {
   SentimentExecutor,
   compileSentimentRuleSet,
   sentimentStrategy,
+  SentimentStrategies,
+  SentimentLabels,
   SENTIMENT_DEFAULTS,
   resolveSentimentLabel
 } from './engines/sentiment';
@@ -523,7 +573,11 @@ export type {
 export {
   NegotiationExecutor,
   compileNegotiationRuleSet,
-  negotiationStrategy
+  negotiationStrategy,
+  NegotiationStrategies,
+  ConcessionStyles,
+  DealOutcomes,
+  DimensionDirections
 } from './engines/negotiation';
 export type {
   NegotiationStrategy,
@@ -559,6 +613,10 @@ export {
   DecayExecutor,
   compileDecayRuleSet,
   decayStrategy,
+  DecayStrategies,
+  UrgencyTiers,
+  ReEngagementEffects,
+  DecayAggregations,
   URGENCY_THRESHOLDS,
   resolveUrgencyTier
 } from './engines/decay';
@@ -590,7 +648,12 @@ export type {
 export {
   LoyaltyExecutor,
   compileLoyaltyRuleSet,
-  loyaltyStrategy
+  loyaltyStrategy,
+  LoyaltyStrategies,
+  PointTransactionTypes,
+  TierStatuses,
+  QualifyingMetrics,
+  EvaluationPeriods
 } from './engines/loyalty';
 export type {
   LoyaltyStrategy,
@@ -622,6 +685,79 @@ export type {
   LoyaltyIngestResult
 } from './engines/loyalty';
 
+// Menu Engineering
+export {
+  MenuEngineeringExecutor,
+  compileMenuEngineeringRuleSet,
+  menuEngineeringStrategy,
+  MenuEngineeringStrategies,
+  MenuClassifications
+} from './engines/menu-engineering';
+export type {
+  MenuEngineeringStrategy,
+  MenuClassification,
+  MenuItem,
+  PriceElasticity,
+  PriceChange,
+  ClassifyConfig,
+  PriceOptimizationConfig,
+  MixAnalysisConfig,
+  ClassifyRuleSet,
+  PriceOptimizationRuleSet,
+  MixAnalysisRuleSet,
+  MenuEngineeringRuleSet,
+  CompiledClassifyRuleSet,
+  CompiledPriceOptimizationRuleSet,
+  CompiledMixAnalysisRuleSet,
+  CompiledMenuEngineeringRuleSet,
+  ClassifiedItem,
+  MenuSummary,
+  PriceOptimizationItem,
+  CategoryMixResult,
+  ClassifyResult,
+  PriceOptimizationResult,
+  MixAnalysisResult,
+  MenuEngineeringResult,
+  MenuEngineeringOptions
+} from './engines/menu-engineering';
+
+// Recipe Costing
+export {
+  RecipeCostingExecutor,
+  compileRecipeCostingRuleSet,
+  recipeCostingStrategy,
+  RecipeCostingStrategies,
+  MeasurementUnits
+} from './engines/recipe-costing';
+export type {
+  RecipeCostingStrategy,
+  MeasurementUnit,
+  Ingredient,
+  RecipeComponent,
+  Recipe,
+  CostChange,
+  PlateCostConfig,
+  MarginAnalysisConfig,
+  CostImpactConfig,
+  PlateCostRuleSet,
+  MarginAnalysisRuleSet,
+  CostImpactRuleSet,
+  RecipeCostingRuleSet,
+  CompiledPlateCostRuleSet,
+  CompiledMarginAnalysisRuleSet,
+  CompiledCostImpactRuleSet,
+  CompiledRecipeCostingRuleSet,
+  IngredientCostBreakdown,
+  SubRecipeCostBreakdown,
+  RecipeCostResult,
+  CostImpactItem,
+  PlateCostResult,
+  MarginAnalysisResult as RecipeMarginAnalysisResult,
+  CostImpactResult,
+  RecipeCostingResult,
+  RecipeCostingOptions
+} from './engines/recipe-costing';
+
 // ========================================
 // Utility Functions (from old modules, re-exported for convenience)
 // ========================================
@@ -634,6 +770,8 @@ export type { ErrorContext } from './core/errors';
 
 // Temporal Decay (re-exported from core for convenience)
 export {
+  DecayCurves,
+  DecayTimeUnits,
   calculateDecayMultiplier,
   resolveDecayTimestamp
 } from './core/evaluation/decay';