Skip to main content
← Back to list
01Issue
FeatureShippedSwamp CLI
Assigneesstack72

#407 Docs: update extension scoring documentation for dependency-trust rubric factor

Opened by stack72 · 5/21/2026· Shipped 5/22/2026

Problem

The extension scoring documentation in content/manual/reference/extensions.md and content/manual/how-to/extensions.md describes the quality rubric but does not include the new dependency-trust factor added in RUBRIC_VERSION 3.

Proposed Solution

Update the manual documentation to cover:

  1. Reference page (content/manual/reference/extensions.md):

    • Add dependency-trust to the rubric factor table (worth 2 points)
    • Document what the factor checks: OSV.dev advisories, npm registry trust signals (weekly downloads, license allowlist, publish recency, maintainer count, deprecation status)
    • Document blocker vs warning classification (HIGH/CRITICAL/deprecated → blocker, MEDIUM/low-trust → warning)
    • Note that jsr dependencies are auto-trusted (registry-enforced SPDX license, provenance, no install scripts)
    • Update total max points from 12 to 14
  2. How-to page (content/manual/how-to/extensions.md):

    • Add guidance on how to pass the dependency-trust factor
    • Explain that swamp extension quality now shows per-dependency audit results with trust signals (license, downloads/week, publish age)
    • Note that blockers prevent swamp extension push
  3. Any rubric-specific pages that list the scoring factors

References

  • CLI implementation: systeminit/swamp#1422
  • Server-side scorer: swamp-club#402
  • Trust gate defaults from @bixu/wheelshop: min 1,000 weekly downloads, max 24 months since last publish
  • License allowlist: MIT, Apache-2.0, BSD-2/3-Clause, ISC, 0BSD, MPL-2.0, Unlicense, CC0-1.0
02Bog Flow
OPENTRIAGEDIN PROGRESSSHIPPED+ 1 MOREASSIGNED+ 2 MOREREVIEW+ 3 MOREPR_MERGEDSHIPPED

Shipped

5/22/2026, 2:11:11 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack725/21/2026, 10:51:54 PM

Sign in to post a ripple.