Reputation Commands

Reputation commands provide visibility into the trust and quality metrics of genes and creators in the Rotifer ecosystem. Reputation scores are computed from Arena performance, usage data, and stability metrics.

rotifer reputation [gene-ref]

View detailed reputation breakdown for a specific gene.

rotifer reputation [gene-ref]

Output includes:

Overall Score — weighted composite with phase-based weights (current cold-start: R(g) = 0.70·Arena + 0.05·Usage + 0.25·Stability)
Arena Score — weighted fitness history across Arena epochs
Usage Score — download count × install retention rate
Stability Score — uptime ratio × error-free rate
Epoch — current reputation computation epoch
Computed — timestamp of last computation

Example:

$ rotifer reputation 550e8400-e29b-41d4-a716-446655440000

  ── Gene Reputation ──

  Gene:           grammar-checker
  Overall Score:  0.7234

  Arena Score    ████████████████░░░░░░░░░░░░░░ 0.6812
  Usage Score    █████████████████████░░░░░░░░░ 0.8024
  Stability      ██████████████████████████░░░░ 0.6890

  Epoch:    12
  Computed: 2026-02-28T10:00:00Z
  Weights vary by ecosystem phase: W0 0.70/0.05/0.25, W1 0.60/0.20/0.20, W2 0.50/0.30/0.20

rotifer reputation —mine

View your own creator reputation. Requires authentication.

rotifer reputation --mine

Output includes:

Overall Score — R(d) = (Σ positive R(g_i) × ln(1+n)/n) + community_bonus
Genes Published — total genes authored
Total Downloads — cumulative downloads across all genes
Arena Wins — number of Arena competitions won
Community Bonus — Arena bonus (0–0.2), currently derived from arena wins

Example:

$ rotifer reputation --mine

  ── My Creator Reputation ──

  Creator:          @yourname
  Overall Score:    0.6542

  Genes Published:  8
  Total Downloads:  1,247
  Arena Wins:       3
  Community Bonus:  +0.050

  Score = (Σ positive gene reputations × ln(1+n)/n) + community bonus

rotifer reputation —leaderboard

Display the top creators ranked by reputation score.

rotifer reputation --leaderboard [--top <n>]

Flags:

Flag	Default	Description
`--top <n>`	`10`	Number of entries to display

Example:

$ rotifer reputation --leaderboard --top 5

  ── Reputation Leaderboard ──

  #   Creator             Score     Genes   Downloads Wins
  ──────────────────────────────────────────────────────────
  1   @alice              0.8912    12      5,230     7
  2   @bob                0.7456    8       3,102     4
  3   @charlie            0.6891    15      2,890     3
  4   @diana              0.6234    6       1,567     2
  5   @eve                0.5102    4       890       1

  Showing top 5 creators

Reputation Model

Gene reputation currently uses phase-based weights over Arena / Usage / Stability. In the current cold-start phase:

R(g) = 0.70 × Arena + 0.05 × Usage + 0.25 × Stability

As usage data grows, the system automatically shifts to W1/W2 weight sets. Time decay for creator reputation remains planned for v0.9 and is not active yet.

Creator reputation uses a diminishing-returns weighted sum of positive gene reputations plus a capped Arena bonus:

R(d) = (Σ positive R(g_i) × ln(1+n)/n) + community_bonus

Exit Codes

Code	Meaning
`0`	Success
`1`	Not logged in (for `--mine`), gene not found, or network error