feat: separate ticket issuer and subject identities

[David Mireles (louzt)]

Summary

This PR strengthens the SnapPipe control plane by separating the identity that signs a ticket from the identity the ticket authorizes.

What this changes

• adds explicit issuer and subject claims to tickets
• allows the CLI to issue a ticket for a different peer via --subject-public-key
• keeps self-issued tickets as the default when no subject override is provided
• adds CI for cargo fmt --check and cargo test
• adds CONTRIBUTING.md with the short-lived branch + PR workflow

Why it matters

A self-hosted relay/operator often needs to sign access for a client peer. That is a different model from a purely self-issued ticket. This PR makes that distinction explicit in the signed data model instead of leaving it implicit.

Verification

• cargo test

Summary by CodeRabbit

• New Features

  • Added QUIC profile support in the CLI, including preset profiles and JSON output.
  • Ticket issuance now supports an optional subject key, and verification output includes the issuer identity.

• Documentation

  • Expanded the README with clearer architecture details, CLI examples, QUIC notes, and contribution guidance.
  • Added architecture and contributor documentation for the project’s transport and workflow model.

• Chores

  • Added automated CI checks for formatting and tests on pushes and pull requests.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: d4ba8a29-3549-4aa5-baab-b1810a7b1cf5

📥 Commits

Reviewing files that changed from the base of the PR and between 0f5359f and 9a2d14e.

⛔ Files ignored due to path filters (1)

• Cargo.lock is excluded by !**/*.lock

📒 Files selected for processing (8)

• .github/workflows/ci.yml
• ARCHITECTURE.md
• CONTRIBUTING.md
• Cargo.toml
• README.md
• src/lib.rs
• src/main.rs
• src/quic.rs

---

📝 Walkthrough

Walkthrough

SnapPipe now models QUIC transport profiles, wires a quic profile CLI command, extends ticket claims with issuer and optional subject handling, and adds supporting docs, CI, and contributor guidance.

Changes

QUIC transport and ticket flow

Layer / File(s)	Summary
QUIC transport profile contract src/lib.rs, src/quic.rs, Cargo.toml, ARCHITECTURE.md, README.md	QuicTransportProfile and QuicProfileError are added, preset values are converted into quinn::TransportConfig, and the architecture docs describe the new QUIC transport model.
Ticket issuer and subject claims src/lib.rs, src/main.rs, README.md	TicketClaims gains issuer, ticket issuance accepts an optional subject key, verification prints issuer, and the ticket example and tests are updated for the new claim shape.
QUIC profile subcommand src/main.rs, README.md	snappipe quic profile is added, its preset arguments select a transport profile, and the README shows the JSON output example.
Repo guidance and CI .github/workflows/ci.yml, CONTRIBUTING.md, README.md	A Rust CI workflow, contributor validation guidance, and README notes about QUIC transport profiles and contribution flow are added.

Sequence Diagram(s)

sequenceDiagram
  participant main
  participant quic_profile as quic_profile(args)
  participant QuicTransportProfile
  main->>quic_profile: Command::Quic::Profile
  quic_profile->>QuicTransportProfile: low_latency_interactive() / relay_backhaul()
  quic_profile-->>main: pretty JSON profile

Loading

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~45 minutes

Poem

Hoppity hop, I tuned the QUIC!
Tickets got an issuer, shiny and quick.
Profile carrots JSON-glow bright,
Tests sniffed the burrows, everything right.
Snip snap—SnapPipe leaps through the night. 🐇

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/issuer-subject-tickets

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}