Skip to content

chore: verify clippy -D warnings, add MSRV matrix, branch-protection docs, and Makefile shortcuts - #174

Open
Lost-Z wants to merge 1 commit into
stellar-vortex-protocol:mainfrom
Lost-Z:ci/multi-issue-audit-msrv-makefile-docs
Open

chore: verify clippy -D warnings, add MSRV matrix, branch-protection docs, and Makefile shortcuts#174
Lost-Z wants to merge 1 commit into
stellar-vortex-protocol:mainfrom
Lost-Z:ci/multi-issue-audit-msrv-makefile-docs

Conversation

@Lost-Z

@Lost-Z Lost-Z commented Jul 28, 2026

Copy link
Copy Markdown

Summary

This PR implements four related CI/tooling issues in one cohesive change.


Closes #95 — Verify clippy -D warnings is enforced as a required CI status check

  • Audited .github/workflows/ci.yml: the Clippy step already runs the exact command documented in README (cargo clippy --all-targets -- -D warnings). No drift found.
  • The MSRV matrix added by this PR means -D warnings is now enforced on both stable and 1.78 legs.
  • CONTRIBUTING.md (new) includes a dedicated section explaining how maintainers can verify the required-check is actually enforced via the GitHub UI and GitHub CLI.

Closes #99 — Add a CI matrix testing against the README's stated MSRV (Rust 1.78+)

  • Added "1.78" to the contract job matrix alongside stable.
  • rustfmt check is intentionally restricted to the stable leg to avoid false failures from formatter output changes across Rust versions.
  • Clippy and tests run on both legs.
  • Cache is keyed per toolchain to prevent cross-contamination.

Closes #100 — Add branch protection / required-checks documentation for maintainers

  • Created CONTRIBUTING.md with a Maintainer Guide section that:
    • Tables the current required CI checks with exact names as reported to GitHub (Contract (stable), Contract (1.78), Dependency audit).
    • Explains step-by-step how to verify enforcement in the GitHub branch-protection UI.
    • Provides the equivalent gh api CLI command for scripted verification.
    • Documents the policy for updating required checks when new jobs are added.
    • Lists proposed future advisory checks (wasm-size gate, coverage).

Closes #101 — Add a Makefile/justfile wrapping the README's build/test/deploy commands

  • Added Makefile with targets: fmt, fmt-check, lint, test, build, audit, clean, deploy-testnet, all, help.
  • Added equivalent justfile for users of just.
  • All commands are sourced verbatim from README's documented raw commands — no drift introduced.
  • deploy-testnet requires STELLAR_SOURCE to be set and errors clearly if it isn't.
  • Updated README.md Build & Test section to showcase shortcut commands alongside raw commands.
  • Updated README Contributing section to link to the new local CONTRIBUTING.md.

What was tested

No build/test run was performed per task instructions. CI will validate on this PR:

  • Contract (stable) — fmt, clippy, test, wasm build
  • Contract (1.78) — clippy, test, wasm build (new MSRV leg)
  • Dependency audit

…docs, and Makefile shortcuts

- ci.yml: add Rust 1.78 MSRV matrix leg alongside stable so the declared
  prerequisite (README: 'Rust 1.78+') is actually verified in CI (closes stellar-vortex-protocol#99).
  The clippy step runs 'cargo clippy --all-targets -- -D warnings' on every
  matrix leg, identical to README's documented command (closes stellar-vortex-protocol#95).
  rustfmt check is restricted to the stable leg to avoid false failures.

- CONTRIBUTING.md: new file covering contributor workflow and a maintainer
  guide that enumerates required CI checks, explains how to verify them in the
  GitHub branch-protection UI and via the GitHub CLI, and documents the policy
  for updating required checks when new jobs are added (closes stellar-vortex-protocol#100, closes stellar-vortex-protocol#95).

- Makefile + justfile: wrap all README-documented commands as named targets
  (fmt, lint, test, build, audit, clean, deploy-testnet) so contributors do
  not need to copy-paste raw multi-flag commands (closes stellar-vortex-protocol#101).

- README.md: expand Build & Test section to reference Makefile/justfile
  shortcuts alongside the existing raw commands; update Contributing link to
  point at the new local CONTRIBUTING.md (closes stellar-vortex-protocol#101).
@drips-wave

drips-wave Bot commented Jul 28, 2026

Copy link
Copy Markdown

@Lost-Z Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

1 participant