Skip to content

fix: add error schemas, CONTRIBUTING, SECURITY, and auto-changelog #755

Open
topsonDev wants to merge 1 commit into
solutions-plug:mainfrom
topsonDev:fix/issues-728-729-730-731
Open

fix: add error schemas, CONTRIBUTING, SECURITY, and auto-changelog #755
topsonDev wants to merge 1 commit into
solutions-plug:mainfrom
topsonDev:fix/issues-728-729-730-731

Conversation

@topsonDev
Copy link
Copy Markdown

Summary

This PR resolves four issues in a single change set.


#728 — Add missing error response schemas to openapi.yaml

  • Added optional details field to the ApiError schema (services/api/openapi.yaml)
  • Added 400, 401, 403, 404, 429, and 500 responses to every endpoint that was previously missing them (health, statistics, markets, blockchain, newsletter, email, and webhook endpoints)
  • Updated frontend/src/lib/api/client.ts: ApiError now exposes a code (string) and details (object) field, parsed from the typed API error body

#729 — Automate CHANGELOG generation with git-cliff

  • Added cliff.toml with a conventional-commit parser and grouped changelog sections
  • Rewrote .github/workflows/release.yml to trigger on version tags (v*.*.*), run git-cliff via orhun/git-cliff-action, commit the updated CHANGELOG.md, and create a GitHub Release with the generated notes
  • Added .github/workflows/protect-changelog.yml: CI check that fails any PR that touches CHANGELOG.md manually
  • CONTRIBUTING.md documents the commit convention and the no-manual-edit rule

#730 — Add CONTRIBUTING.md

  • Created CONTRIBUTING.md at the repo root covering: development setup, branch naming, commit conventions (Conventional Commits), PR checklist, running tests for all services, and code style requirements
  • Added a link to CONTRIBUTING.md in docs/README.md under the Want to Contribute section

#731 — Add SECURITY.md

  • Created SECURITY.md at the repo root covering: supported versions, how to report (GitHub private advisory + email), response timeline, coordinated disclosure policy, in/out-of-scope definitions, and security best practices for contributors

Files Changed

File Change
services/api/openapi.yaml Added details to ApiError schema; added missing 4xx/5xx responses to all endpoints
frontend/src/lib/api/client.ts ApiError now carries code and details from typed error responses
cliff.toml New — git-cliff configuration
.github/workflows/release.yml Rewritten to use git-cliff on version tags
.github/workflows/protect-changelog.yml New — blocks manual CHANGELOG edits in PRs
CONTRIBUTING.md New — contribution guide
SECURITY.md New — vulnerability disclosure policy
docs/README.md Added link to CONTRIBUTING.md

Closes #728
Closes #729
Closes #730
Closes #731

…lug#730 solutions-plug#731

solutions-plug#728 — openapi.yaml: add missing error response schemas
- Added optional `details` field to the `ApiError` schema
- Added 400, 401, 403, 404, 429, and 500 responses to all endpoints
  that were previously missing them (health, statistics, markets,
  blockchain, newsletter, email, and webhook endpoints)
- frontend/src/lib/api/client.ts: ApiError now exposes `code` (string)
  and `details` (object) fields parsed from typed API error responses

solutions-plug#729 — automate CHANGELOG generation with git-cliff
- Added cliff.toml with conventional-commit parser and grouped sections
- Rewrote .github/workflows/release.yml to trigger on version tags,
  run git-cliff (orhun/git-cliff-action), commit CHANGELOG.md, and
  create a GitHub Release with the generated notes
- Added .github/workflows/protect-changelog.yml CI check that fails
  any PR touching CHANGELOG.md manually
- CONTRIBUTING.md documents commit conventions and the no-manual-edit rule

solutions-plug#730 — add CONTRIBUTING.md
- Created CONTRIBUTING.md covering: development setup, branch naming,
  commit conventions (Conventional Commits), PR checklist, running
  tests for all services, and code style requirements
- Added link to CONTRIBUTING.md in docs/README.md under Want to Contribute

solutions-plug#731 — add SECURITY.md
- Created SECURITY.md covering: supported versions, how to report
  (GitHub private advisory + email), response timeline, coordinated
  disclosure policy, in/out-of-scope definitions, and security best
  practices for contributors
@drips-wave
Copy link
Copy Markdown

drips-wave Bot commented May 27, 2026

@topsonDev 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

@topsonDev topsonDev changed the title fix: add error schemas, CONTRIBUTING, SECURITY, and auto-changelog (#728 #729 #730 #731) fix: add error schemas, CONTRIBUTING, SECURITY, and auto-changelog May 27, 2026
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