Re-export free decision functions from package root, update README

Author: jathoms

README.md

@@ -9,10 +9,6 @@ This library provides a lightweight framework for backtesting trading strategies
 A strategy must conform to the following structure:
 
 ```python
-class Decision:
-    target: WeightedPortfolio
-    notes: UniverseMapping[Any] | None = None
-
 class Strategy(Protocol):
     def __call__(
         self,
@@ -23,39 +19,38 @@ class Strategy(Protocol):
     ) -> Decision: ...
 ```
 
-_In short, a function is called a strategy as long as it takes the universe, the current holdings, a market view, and additional context as parameters, and returns a Decision (which wraps the target portfolio)._
+_In short, a function is called a strategy as long as it takes the universe, the current holdings, a market view, and additional context as parameters, and returns a Decision, which can be constructed using the functions provided in the `decision` module, re-exported at the library root for convenience._
 
 As inputs, the strategy receives the available universe, current holdings, a view of the market, and a context object for state.
 
-For outputs, the strategy emits a Decision specifying the new target portfolio for each decision point in the _decision schedule_ 
+For outputs, the strategy emits a Decision for each decision point in the _decision schedule_ 
 
 An toy example strategy can be written as follows, where we allocate our holdings uniformly across our universe:
 
 ```python
-import backtest_lib as btl
-from backtest_lib.portfolio import uniform_portfolio
+from backtest_lib import target_weights
 
 def equal_weight_strategy(
     universe,
     current_portfolio,
     market,
     ctx,
 ):
-    return btl.Decision(uniform_portfolio(universe))
+    return target_weights({sec: 1/len(universe) for sec in universe})
 ```
 
 Or alternatively, another trivial strategy where we do nothing after creating our initial portfolio:
 
 ```python
-import backtest_lib as btl
+from backtest_lib import hold
 
 def buy_and_hold_strategy(
     universe,
     current_portfolio,
     market,
     ctx,
 ):
-    return btl.Decision(current_portfolio)
+    return hold()
 ```
 
 ## Market

src/backtest_lib/__init__.py

@@ -1,4 +1,12 @@
 from backtest_lib.backtest import Backtest
+from backtest_lib.engine.decision import (
+    combine,
+    hold,
+    reallocate,
+    target_holdings,
+    target_weights,
+    trade,
+)
 from backtest_lib.market import MarketView
 from backtest_lib.portfolio import (
     FractionalQuantityPortfolio,
@@ -16,4 +24,10 @@
     "QuantityPortfolio",
     "FractionalQuantityPortfolio",
     "Strategy",
+    "hold",
+    "reallocate",
+    "target_holdings",
+    "target_weights",
+    "trade",
+    "combine",
 ]