@higher.archi/boe 1.0.25 → 1.0.27

package/dist/index.js

@@ -29,9 +29,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UtilityStrategy = exports.SEMANTIC_WEIGHTS = exports.constraintStrategy = exports.compileConstraintRuleSet = exports.ConstraintStrategy = exports.stateMachineStrategy = exports.compileStateMachineDefinition = exports.compileStateMachine = exports.StateMachineStrategy = exports.monteCarloStrategy = exports.compileMonteCarloRuleSet = exports.MonteCarloStrategy = exports.SEMANTIC_LIKELIHOODS = exports.parseLikelihood = exports.bayesianStrategy = exports.compileBayesianRule = exports.compileBayesianRuleSet = exports.BayesianStrategy = exports.autoAdjustCoverage = exports.analyzeCoverage = exports.compileFuzzyVariable = exports.fuzzyStrategy = exports.compileFuzzyRuleSet = exports.FuzzyStrategy = exports.sequentialStrategy = exports.compileSequentialRuleSet = exports.SequentialStrategy = exports.createScoreFunction = exports.scoringStrategy = exports.compileScoringRuleSet = exports.ScoringStrategy = exports.backwardStrategy = exports.compileBackwardRuleSet = exports.BackwardChainingStrategy = exports.forwardStrategy = exports.compileForwardRule = exports.compileForwardRuleSet = exports.ForwardChainingStrategy = exports.EnsembleEngine = exports.PricingEngine = exports.UtilityEngine = exports.ConstraintEngine = exports.StateMachineEngine = exports.MonteCarloEngine = exports.BayesianEngine = exports.FuzzyEngine = exports.SequentialEngine = exports.ScoringEngine = exports.BackwardEngine = exports.ForwardEngine = void 0;
-exports.predictionStrategy = exports.compilePredictionRuleSet = exports.PredictionExecutor = exports.PredictionEngine = exports.resolveMovement = exports.resolvePercentileLabel = exports.isKFactorPreset = exports.K_FACTOR_VALUES = exports.rankingStrategy = exports.compileRankingRuleSet = exports.RankingExecutor = exports.RankingEngine = exports.scoringMember = exports.expertMember = exports.monteCarloMember = exports.fuzzyMember = exports.bayesianMember = exports.summarizeEnsemble = exports.ensembleStrategy = exports.compileEnsembleRuleSet = exports.EnsembleStrategy = exports.getCurrencyInfo = exports.CURRENCIES = exports.applyMinMax = exports.calculateDiscount = exports.round = exports.formatPercent = exports.formatNumber = exports.formatCurrency = exports.calculateVolume = exports.calculateGraduated = exports.calculateFlat = exports.pricingEngine = exports.pricingStrategy = exports.compilePricingRule = exports.compilePricingRuleSet = exports.PricingStrategy = exports.buildAvailableRefs = exports.hasInterpolation = exports.interpolate = exports.compileTemplate = exports.expertStrategy = exports.compileExpertRuleSet = exports.ExpertStrategy = exports.ExpertEngine = exports.compileDefeasibleRuleSet = exports.DefeasibleEngine = exports.utilityStrategy = exports.compileUtilityRule = exports.compileUtilityRuleSet = void 0;
-exports.resolveDecayTimestamp = exports.calculateDecayMultiplier = exports.RuntimeError = exports.CompilationError = exports.BOEError = exports.cosineSimilarity = exports.caverphone2 = exports.nysiis = exports.soundex = exports.resolveTrendDirection = exports.resolveConfidenceBracket = exports.isHorizonPreset = exports.isSmoothingPreset = exports.HORIZON_PRESET_VALUES = exports.SMOOTHING_PRESET_VALUES = void 0;
+exports.SEMANTIC_WEIGHTS = exports.constraintStrategy = exports.compileConstraintRuleSet = exports.ConstraintStrategy = exports.stateMachineStrategy = exports.compileStateMachineDefinition = exports.compileStateMachine = exports.StateMachineStrategy = exports.monteCarloStrategy = exports.compileMonteCarloRuleSet = exports.MonteCarloStrategy = exports.SEMANTIC_LIKELIHOODS = exports.parseLikelihood = exports.bayesianStrategy = exports.compileBayesianRule = exports.compileBayesianRuleSet = exports.BayesianStrategy = exports.autoAdjustCoverage = exports.analyzeCoverage = exports.compileFuzzyVariable = exports.fuzzyStrategy = exports.compileFuzzyRuleSet = exports.FuzzyStrategy = exports.sequentialStrategy = exports.compileSequentialRuleSet = exports.SequentialStrategy = exports.createScoreFunction = exports.scoringStrategy = exports.compileScoringRuleSet = exports.ScoringStrategy = exports.backwardStrategy = exports.compileBackwardRuleSet = exports.BackwardChainingStrategy = exports.forwardStrategy = exports.compileForwardRule = exports.compileForwardRuleSet = exports.ForwardChainingStrategy = exports.SentimentEngine = exports.EnsembleEngine = exports.PricingEngine = exports.UtilityEngine = exports.ConstraintEngine = exports.StateMachineEngine = exports.MonteCarloEngine = exports.BayesianEngine = exports.FuzzyEngine = exports.SequentialEngine = exports.ScoringEngine = exports.BackwardEngine = exports.ForwardEngine = void 0;
+exports.compilePredictionRuleSet = exports.PredictionExecutor = exports.PredictionEngine = exports.resolveMovement = exports.resolvePercentileLabel = exports.isKFactorPreset = exports.K_FACTOR_VALUES = exports.rankingStrategy = exports.compileRankingRuleSet = exports.RankingExecutor = exports.RankingEngine = exports.scoringMember = exports.expertMember = exports.monteCarloMember = exports.fuzzyMember = exports.bayesianMember = exports.summarizeEnsemble = exports.ensembleStrategy = exports.compileEnsembleRuleSet = exports.EnsembleStrategy = exports.getCurrencyInfo = exports.CURRENCIES = exports.applyMinMax = exports.calculateDiscount = exports.round = exports.formatPercent = exports.formatNumber = exports.formatCurrency = exports.calculateVolume = exports.calculateGraduated = exports.calculateFlat = exports.pricingEngine = exports.pricingStrategy = exports.compilePricingRule = exports.compilePricingRuleSet = exports.PricingStrategy = exports.buildAvailableRefs = exports.hasInterpolation = exports.interpolate = exports.compileTemplate = exports.expertStrategy = exports.compileExpertRuleSet = exports.ExpertStrategy = exports.ExpertEngine = exports.compileDefeasibleRuleSet = exports.DefeasibleEngine = exports.utilityStrategy = exports.compileUtilityRule = exports.compileUtilityRuleSet = exports.UtilityStrategy = void 0;
+exports.resolveDecayTimestamp = exports.calculateDecayMultiplier = exports.RuntimeError = exports.CompilationError = exports.BOEError = exports.cosineSimilarity = exports.caverphone2 = exports.nysiis = exports.soundex = exports.resolveSentimentLabel = exports.SENTIMENT_DEFAULTS = exports.sentimentStrategy = exports.compileSentimentRuleSet = exports.SentimentExecutor = exports.resolveTrendDirection = exports.resolveConfidenceBracket = exports.isHorizonPreset = exports.isSmoothingPreset = exports.HORIZON_PRESET_VALUES = exports.SMOOTHING_PRESET_VALUES = exports.predictionStrategy = void 0;
 // ========================================
 // Engines
 // ========================================
