release v0.1.11 (granular thresholds and updated documentation)

Author: intelliDean

Cargo.lock

@@ -6,7 +6,7 @@ members = [
 ]
 
 [workspace.package]
-version = "0.1.10"
+version = "0.1.11"
 edition = "2021"
 authors = ["CreativesOnchain"]
 license = "MIT"
@@ -17,7 +17,7 @@ keywords = ["arbitrum", "stylus", "profiling", "gas", "flamegraph"]
 categories = ["development-tools::profiling", "wasm"]
 
 [workspace.dependencies]
-stylus-trace-core = { version = "0.1.10", path = "crates/stylus-trace-core" }
+stylus-trace-core = { version = "0.1.11", path = "crates/stylus-trace-core" }
 clap = { version = "4.5", features = ["derive", "env"] }
 serde = { version = "1.0", features = ["derive"] }
 serde_json = "1.0"

Cargo.toml

@@ -145,7 +145,9 @@ This feature will be enabled automatically once upstream tracer support is avail
 |------|-------------|---------|
 | `--tx` | Transaction hash to profile in CI (optional) | - |
 | `--rpc` | RPC endpoint URL | `http://localhost:8547` |
-| `--threshold` | Percentage threshold for regressions | `1.0` |
+| `--threshold` | Global percentage threshold for all metrics | `1.0` |
+| `--gas-threshold` | Specific percentage threshold for Gas regressions | - |
+| `--hostio-threshold` | Specific percentage threshold for HostIO regressions | - |
 | `--force` | Overwrite existing workflow files | `false` |
 
 ---
@@ -169,7 +171,8 @@ You can use the [Stylus Trace Action](https://github.com/CreativesOnchain/Stylus
   uses: CreativesOnchain/Stylus-Trace@main
   with:
     tx_hash: "0x..."
-    threshold: "1.0" # Fail if gas increases by > 1%
+    gas_threshold: "1.0" # Fail if gas increases by > 1%
+    threshold: "10.0"     # Higher global limit for other metrics
 ```
 
 ---

README.md

@@ -15,9 +15,15 @@ inputs:
     required: false
     default: 'artifacts/capture/baseline.json'
   threshold:
-    description: 'Percentage threshold for allowed increase (e.g. 1.0 for 1%)'
+    description: 'Global percentage threshold for all metrics (e.g. 1.0 for 1%)'
     required: false
     default: '1.0'
+  gas_threshold:
+    description: 'Specific percentage threshold for Gas regressions'
+    required: false
+  hostio_threshold:
+    description: 'Specific percentage threshold for HostIO regressions'
+    required: false
   ink:
     description: 'Use Stylus Ink units instead of Gas'
     required: false
@@ -71,8 +77,20 @@ runs:
     - name: Compare with Baseline
       shell: bash
       run: |
+        GAS_FLAG=""
+        if [ -n "${{ inputs.gas_threshold }}" ]; then
+          GAS_FLAG="--gas-threshold ${{ inputs.gas_threshold }}"
+        fi
+
+        HOSTIO_FLAG=""
+        if [ -n "${{ inputs.hostio_threshold }}" ]; then
+          HOSTIO_FLAG="--hostio-threshold ${{ inputs.hostio_threshold }}"
+        fi
+
         stylus-trace diff \
           "${{ inputs.baseline }}" \
           artifacts/capture/current_profile.json \
           --threshold-percent "${{ inputs.threshold }}" \
+          $GAS_FLAG \
+          $HOSTIO_FLAG \
           --summary

action.yml

@@ -184,10 +184,18 @@ pub enum CiSubcommands {
         #[arg(short, long)]
         rpc: Option<String>,
 
-        /// Percentage threshold for regressions (e.g., 1.0)
+        /// Global percentage threshold for all metrics (e.g., 1.0)
         #[arg(short = 'p', long, default_value = "1.0")]
         threshold: f64,
 
+        /// Specific gas increase threshold percentage
+        #[arg(long = "gas-threshold")]
+        gas_threshold: Option<f64>,
+
+        /// Specific HostIO calls increase threshold percentage
+        #[arg(long = "hostio-threshold")]
+        hostio_threshold: Option<f64>,
+
         /// Force overwrite existing workflow files
         #[arg(long)]
         force: bool,
@@ -201,12 +209,16 @@ fn handle_ci(subcommand: CiSubcommands) -> Result<()> {
             tx,
             rpc,
             threshold,
+            gas_threshold,
+            hostio_threshold,
             force,
         } => {
             let args = stylus_trace_core::commands::models::CiInitArgs {
                 transaction_hash: tx,
                 rpc_url: rpc,
                 threshold,
+                gas_threshold,
+                hostio_threshold,
                 force,
             };
             stylus_trace_core::commands::execute_ci_init(args)

bin/stylus-trace-studio/src/main.rs

@@ -26,12 +26,28 @@ pub fn execute_ci_init(args: CiInitArgs) -> Result<()> {
     }
 
     // 2. Generate YAML
-
     let tx_hash = args
         .transaction_hash
         .as_deref()
         .unwrap_or("YOUR_TRANSACTION_HASH");
 
+    let mut with_block = format!(
+        r#"          tx_hash: "{}"
+          threshold: "{}"
+"#,
+        tx_hash, args.threshold
+    );
+
+    if let Some(gas) = args.gas_threshold {
+        with_block.push_str(&format!("          gas_threshold: \"{}\"\n", gas));
+    }
+
+    if let Some(hostio) = args.hostio_threshold {
+        with_block.push_str(&format!("          hostio_threshold: \"{}\"\n", hostio));
+    }
+
+    with_block.push_str("          skip_capture: \"true\"");
+
     let workflow_yaml = format!(
         r#"name: Stylus Performance Check
 
@@ -59,11 +75,9 @@ jobs:
       - name: Run Stylus Performance Check
         uses: CreativesOnchain/Stylus-Trace@main
         with:
-          tx_hash: "{}"
-          threshold: "{}"
-          skip_capture: "true"
+{}
 "#,
-        tx_hash, args.threshold
+        with_block
     );
 
     // 3. Write file

crates/stylus-trace-core/src/commands/ci.rs

@@ -155,6 +155,12 @@ pub struct CiInitArgs {
     /// Default percentage threshold for regressions
     pub threshold: f64,
 
+    /// Specific gas increase threshold percentage (optional)
+    pub gas_threshold: Option<f64>,
+
+    /// Specific HostIO calls increase threshold percentage (optional)
+    pub hostio_threshold: Option<f64>,
+
     /// Force overwrite existing files
     pub force: bool,
 }
@@ -165,6 +171,8 @@ impl Default for CiInitArgs {
             transaction_hash: None,
             rpc_url: Some("http://localhost:8547".to_string()),
             threshold: 1.0,
+            gas_threshold: None,
+            hostio_threshold: None,
             force: false,
         }
     }