Skip to content

docs: restore the Glama badge + add npm/CI/license badges to the README#67

Merged
RubenSousaDinis merged 1 commit into
mainfrom
docs/readme-confidence-badges
Jun 26, 2026
Merged

docs: restore the Glama badge + add npm/CI/license badges to the README#67
RubenSousaDinis merged 1 commit into
mainfrom
docs/readme-confidence-badges

Conversation

@RubenSousaDinis

Copy link
Copy Markdown
Member

What

Restores the Glama score badge and adds npm version, CI status, and Apache-2.0 license badges to the README hero, joining the existing graded-by-polygraph self-grade.

Final hero row (left→right): npm · CI · license · Glama · graded by polygraph.

Why one physical line

README.md is rendered on two surfaces: the repo homepage and the polygraph-mcp-gate Marketplace listing. An earlier change collapsed the badges to a single one because the Marketplace renderer stacks each markdown line as its own block, so a multi-line badge list rendered vertically and broke the listing.

The fix is to keep every badge on one physical line, separated by spaces — they then flow inline (and wrap naturally) on both surfaces. A guard comment above the row documents this so it isn't re-split.

Badge choices

Trust-focused, and deliberately avoiding badges whose numbers could read as weak for a young project:

  • Included: npm version, CI status (live, from ci.yml), Apache-2.0 license, Glama (renders a green A A B), graded-by-polygraph self-grade.
  • Considered and dropped: a Socket.dev badge (renders an orange 74 — a middling score) and an OpenSSF Scorecard badge/workflow (young repos tend to score low). The Glama and polygraph self-grade badges already carry the security/trust signal, and render strongly.

Verification

  • All five badge image URLs return 200 + an SVG content-type; the Glama badge renders A A B (green); the polygraph badge 307200 image (camo follows the redirect).
  • No version bump or publish — README only. The polygraph-mcp-gate action and its pinned version input are untouched.
  • Post-merge: confirm the Marketplace listing renders the row inline, not stacked.

…ADME hero

Bring back the Glama score badge alongside npm version, CI status, and Apache-2.0
license badges. Keep every badge on a single physical line so the row renders
inline on both the GitHub repo page and the Marketplace listing for the
polygraph-mcp-gate action — the Marketplace renderer turns each markdown line
into its own block, so a multi-line badge list would stack vertically and break
the listing.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TZcTQCDwyFqdh59fPWDJAr
@RubenSousaDinis RubenSousaDinis merged commit 2858b55 into main Jun 26, 2026
11 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant