Skip to content
This page was generated and translated with the assistance of AI. If you spot any inaccuracies, feel free to help improve it. Edit on GitHub

Trust Scores ​

Trust scores are a per-user reputation metric in OpenPR that tracks participation quality and decision-making history. When weighted voting is enabled, trust scores directly influence voting power.

How Trust Scores Work ​

Each workspace member has a trust score that reflects their governance participation:

FactorImpactDescription
Proposal qualityPositiveProposals that get approved increase score
Voting participationPositiveRegular voting increases score
Aligned decisionsPositiveVoting with the eventual majority
Rejected proposalsNegativeProposals that get rejected decrease score
Vetoed decisionsNegativeHaving proposals vetoed
AppealsVariableSuccessful appeals restore score

Score Range ​

Trust scores are normalized to a numeric range. Higher scores indicate more reliable governance participation:

RangeLevelVoting Weight
80-100High Trust1.5x weight
50-79Normal1.0x weight
20-49Low Trust0.75x weight
0-19Minimal0.5x weight

Weighted Voting

Trust score weighting only applies when weighted voting is enabled in the workspace governance configuration. Otherwise, all votes have equal weight.

Viewing Trust Scores ​

Via the Web UI ​

Navigate to Workspace Settings > Governance > Trust Scores to see all member scores and history.

Via the API ​

bash
# Get trust scores for the workspace
curl -H "Authorization: Bearer <token>" \
  http://localhost:8080/api/trust-scores

# Get a specific user's trust score history
curl -H "Authorization: Bearer <token>" \
  http://localhost:8080/api/trust-scores/<user_id>/history

Trust Score History ​

Every change to a trust score is recorded in the trust_score_logs table with:

  • The user affected
  • Previous and new score values
  • The reason for the change
  • Timestamp
  • Related proposal or decision (if applicable)

This history provides transparency into how scores evolve over time.

Appeals ​

If a member believes their trust score was unfairly affected, they can file an appeal:

  1. Navigate to their trust score history.
  2. Click Appeal on a specific score change.
  3. Provide a reason for the appeal.
  4. Workspace admins review and decide on the appeal.

Successful appeals restore the score change. Appeal records are preserved in the audit log.

bash
# File an appeal
curl -X POST http://localhost:8080/api/trust-scores/<user_id>/appeals \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d '{"reason": "Score decreased due to a test proposal that was not meant for production."}'

Impact Reviews ​

Trust scores are one input into impact reviews -- assessments of how a proposal or decision affects the project. Impact reviews include:

  • Quantitative metrics (estimated effort, risk level, scope)
  • Qualitative assessments from review participants
  • Historical data from similar decisions

Next Steps ​

Released under the Apache-2.0 License.