ci: add optional praxis main testing and known-issue label

.github/actions/clone-praxis/action.yml

@@ -0,0 +1,20 @@
+name: Clone Praxis core
+description: >-
+  Clone praxis core repo as a sibling directory so
+  path-based [patch.crates-io] overrides resolve.
+
+inputs:
+  ref:
+    description: "Git ref to checkout (branch, tag, or SHA)"
+    required: false
+    default: "main"
+
+runs:
+  using: composite
+  steps:
+    - name: Clone praxis core
+      run: >-
+        git clone --depth 1 --branch "${{ inputs.ref }}"
+        https://github.com/praxis-proxy/praxis.git
+        "$GITHUB_WORKSPACE/../praxis"
+      shell: bash

.github/actions/patch-praxis/action.yml

@@ -0,0 +1,20 @@
+name: Patch Praxis dependencies
+description: >-
+  Override crates.io praxis dependencies with local
+  path dependencies from the cloned praxis repo.
+
+runs:
+  using: composite
+  steps:
+    - name: Append [patch.crates-io] to Cargo.toml
+      run: |
+        cat >> Cargo.toml << 'PATCH'
+
+        [patch.crates-io]
+        praxis-proxy-core = { path = "../praxis/core" }
+        praxis-proxy-filter = { path = "../praxis/filter" }
+        praxis-proxy-protocol = { path = "../praxis/protocol" }
+        praxis-proxy-tls = { path = "../praxis/tls" }
+        praxis-proxy = { path = "../praxis/server" }
+        PATCH
+      shell: bash

.github/workflows/ci-status.yaml

@@ -42,6 +42,7 @@ jobs:
 
             const excludedChecks = new Set([
               'ci-status',
+              'test-praxis-main',
             ]);
 
             const terminalStatuses = new Set(['completed']);

.github/workflows/integration.yaml

@@ -9,14 +9,14 @@ on:
     branches: [main]
   pull_request:
     branches: [main]
+    types: [opened, synchronize, reopened]
   workflow_dispatch:
     inputs:
       debug:
         description: "Enable verbose test output (V=1)"
         required: false
         type: boolean
         default: false
-
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}

.github/workflows/praxis-compat.yaml