@@ -60,6 +60,8 @@ var pricing_1 = require("./engines/pricing");
 Object.defineProperty(exports, "PricingEngine", { enumerable: true, get: function () { return pricing_1.PricingEngine; } });
 var ensemble_1 = require("./engines/ensemble");
 Object.defineProperty(exports, "EnsembleEngine", { enumerable: true, get: function () { return ensemble_1.EnsembleEngine; } });
+var sentiment_1 = require("./engines/sentiment");
+Object.defineProperty(exports, "SentimentEngine", { enumerable: true, get: function () { return sentiment_1.SentimentEngine; } });
 // ========================================
 // Core Types & Utilities
 // ========================================
@@ -198,6 +200,13 @@ Object.defineProperty(exports, "isSmoothingPreset", { enumerable: true, get: fun
 Object.defineProperty(exports, "isHorizonPreset", { enumerable: true, get: function () { return prediction_1.isHorizonPreset; } });
 Object.defineProperty(exports, "resolveConfidenceBracket", { enumerable: true, get: function () { return prediction_1.resolveConfidenceBracket; } });
 Object.defineProperty(exports, "resolveTrendDirection", { enumerable: true, get: function () { return prediction_1.resolveTrendDirection; } });
+// Sentiment
+var sentiment_2 = require("./engines/sentiment");
+Object.defineProperty(exports, "SentimentExecutor", { enumerable: true, get: function () { return sentiment_2.SentimentExecutor; } });
+Object.defineProperty(exports, "compileSentimentRuleSet", { enumerable: true, get: function () { return sentiment_2.compileSentimentRuleSet; } });
+Object.defineProperty(exports, "sentimentStrategy", { enumerable: true, get: function () { return sentiment_2.sentimentStrategy; } });
+Object.defineProperty(exports, "SENTIMENT_DEFAULTS", { enumerable: true, get: function () { return sentiment_2.SENTIMENT_DEFAULTS; } });
+Object.defineProperty(exports, "resolveSentimentLabel", { enumerable: true, get: function () { return sentiment_2.resolveSentimentLabel; } });
 // ========================================
 // Utility Functions (from old modules, re-exported for convenience)
 // ========================================

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@higher.archi/boe",
-  "version": "1.0.25",
+  "version": "1.0.27",
   "description": "A multi-strategy rule engine supporting forward chaining, backward chaining, scoring, sequential, fuzzy logic, and Bayesian inference",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/engines/sentiment/compiler.ts

@@ -0,0 +1,138 @@
+/**
+ * Sentiment Engine Compiler
+ *
+ * Validates sentiment rulesets, normalizes lexicon keys to lowercase,
+ * and resolves config defaults.
+ */
+
+import { CompilationError } from '../../core/errors';
+
+import type {
+  SentimentRuleSet,
+  CompiledSentimentRuleSet,
+  CompiledSentimentLexicon,
+  CompiledTokenLevelSentimentRuleSet,
+  CompiledDocumentLevelSentimentRuleSet,
+  CompiledAspectBasedSentimentRuleSet
+} from './types';
+import { SENTIMENT_DEFAULTS } from './types';
+
+/**
+ * Compile and validate a sentiment ruleset.
+ */
+export function compileSentimentRuleSet(
+  ruleSet: SentimentRuleSet
+): CompiledSentimentRuleSet {
+  if (!ruleSet.id) {
+    throw new CompilationError('Sentiment ruleset requires an id');
+  }
+
+  if (ruleSet.mode !== 'sentiment') {
+    throw new CompilationError(`Expected mode 'sentiment', got '${ruleSet.mode}'`);
+  }
+
+  if (!ruleSet.lexiconConfig || !ruleSet.lexiconConfig.lexicon) {
+    throw new CompilationError('Sentiment ruleset requires a lexiconConfig with a lexicon');
+  }
+
+  const lexiconKeys = Object.keys(ruleSet.lexiconConfig.lexicon);
+  if (lexiconKeys.length === 0) {
+    throw new CompilationError('Lexicon must contain at least one entry');
+  }
+
+  // Compile the lexicon
+  const lexicon = compileLexicon(ruleSet.lexiconConfig);
+
+  // Resolve config defaults
+  const config = {
+    capsBoost: ruleSet.config?.capsBoost ?? SENTIMENT_DEFAULTS.capsBoost,
+    exclamationBoost: ruleSet.config?.exclamationBoost ?? SENTIMENT_DEFAULTS.exclamationBoost,
+    negationWindow: ruleSet.config?.negationWindow ?? SENTIMENT_DEFAULTS.negationWindow
+  };
+
+  switch (ruleSet.strategy) {
+    case 'token-level':
+      return {
+        id: ruleSet.id,
+        name: ruleSet.name,
+        mode: 'sentiment',
+        strategy: 'token-level',
+        lexicon,
+        config
+      } satisfies CompiledTokenLevelSentimentRuleSet;
+
+    case 'document-level': {
+      const pattern = ruleSet.sentenceSplitPattern ?? '[.!?]+';
+      return {
+        id: ruleSet.id,
+        name: ruleSet.name,
+        mode: 'sentiment',
+        strategy: 'document-level',
+        lexicon,
+        config,
+        sentenceSplitPattern: new RegExp(pattern)
+      } satisfies CompiledDocumentLevelSentimentRuleSet;
+    }
+
+    case 'aspect-based': {
+      if (!ruleSet.aspects || ruleSet.aspects.length === 0) {
+        throw new CompilationError('Aspect-based strategy requires at least one aspect');
+      }
+      const aspects = ruleSet.aspects.map(a => a.toLowerCase());
+      return {
+        id: ruleSet.id,
+        name: ruleSet.name,
+        mode: 'sentiment',
+        strategy: 'aspect-based',
+        lexicon,
+        config,
+        aspects
+      } satisfies CompiledAspectBasedSentimentRuleSet;
+    }
+
+    default:
+      throw new CompilationError(`Unknown sentiment strategy: '${(ruleSet as any).strategy}'`);
+  }
+}
+
+function compileLexicon(
+  input: { lexicon: Record<string, number>; boosters?: Record<string, number>; negation?: string[]; idioms?: Record<string, number> }
+): CompiledSentimentLexicon {
+  // Normalize all keys to lowercase
+  const lexicon: Record<string, number> = {};
+  for (const [key, value] of Object.entries(input.lexicon)) {
+    lexicon[key.toLowerCase()] = value;
+  }
+
+  const boosters: Record<string, number> = {};
+  if (input.boosters) {
+    for (const [key, value] of Object.entries(input.boosters)) {
+      boosters[key.toLowerCase()] = value;
+    }
+  }
+
+  const negation = new Set<string>(
+    (input.negation ?? []).map(w => w.toLowerCase())
+  );
+
+  const idioms: Record<string, number> = {};
+  let idiomMaxLength = 0;
+  if (input.idioms) {
+    for (const [key, value] of Object.entries(input.idioms)) {
+      const normalized = key.toLowerCase();
+      idioms[normalized] = value;
+      const wordCount = normalized.split(/\s+/).length;
+      if (wordCount > idiomMaxLength) {
+        idiomMaxLength = wordCount;
+      }
+    }
+  }
+
+  return {
+    lexicon,
+    boosters,
+    negation,
+    idioms,
+    _idiomMaxLength: idiomMaxLength
+  };
+}

package/src/engines/sentiment/engine.ts

@@ -0,0 +1,274 @@
+/**
+ * Sentiment Engine
+ *
+ * Text sentiment analysis engine that scores text using dictionary-lookup
+ * and heuristic rules. Supports token-level, document-level, and aspect-based
+ * analysis strategies with injectable lexicon configuration.
+ *
+ * @example
+ * ```typescript
+ * const engine = new SentimentEngine();
+ * engine.add({ type: 'Review', data: { text: 'The product is absolutely fantastic!' } });
+ *
+ * const result = engine.execute(compiledRuleset);
+ * console.log(result.compound); // 0.85 (positive)
+ * ```
+ */
+
+import {
+  WorkingMemory,
+  Fact,
+  FactInput,
+  FactChange
+} from '../../core';
+
+import type {
+  CompiledSentimentRuleSet,
+  SentimentOptions,
+  SentimentResult,
+  SentimentStrategy,
+  IngestResult,
+  AspectResult
+} from './types';
+import { resolveSentimentLabel } from './types';
+
+import { SentimentExecutor } from './strategy';
+
+function round(value: number, decimals: number): number {
+  const factor = Math.pow(10, decimals);
+  return Math.round(value * factor) / factor;
+}
+
+/** Internal accumulator for streaming ingest */
+type StreamState = {
+  ruleSetId: string;
+  strategy: SentimentStrategy;
+  compoundSum: number;
+  count: number;
+  posTokens: number;
+  negTokens: number;
+  neuTokens: number;
+  totalTokens: number;
+  /** Per-aspect accumulators (aspect-based only) */
+  aspectAccumulators: Map<string, { compoundSum: number; count: number }>;
+  /** Last computed aggregate result (without item-specific fields) */
+  lastResult: SentimentResult | null;
+};
+
+export class SentimentEngine {
+  private wm: WorkingMemory;
+  private strategy: SentimentExecutor;
+  private _stream: StreamState | null = null;
+
+  constructor(workingMemory?: WorkingMemory) {
+    this.wm = workingMemory ?? new WorkingMemory();
+    this.strategy = new SentimentExecutor();
+  }
+
+  // ========================================
+  // IWorkingMemory Implementation
+  // ========================================
+
+  add<T = Record<string, any>>(input: FactInput<T>): Fact<T> {
+    return this.wm.add(input);
+  }
+
+  remove(factId: string): Fact | undefined {
+    return this.wm.remove(factId);
+  }
+
+  update<T = Record<string, any>>(input: FactInput<T>): Fact<T> {
+    return this.wm.update(input);
+  }
+
+  get(factId: string): Fact | undefined {
+    return this.wm.get(factId);
+  }
+
+  getByType(type: string): Fact[] {
+    return this.wm.getByType(type);
+  }
+
+  getAll(): Fact[] {
+    return this.wm.getAll();
+  }
+
+  has(factId: string): boolean {
+    return this.wm.has(factId);
+  }
+
+  size(): number {
+    return this.wm.size();
+  }
+
+  clear(): void {
+    this.wm.clear();
+  }
+
+  getChanges(): FactChange[] {
+    return this.wm.getChanges();
+  }
+
+  clearChanges(): void {
+    this.wm.clearChanges();
+  }
+
+  // ========================================
+  // Engine Execution
+  // ========================================
+
+  /**
+   * Execute a sentiment analysis ruleset.
+   *
+   * Extracts text from all facts in working memory, applies the configured
+   * sentiment strategy, and returns compound scores with token-level detail.
+   *
+   * @param ruleSet - Compiled sentiment ruleset
+   * @param options - Runtime options (onToken callback)
+   * @returns Sentiment result with compound score, label, and detail
+   */
+  execute(
+    ruleSet: CompiledSentimentRuleSet,
+    options: SentimentOptions = {}
+  ): SentimentResult {
+    return this.strategy.run(ruleSet, this.wm, options);
+  }
+
+  // ========================================
+  // Streaming Ingest
+  // ========================================
+
+  /**
+   * Score a single text incrementally without touching working memory.
+   *
+   * Each call scores the provided text, updates a running accumulator,
+   * and returns both the individual score and the current aggregate.
+   * The compiled ruleset must stay the same across calls (matched by id).
+   * Call `resetStream()` to start a new stream.
+   *
+   * @param text - Raw text to score
+   * @param ruleSet - Compiled sentiment ruleset
+   * @param options - Runtime options (onToken callback)
+   * @returns IngestResult with item-level and aggregate scores
+   */
+  ingest(
+    text: string,
+    ruleSet: CompiledSentimentRuleSet,
+    options: SentimentOptions = {}
+  ): IngestResult {
+    // Initialize or validate stream state
+    if (!this._stream || this._stream.ruleSetId !== ruleSet.id) {
+      this._stream = {
+        ruleSetId: ruleSet.id,
+        strategy: ruleSet.strategy,
+        compoundSum: 0,
+        count: 0,
+        posTokens: 0,
+        negTokens: 0,
+        neuTokens: 0,
+        totalTokens: 0,
+        aspectAccumulators: new Map(),
+        lastResult: null
+      };
+    }
+
+    // Score just this text
+    const itemResult = this.strategy.scoreText(ruleSet, text, options);
+
+    // Update running accumulators
+    const s = this._stream;
+    s.compoundSum += itemResult.compound;
+    s.count++;
+
+    // Update token proportion accumulators
+    const itemTokenTotal = itemResult.tokens?.length
+      ?? itemResult.sentences?.reduce((n, sent) => n + sent.tokens.length, 0)
+      ?? itemResult.aspects?.reduce((n, a) => n + a.sentences.reduce((m, sent) => m + sent.tokens.length, 0), 0)
+      ?? 0;
+
+    if (itemTokenTotal > 0) {
+      s.posTokens += Math.round(itemResult.positive * itemTokenTotal);
+      s.negTokens += Math.round(itemResult.negative * itemTokenTotal);
+      s.neuTokens += Math.round(itemResult.neutral * itemTokenTotal);
+      s.totalTokens += itemTokenTotal;
+    }
+
+    // Update aspect accumulators if aspect-based
+    if (itemResult.aspects) {
+      for (const aspect of itemResult.aspects) {
+        if (aspect.sentences.length === 0) continue;
+        let acc = s.aspectAccumulators.get(aspect.aspect);
+        if (!acc) {
+          acc = { compoundSum: 0, count: 0 };
+          s.aspectAccumulators.set(aspect.aspect, acc);
+        }
+        acc.compoundSum += aspect.compound;
+        acc.count++;
+      }
+    }
+
+    // Compute aggregate
+    const aggCompound = round(s.compoundSum / s.count, 4);
+    const aggPositive = s.totalTokens > 0 ? round(s.posTokens / s.totalTokens, 4) : 0;
+    const aggNegative = s.totalTokens > 0 ? round(s.negTokens / s.totalTokens, 4) : 0;
+    const aggNeutral = s.totalTokens > 0 ? round(s.neuTokens / s.totalTokens, 4) : 0;
+
+    // Build aggregate aspect results if applicable
+    let aggAspects: AspectResult[] | undefined;
+    if (s.aspectAccumulators.size > 0) {
+      aggAspects = [];
+      for (const [aspect, acc] of s.aspectAccumulators) {
+        const aspectCompound = round(acc.compoundSum / acc.count, 4);
+        aggAspects.push({
+          aspect,
+          compound: aspectCompound,
+          label: resolveSentimentLabel(aspectCompound),
+          sentences: []
+        });
+      }
+    }
+
+    const aggregate: SentimentResult = {
+      compound: aggCompound,
+      label: resolveSentimentLabel(aggCompound),
+      positive: aggPositive,
+      negative: aggNegative,
+      neutral: aggNeutral,
+      aspects: aggAspects,
+      strategy: ruleSet.strategy,
+      executionTimeMs: itemResult.executionTimeMs
+    };
+
+    s.lastResult = aggregate;
+
+    return {
+      ...aggregate,
+      itemCompound: itemResult.compound,
+      itemLabel: itemResult.label,
+      totalIngested: s.count
+    };
+  }
+
+  /**
+   * Get the current streaming aggregate without ingesting new text.
+   * Returns null if no texts have been ingested yet.
+   */
+  getStreamResult(): SentimentResult | null {
+    return this._stream?.lastResult ?? null;
+  }
+
+  /**
+   * Reset the streaming accumulator. Does not affect working memory.
+   */
+  resetStream(): void {
+    this._stream = null;
+  }
+
+  // ========================================
+  // Utility Methods
+  // ========================================
+
+  getWorkingMemory(): WorkingMemory {
+    return this.wm;
+  }
+}

package/src/engines/sentiment/index.ts

@@ -0,0 +1,42 @@
+/**
+ * Sentiment Engine -- Text Sentiment Analysis
+ */
+
+// Types
+export type {
+  SentimentStrategy,
+  SentimentLabel,
+  SentimentLexicon,
+  CompiledSentimentLexicon,
+  SentimentConfig,
+  TokenLevelSentimentRuleSet,
+  DocumentLevelSentimentRuleSet,
+  AspectBasedSentimentRuleSet,
+  SentimentRuleSet,
+  CompiledTokenLevelSentimentRuleSet,
+  CompiledDocumentLevelSentimentRuleSet,
+  CompiledAspectBasedSentimentRuleSet,
+  CompiledSentimentRuleSet,
+  TokenModifier,
+  TokenScore,
+  SentenceResult,
+  AspectResult,
+  SentimentResult,
+  SentimentOptions,
+  IngestResult
+} from './types';
+
+// Constants & utilities
+export {
+  SENTIMENT_DEFAULTS,
+  resolveSentimentLabel
+} from './types';
+
+// Compiler
+export { compileSentimentRuleSet } from './compiler';
+
+// Strategy
+export { SentimentExecutor, sentimentStrategy } from './strategy';
+
+// Engine
+export { SentimentEngine } from './engine';