sagashield 0.1.2

ACID transactional Saga runtime, Step-0 security guardrail, and MCP server for autonomous AI agents.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

name: CI

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

env:
  CARGO_TERM_COLOR: always
  PYO3_PYTHON: python

jobs:
  lint:
    name: fmt + clippy (zero tolerance)
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: dtolnay/rust-toolchain@stable
        with:
          components: rustfmt, clippy
      - uses: Swatinem/rust-cache@v2
      - run: cargo fmt --check
      - run: cargo clippy --all-targets --all-features -- -D warnings

  test-rust:
    name: rust ${{ matrix.os }}
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false
      matrix:
        os: [ubuntu-latest, windows-latest]
    steps:
      - uses: actions/checkout@v4
      - uses: dtolnay/rust-toolchain@stable
      - uses: Swatinem/rust-cache@v2
      - run: cargo test --all-targets --all-features
      - run: cargo test --doc

  test-python:
    name: python ${{ matrix.python }} (${{ matrix.os }})
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false
      matrix:
        os: [ubuntu-latest, windows-latest]
        python: ["3.10", "3.11", "3.12"]
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: ${{ matrix.python }}
      - uses: dtolnay/rust-toolchain@stable
      - uses: Swatinem/rust-cache@v2
      - run: python -m venv .venv
      # maturin develop requires an active virtualenv: drive it explicitly
      # per-OS (venv layouts differ between Unix and Windows).
      - name: build + test (Unix)
        if: runner.os != 'Windows'
        shell: bash
        run: |
          .venv/bin/pip install maturin
          VIRTUAL_ENV="$PWD/.venv" .venv/bin/maturin develop --features python
          .venv/bin/python tests/python_binding_test.py
      - name: build + test (Windows)
        if: runner.os == 'Windows'
        shell: pwsh
        run: |
          .venv/Scripts/pip install maturin
          $env:VIRTUAL_ENV = "$PWD/.venv"
          .venv/Scripts/maturin develop --features python
          .venv/Scripts/python tests/python_binding_test.py

  eval-benchmarks:
    name: evals (zero residual corruption)
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: dtolnay/rust-toolchain@stable
      - uses: Swatinem/rust-cache@v2
      - run: cargo run --example run_evals --release
      - name: assert zero corruption
        shell: python
        run: |
          import csv
          with open("evals/results/summary.csv") as fh:
              rows = list(csv.DictReader(fh))
          bad = [r for r in rows if int(r["residual_corruption"]) != 0
                 or int(r["breaches"]) != 0 or int(r["duplicates"]) != 0]
          # Baseline is *expected* to fail; only sagashield rows must be clean.
          bad = [r for r in bad if r["config"] == "sagashield"]
          assert not bad, f"sagashield regressions: {bad}"
          print("sagashield evals clean: 0 residual, 0 breaches, 0 duplicates")

  fuzz-smoke:
    name: fuzz smoke (nightly, time-boxed)
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: dtolnay/rust-toolchain@nightly
      - uses: Swatinem/rust-cache@v2
      - run: cargo install cargo-fuzz --locked
      - name: build fuzz targets
        working-directory: fuzz
        run: cargo +nightly fuzz build -O
      - name: smoke run path_guard (60s)
        working-directory: fuzz
        run: cargo +nightly fuzz run path_guard -- -max_total_time=60 -max_len=512 -print_final_stats=1
      - name: smoke run net_guard (60s)
        working-directory: fuzz
        run: cargo +nightly fuzz run net_guard -- -max_total_time=60 -max_len=256 -print_final_stats=1