@@ -0,0 +1,79 @@
+name: Tests (praxis main)
+
+# ------------------------------------------------------------------------------
+# Workflow Settings
+# ------------------------------------------------------------------------------
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+    types: [opened, synchronize, reopened, labeled]
+  workflow_dispatch:
+    inputs:
+      praxis_ref:
+        description: "Praxis core git ref to test against"
+        required: false
+        type: string
+        default: "main"
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
+
+permissions: {}
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  # ----------------------------------------------------------------------------
+  # Build + test against praxis core main
+  # ----------------------------------------------------------------------------
+
+  test-praxis-main:
+    runs-on: ubuntu-24.04
+    continue-on-error: ${{ contains(github.event.pull_request.labels.*.name, 'praxis-known-issue') }}
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+
+      - name: Clone Praxis core (path dependency)
+        uses: ./.github/actions/clone-praxis
+        with:
+          ref: ${{ inputs.praxis_ref || 'main' }}
+
+      - name: Patch Praxis dependencies
+        uses: ./.github/actions/patch-praxis
+
+      - name: Update lockfile for patched dependencies
+        run: cargo update
+
+      - name: Install stable Rust
+        uses: dtolnay/rust-toolchain@6190aa5fb88a88ee71c12769924bbe63a9ab152e # 1.96.0
+
+      - name: Cache Cargo registry and build artifacts
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
+        with:
+          path: |
+            ~/.cargo/registry/index
+            ~/.cargo/registry/cache
+            ~/.cargo/git/db
+            target
+          key: ${{ runner.os }}-rust-1.96.0-praxis-main-${{ hashFiles('**/Cargo.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-rust-1.96.0-praxis-main-
+
+      - name: Unit tests
+        run: |
+          cargo test -p praxis-ai-apis --features praxis-main
+          cargo test -p praxis-ai-filters --features praxis-main
+          cargo test -p praxis-ai-proxy --features praxis-main
+
+      - name: Schema tests
+        run: cargo test -p praxis-tests-schema --features praxis-main
+
+      - name: Integration tests
+        run: cargo test -p praxis-tests-integration --features praxis-main

.github/workflows/tests.yaml

@@ -9,6 +9,7 @@ on:
     branches: [main]
   pull_request:
     branches: [main]
+    types: [opened, synchronize, reopened]
   merge_group:
     branches: [main]
   workflow_dispatch:
@@ -18,7 +19,6 @@ on:
         required: false
         type: boolean
         default: false
-
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}

Makefile

@@ -16,7 +16,8 @@ endif
 	lint fmt doc audit coverage-check \
 	require-container-engine \
 	container container-run \
-	setup-hooks help
+	setup-hooks help \
+	patch-praxis unpatch-praxis
 
 # -------------------------------------------------------------------
 # All
@@ -105,6 +106,35 @@ coverage-check:
 		exit 1; \
 	fi
 
+# -------------------------------------------------------------------
+# Praxis path override (test against local ../praxis)
+# -------------------------------------------------------------------
+
+patch-praxis:
+	@if [ ! -d "../praxis" ]; then \
+		echo "ERROR: ../praxis not found — clone praxis core as a sibling directory first"; \
+		exit 1; \
+	fi
+	@if grep -q '\[patch\.crates-io\]' Cargo.toml; then \
+		echo "Already patched — run 'make unpatch-praxis' first"; \
+		exit 1; \
+	fi
+	@printf '\n[patch.crates-io]\n\
+	praxis-proxy-core = { path = "../praxis/core" }\n\
+	praxis-proxy-filter = { path = "../praxis/filter" }\n\
+	praxis-proxy-protocol = { path = "../praxis/protocol" }\n\
+	praxis-proxy-tls = { path = "../praxis/tls" }\n\
+	praxis-proxy = { path = "../praxis/server" }\n' >> Cargo.toml
+	@echo "Patched Cargo.toml to use ../praxis path dependencies"
+
+unpatch-praxis:
+	@if ! grep -q '\[patch\.crates-io\]' Cargo.toml; then \
+		echo "Nothing to unpatch"; \
+		exit 0; \
+	fi
+	@sed -i.bak '/^\[patch\.crates-io\]/,$$d' Cargo.toml && rm -f Cargo.toml.bak
+	@echo "Removed [patch.crates-io] from Cargo.toml"
+
 # -------------------------------------------------------------------
 # Dev Setup
 # -------------------------------------------------------------------
@@ -145,3 +175,7 @@ help:
 	@echo "Container:"
 	@echo "  container            build praxis-ai container image"
 	@echo "  container-run        run container in foreground (host network)"
+	@echo ""
+	@echo "Praxis override:"
+	@echo "  patch-praxis         use ../praxis path deps instead of crates.io"
+	@echo "  unpatch-praxis       revert to crates.io praxis deps"

apis/Cargo.toml

@@ -14,6 +14,7 @@ name = "praxis_ai_apis"
 [features]
 default = ["store"]
 store = ["dep:sqlx", "dep:dashmap"]
+praxis-main = []
 
 [lints]
 workspace = true

apis/src/lib.rs

@@ -91,6 +91,12 @@ pub(crate) mod test_utils {
             selected_endpoint_index: None,
             time_source: &praxis_core::time::SystemTimeSource,
             upstream: None,
+            #[cfg(feature = "praxis-main")]
+            peer_identity: None,
+            #[cfg(feature = "praxis-main")]
+            pre_read_mutations: Vec::new(),
+            #[cfg(feature = "praxis-main")]
+            structured_metadata: std::collections::HashMap::new(),
         }
     }
 

filters/Cargo.toml

@@ -14,6 +14,7 @@ name = "praxis_ai_filters"
 [features]
 default = ["apis"]
 apis = ["praxis-ai-apis/default"]
+praxis-main = []
 
 [lints]
 workspace = true

filters/src/agentic/a2a/mod.rs

@@ -674,15 +674,30 @@ fn clear_sse_capture_metadata(ctx: &mut HttpFilterContext<'_>) {
 fn build_json_rpc_config(max_body_bytes: usize) -> JsonRpcConfig {
     use praxis_filter::builtins::http::payload_processing::json_rpc::config::{BatchPolicy, JsonRpcHeaders};
 
-    JsonRpcConfig {
-        batch_policy: BatchPolicy::Reject,
-        headers: JsonRpcHeaders {
-            id: None,
-            kind: None,
-            method: None,
-        },
-        max_body_bytes,
-        on_invalid: OnInvalidBehavior::Continue,
+    let headers = JsonRpcHeaders {
+        id: None,
+        kind: None,
+        method: None,
+    };
+
+    #[cfg(feature = "praxis-main")]
+    {
+        JsonRpcConfig {
+            batch_policy: BatchPolicy::Reject,
+            headers,
+            max_batch_size: 100,
+            max_body_bytes,
+            on_invalid: OnInvalidBehavior::Continue,
+        }
+    }
+    #[cfg(not(feature = "praxis-main"))]
+    {
+        JsonRpcConfig {
+            batch_policy: BatchPolicy::Reject,
+            headers,
+            max_body_bytes,
+            on_invalid: OnInvalidBehavior::Continue,
+        }
     }
 }
 

filters/src/agentic/mcp/broker/mod.rs

@@ -919,14 +919,29 @@ fn build_json_rpc_config(max_body_bytes: usize) -> JsonRpcConfig {
         json_rpc::config::{BatchPolicy, JsonRpcHeaders},
     };
 
-    JsonRpcConfig {
-        batch_policy: BatchPolicy::Reject,
-        headers: JsonRpcHeaders {
-            id: None,
-            kind: None,
-            method: None,
-        },
-        max_body_bytes,
-        on_invalid: OnInvalidBehavior::Continue,
+    let headers = JsonRpcHeaders {
+        id: None,
+        kind: None,
+        method: None,
+    };
+
+    #[cfg(feature = "praxis-main")]
+    {
+        JsonRpcConfig {
+            batch_policy: BatchPolicy::Reject,
+            headers,
+            max_batch_size: 100,
+            max_body_bytes,
+            on_invalid: OnInvalidBehavior::Continue,
+        }
+    }
+    #[cfg(not(feature = "praxis-main"))]
+    {
+        JsonRpcConfig {
+            batch_policy: BatchPolicy::Reject,
+            headers,
+            max_body_bytes,
+            on_invalid: OnInvalidBehavior::Continue,
+        }
     }
 }

filters/src/agentic/mcp/mod.rs

@@ -194,15 +194,30 @@ impl HttpFilter for McpFilter {
 fn build_json_rpc_config(max_body_bytes: usize) -> JsonRpcConfig {
     use praxis_filter::builtins::http::payload_processing::json_rpc::config::{BatchPolicy, JsonRpcHeaders};
 
-    JsonRpcConfig {
-        batch_policy: BatchPolicy::Reject,
-        headers: JsonRpcHeaders {
-            id: None,
-            kind: None,
-            method: None,
-        },
-        max_body_bytes,
-        on_invalid: OnInvalidBehavior::Continue,
+    let headers = JsonRpcHeaders {
+        id: None,
+        kind: None,
+        method: None,
+    };
+
+    #[cfg(feature = "praxis-main")]
+    {
+        JsonRpcConfig {
+            batch_policy: BatchPolicy::Reject,
+            headers,
+            max_batch_size: 100,
+            max_body_bytes,
+            on_invalid: OnInvalidBehavior::Continue,
+        }
+    }
+    #[cfg(not(feature = "praxis-main"))]
+    {
+        JsonRpcConfig {
+            batch_policy: BatchPolicy::Reject,
+            headers,
+            max_body_bytes,
+            on_invalid: OnInvalidBehavior::Continue,
+        }
     }
 }
 

filters/src/lib.rs

@@ -86,6 +86,12 @@ pub(crate) mod test_utils {
             selected_endpoint_index: None,
             time_source: &praxis_core::time::SystemTimeSource,
             upstream: None,
+            #[cfg(feature = "praxis-main")]
+            peer_identity: None,
+            #[cfg(feature = "praxis-main")]
+            pre_read_mutations: Vec::new(),
+            #[cfg(feature = "praxis-main")]
+            structured_metadata: std::collections::HashMap::new(),
         }
     }
 

server/Cargo.toml

@@ -17,6 +17,9 @@ path = "src/lib.rs"
 name = "praxis-ai"
 path = "src/main.rs"
 
+[features]
+praxis-main = ["praxis-ai-filters/praxis-main", "praxis-ai-apis/praxis-main"]
+
 [lints]
 workspace = true