feat: add trigger-happy paper strategy example

Author: journeytosilius

crates/palmscript/examples/README.md

@@ -27,6 +27,7 @@ Checked-in `.ps` strategies live under `crates/palmscript/examples/strategies/`.
 
 Representative files:
 
+- `crates/palmscript/examples/strategies/paper_trigger_happy.ps`: high-churn Binance USD-M paper-trading example with market entries, short holding windows, and tight ATR-based stop/target orders to stress the paper execution path
 - `crates/palmscript/examples/strategies/adaptive_trend_backtest.ps`: adaptive multi-timeframe long-only backtest strategy with optimizer-tuned EMA, RSI, MACD, entry sizing, ATR target, and post-target stop-ratchet inputs around staged `entry1` / `entry2` and `target1` / `target2` order flow, including inline `input ... optimize(...)` metadata for durable CLI optimization
 - `crates/palmscript/examples/strategies/portfolio_caps_backtest.ps`: multi-alias portfolio backtest example using `portfolio_group`, position-count caps, and gross/net exposure caps under repeated `--execution-source` CLI selection
 - `crates/palmscript/examples/strategies/risk_controls_backtest.ps`: staged spot backtest example using declarative `cooldown` and `max_bars_in_trade` controls to gate same-side re-entry and time-box open trades
@@ -67,6 +68,7 @@ execution scripts that omit them.
 The same checked-in strategies can also be queued into the local paper daemon with `run paper`:
 
 ```bash
+./palmscript run paper crates/palmscript/examples/strategies/paper_trigger_happy.ps --maker-fee-bps 2 --taker-fee-bps 5
 ./palmscript run paper crates/palmscript/examples/strategies/bybit_usdt_perps_backtest.ps --execution-source perp --maker-fee-bps 2 --taker-fee-bps 5
 ./palmscript execution serve --once
 ./palmscript run paper-export <session-id> --format json

crates/palmscript/examples/strategies/paper_trigger_happy.ps

@@ -45,6 +45,7 @@ fn bars(start_ms: i64, spacing_ms: i64, len: usize, start_close: f64) -> Vec<Bar
 #[test]
 fn referenced_docs_examples_compile() {
     let examples = [
+        "examples/strategies/paper_trigger_happy.ps",
         "examples/strategies/adaptive_trend_backtest.ps",
         "examples/strategies/portfolio_caps_backtest.ps",
         "examples/strategies/sma_cross.ps",
@@ -328,6 +329,48 @@ fn explicit_order_backtest_docs_example_runs_with_local_feeds() {
     assert!(!result.equity_curve.is_empty(), "{path} should emit equity");
 }
 
+#[test]
+fn paper_trigger_happy_example_runs_with_local_feeds() {
+    let path = "examples/strategies/paper_trigger_happy.ps";
+    let compiled = compile(&read_strategy(path)).expect("paper_trigger_happy should compile");
+    let runtime = SourceRuntimeConfig {
+        base_interval: palmscript::Interval::Min1,
+        feeds: vec![SourceFeed {
+            source_id: 0,
+            interval: palmscript::Interval::Min1,
+            bars: bars(JAN_1_2024_UTC_MS, MINUTE_MS, 240, 100.0),
+        }],
+    };
+
+    let outputs = run_with_sources(&compiled, runtime.clone(), VmLimits::default())
+        .expect("paper_trigger_happy should run");
+    assert!(!outputs.plots.is_empty(), "{path} should emit plots");
+
+    let result = run_backtest_with_sources(
+        &compiled,
+        runtime,
+        VmLimits::default(),
+        BacktestConfig {
+            execution_source_alias: "exec".to_string(),
+            portfolio_execution_aliases: Vec::new(),
+            spot_virtual_rebalance: false,
+            activation_time_ms: None,
+            initial_capital: 10_000.0,
+            maker_fee_bps: 0.0,
+            taker_fee_bps: 0.0,
+            execution_fee_schedules: std::collections::BTreeMap::new(),
+            slippage_bps: 0.0,
+            diagnostics_detail: DiagnosticsDetailMode::SummaryOnly,
+            perp: None,
+            perp_context: None,
+            portfolio_perp_contexts: std::collections::BTreeMap::new(),
+        },
+    )
+    .expect("paper_trigger_happy should backtest");
+    assert!(!result.orders.is_empty(), "{path} should emit orders");
+    assert!(!result.equity_curve.is_empty(), "{path} should emit equity");
+}
+
 #[test]
 fn source_aware_docs_examples_run_with_local_feeds() {
     let spread = compile(&read_strategy("examples/strategies/cross_source_spread.ps"))

crates/palmscript/tests/docs_examples.rs

@@ -11,12 +11,12 @@ once = false
 
 [[session]]
 enabled = true
-script = "strategy.ps"
+script = "paper_trigger_happy.ps"
 
-# Current validated paper target from /mnt/4tbscratch/projects/palmscript-build-futures:
+# Default bundled paper smoke-test target:
 # - execution alias: exec
 # - symbol / segment: Binance USD-M BTCUSDT
-# - exact validation artifact: opt_probe_iter52_cooldown1_exact.json
+# - strategy goal: frequent fills plus tight stop/target churn
 
 initial_capital = 10000.0
 maker_fee_bps = 2.0