portail 0.1.0

Unified proxy/gateway: AI Gateway + MCP Gateway + CDN cache
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
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135

# ── Portail dev workflows ──────────────────────────────────────────────
default: build

# ── Build ──────────────────────────────────────────────────────────────
build:
    cargo build

release:
    cargo build --release

check:
    cargo check --locked

# ── Test ───────────────────────────────────────────────────────────────
test:
    cargo test --locked

test-fast: nextest

nextest:
    cargo nextest run --locked

bench:
    cargo bench

# ── Lint ───────────────────────────────────────────────────────────────
lint: clippy format

clippy:
    cargo clippy --locked --all-targets -- -D warnings

format:
    cargo fmt --check

format-fix:
    cargo fmt

# ── Watch ──────────────────────────────────────────────────────────────
watch:
    cargo watch -x check -x test

# ── Security ───────────────────────────────────────────────────────────
audit:
    cargo audit

deny:
    cargo deny check

outdated:
    cargo outdated

# ── Clean ──────────────────────────────────────────────────────────────
clean:
    cargo clean

clean-release:
    cargo clean --release

# ── Full CI pipeline ───────────────────────────────────────────────────
ci: check lint test

# ── Nix ────────────────────────────────────────────────────────────────
nix-check:
    nix flake check --impulse

nix-build:
    nix build .#portail

# ── Docker ─────────────────────────────────────────────────────────────
docker-build:
    docker build -t portail:latest .

docker-run: docker-build
    docker run --rm -p 8787:8787 portail:latest

docker-slim:
    docker build -t portail:slim --target build -f Dockerfile .
    @echo "Binary size:"
    docker run --rm portail:slim ls -lh /build/target/release/portail

# ── Credentials ────────────────────────────────────────────────────────
login:
    cargo login

publish-dry:
    cargo publish --dry-run

publish:
    cargo publish

# ── Release ────────────────────────────────────────────────────────────
release-dist: release
    upx --best --lzma target/release/portail
    sha256sum target/release/portail | tee target/release/portail.sha256

release-sign: release-dist
    cosign sign-blob --yes \
      --output-signature target/release/portail.sig \
      --output-certificate target/release/portail.pem \
      target/release/portail
    cosign sign-blob --yes \
      --output-signature target/release/portail.sha256.sig \
      --output-certificate target/release/portail.sha256.pem \
      target/release/portail.sha256

release-verify:
    cosign verify-blob \
      --cert target/release/portail.pem \
      --signature target/release/portail.sig \
      target/release/portail

# ── Help ───────────────────────────────────────────────────────────────
help:
    @echo "  build          cargo build (debug)"
    @echo "  release        cargo build --release (LTO fat)"
    @echo "  release-dist   build + UPX compress"
    @echo "  release-sign   build + UPX + cosign sign"
    @echo "  release-verify verify cosign signature"
    @echo "  test           cargo test"
    @echo "  test-fast      cargo nextest run"
    @echo "  bench          cargo bench (criterion)"
    @echo "  lint           clippy + fmt check"
    @echo "  clippy         cargo clippy -- -D warnings"
    @echo "  check          cargo check"
    @echo "  watch          cargo watch -x check -x test"
    @echo "  audit          cargo audit"
    @echo "  deny           cargo deny check"
    @echo "  ci             check + lint + test"
    @echo "  docker-build   build Docker image"
    @echo "  docker-run     build + run on :8787"
    @echo "  docker-slim    check compressed binary size"
    @echo "  login          setup crates.io credentials (cargo-credential-pass)"
    @echo "  publish-dry    cargo publish --dry-run"
    @echo "  publish        cargo publish to crates.io"
    @echo "  nix-check      nix flake check --impulse"