Merge pull request #3 from Burnmydays/devin/1781533476-rarity-system

- Add rarity_class(m) mapping velocity/leverage to four tiers
- card_html(): rarity badge, passive ability, effect text, per-rarity border
- board_html(): rarity-colored left borders per row
- theme.py: rarity CSS variables, card variants, badge/passive/effect styles
- .sig-card-name defaults to --moses-ink; MYTHIC overrides to gold

Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-authored-by: Deric J. McHenry <deric.mchenry@gmail.com>

SCRATCHPAD.md

@@ -40,6 +40,23 @@ cd /Users/dericmchenry/Desktop/moses-sigrank
 
 ## WORK LOG (newest first)
 
+### Devin session — 2026-06-15 (rarity system)
+- [done] `rarity_class(m)` function added after `classify()` — maps velocity/leverage axes to
+  four tiers: MYTHIC (v≥1, l≥100), EPIC (l≥10, v<1), RARE (v≥0.5), COMMON (fallback).
+  Each tier returns (key, label, passive ability name, effect flavor text).
+- [done] `card_html()` updated — outer `.sig-card` div gets `rarity-{key}` class, new
+  `.sig-card-rarity` badge (COMMON/RARE/EPIC/MYTHIC), `.sig-card-passive` + `.sig-card-effect`
+  blocks inserted between archetype and yield. All existing elements preserved.
+- [done] `board_html()` updated — each row gets `rarity-{key}` class for colored left-border.
+- [done] `theme.py` CSS — rarity color variables (`--rarity-common/rare/epic/mythic`), board
+  row `.mb-row.rarity-*` left-borders, `.sig-card` hardcoded gold border removed (now per-rarity
+  border + box-shadow), `.sig-card-rarity` badge styles, `.sig-card-passive`/`.sig-card-effect`
+  text styles, `.sig-card-name` color changed to `--moses-ink` (rarity border carries signal),
+  MYTHIC override for yield/name color to gold.
+- [done] Verify green: `py_compile` all *.py OK · `metrics.py` canonical (Y 18436.98, lev 2042.2,
+  10xDEV 3.31, $/1M 0.527) · rarity assignments: MO§ES→MYTHIC, MapleEve/vincentkoc→EPIC,
+  cexll/iamtheavoc1→RARE, Nepomuk5665/kzquandary→COMMON.
+
 ### Devin session — 2026-06-15 (visual upgrade)
 - [done] theme.py CSS upgrade — brighter default bar gradient (0.28→0.72), `.mb-row.rank1`
   gold left-border + dominant #1 row, colored rank numbers (`.mb-rank-1/2/3`), hero upgrade

app.py

@@ -60,7 +60,13 @@ def board_html(extra=None):
         barpct=max(2,100*(1-orders/5))
         d=f"{m['dev10x']:.2f}" if m['dev10x'] is not None else "\u2014"
         rank_cls = f"mb-rank-{i}" if i <= 3 else ""
-        cls = "mb-row you" if you else ("mb-row rank1" if i==1 else "mb-row")
+        rkey = rarity_class(m)[0]
+        if you:
+            cls = f"mb-row rarity-{rkey} you"
+        elif i == 1:
+            cls = f"mb-row rarity-{rkey} rank1"
+        else:
+            cls = f"mb-row rarity-{rkey}"
         ne = _html.escape(n)
         est_mark = " <span class='mb-est' title='estimated (Codex anchor)'>~</span>" if m.get("cost_estimated") else ""
         out.append(f'<div class="{cls}">'
@@ -87,6 +93,32 @@ def classify(m):
     if v>=0.8 and l<2:  return "Volatile Ingestor \u00b7 generates, doesn't retain"
     return "Transient \u00b7 low on both axes"
 
+def rarity_class(m):
+    """Returns (rarity_key, label, passive, effect).
+    MYTHIC > EPIC > RARE > COMMON based on velocity/leverage axes.
+    Mirrors the user's trading-card design: four species of greatness.
+    """
+    v, l = m["velocity"], m["leverage"]
+    if v >= 1 and l >= 100:
+        return ("mythic", "MYTHIC",
+                "Compound Interest",
+                "Multipliers stack. Transmission \u00d7 Commitment \u00d7 Reuse = Leverage. "
+                "The rare operator the leverage/generation tradeoff says shouldn\u2019t exist.")
+    if l >= 10 and v < 1:
+        return ("epic", "EPIC",
+                "Persistent Memory",
+                "Builds reusable structures. Each cache write is read many times. "
+                "Holds context beautifully \u2014 the architecture compounds without the velocity.")
+    if v >= 0.5:
+        return ("rare", "RARE",
+                "Direct Production",
+                "Strong input-to-output conversion. Fast on single shots. "
+                "Memory doesn\u2019t persist into a compounding loop.")
+    return ("common", "COMMON",
+            "Mass Transit",
+            "Moves enormous token mass. Volume is the strategy. "
+            "Amplification is not the goal \u2014 scale is.")
+
 def comp_bar_html(c):
     return (f'<div class="comp-bar">'
             f'<div class="comp-read" style="width:{c["read"]:.1f}%"></div>'
@@ -108,6 +140,7 @@ def _first_sentence(text, limit=120):
 
 def card_html(name, m, rank, total_ops, narration_text):
     archetype = classify(m).split("\u00b7")[0].strip()
+    rkey, rlabel, passive, effect = rarity_class(m)
     c = m["composition"]
     if m["transmission"] is not None:
         cascade = (
@@ -123,10 +156,13 @@ def card_html(name, m, rank, total_ops, narration_text):
         cascade = '<div class="sig-card-cascade-box">\u2014<small>non-compounding</small></div>'
     quote = _first_sentence(narration_text)
     return (
-        '<div class="sig-card">'
+        f'<div class="sig-card rarity-{rkey}">'
         '<div class="sig-card-watermark">MO\u00a7ES\u2122 SIGRANK</div>'
+        f'<div class="sig-card-rarity rarity-{rkey}">{rlabel}</div>'
         f'<div class="sig-card-name">{name}</div>'
         f'<div class="sig-card-archetype">{archetype}</div>'
+        f'<div class="sig-card-passive">Passive: {passive}</div>'
+        f'<div class="sig-card-effect">{effect}</div>'
         f'<div class="sig-card-yield">{m["yield"]:,.0f}</div>'
         '<div class="sig-card-yield-label">net volumetric yield</div>'
         f'<div class="sig-card-rank">#<span>{rank}</span> of {total_ops} operators</div>'

theme.py

@@ -8,6 +8,10 @@ CSS = """
   --moses-line: #3A3324;
   --moses-ink: #E8E0CF;
   --moses-dim: #8a7f68;
+  --rarity-common: #6b7280;
+  --rarity-rare: #3b82f6;
+  --rarity-epic: #8b5cf6;
+  --rarity-mythic: #C4923A;
 }
 .gradio-container, .gradio-container * { font-family: ui-monospace, "SF Mono", Menlo, monospace !important; }
 .gradio-container { background: var(--moses-bg) !important; max-width: 1100px !important; margin: 0 auto !important; }
@@ -84,6 +88,10 @@ button.primary:hover, #compute-btn:hover { background: #d8a449 !important; }
   color: var(--moses-ink) !important;
 }
 .mb-row.rank1 .mb-yval { color: var(--moses-gold); font-size: 14px; }
+.mb-row.rarity-common  { border-left: 3px solid var(--rarity-common); }
+.mb-row.rarity-rare    { border-left: 3px solid var(--rarity-rare); }
+.mb-row.rarity-epic    { border-left: 3px solid var(--rarity-epic); }
+.mb-row.rarity-mythic  { border-left: 3px solid var(--rarity-mythic); }
 .mb-rank-1 { color: var(--moses-gold); font-weight: 700; }
 .mb-rank-2 { color: #a0a0a0; }
 .mb-rank-3 { color: #8a6a3a; }
@@ -108,18 +116,20 @@ button.primary:hover, #compute-btn:hover { background: #d8a449 !important; }
 .sig-card {
   width: 380px; min-height: 500px;
   background: linear-gradient(160deg, #1E1B15 60%, #2a2318);
-  border: 1px solid var(--moses-gold);
   border-radius: 12px;
   padding: 28px 24px 20px;
   font-family: ui-monospace, monospace;
   position: relative;
-  box-shadow: 0 0 40px rgba(196,146,58,0.12), inset 0 1px 0 rgba(196,146,58,0.2);
 }
+.sig-card.rarity-common  { border: 1px solid var(--rarity-common); box-shadow: 0 0 20px rgba(107,114,128,0.12); }
+.sig-card.rarity-rare    { border: 1px solid var(--rarity-rare);   box-shadow: 0 0 24px rgba(59,130,246,0.15); }
+.sig-card.rarity-epic    { border: 1px solid var(--rarity-epic);   box-shadow: 0 0 28px rgba(139,92,246,0.18); }
+.sig-card.rarity-mythic  { border: 1px solid var(--rarity-mythic); box-shadow: 0 0 40px rgba(196,146,58,0.22), inset 0 1px 0 rgba(196,146,58,0.15); }
 .sig-card-watermark {
   position: absolute; top: 14px; right: 16px;
   font-size: 9px; color: var(--moses-dim); letter-spacing: 0.1em;
 }
-.sig-card-name { color: var(--moses-gold); font-size: 22px; font-weight: 700; letter-spacing: 0.1em; margin-bottom: 4px; }
+.sig-card-name { color: var(--moses-ink); font-size: 22px; font-weight: 700; letter-spacing: 0.1em; margin-bottom: 4px; }
 .sig-card-archetype {
   display: inline-block; font-size: 10px; letter-spacing: 0.08em;
   border: 1px solid var(--moses-gold); color: var(--moses-gold);
@@ -145,6 +155,15 @@ button.primary:hover, #compute-btn:hover { background: #d8a449 !important; }
   padding: 8px 12px; margin-top: 16px; line-height: 1.5;
   font-style: italic;
 }
+.sig-card-rarity { display: inline-block; font-size: 9px; letter-spacing: 0.14em; text-transform: uppercase; font-weight: 700; padding: 2px 8px; border-radius: 2px; margin-bottom: 8px; }
+.sig-card-rarity.rarity-common  { color: var(--rarity-common); border: 1px solid var(--rarity-common); }
+.sig-card-rarity.rarity-rare    { color: var(--rarity-rare);   border: 1px solid var(--rarity-rare); }
+.sig-card-rarity.rarity-epic    { color: var(--rarity-epic);   border: 1px solid var(--rarity-epic); }
+.sig-card-rarity.rarity-mythic  { color: var(--rarity-mythic); border: 1px solid var(--rarity-mythic); }
+.sig-card-passive { font-size: 9px; text-transform: uppercase; letter-spacing: 0.1em; color: var(--moses-dim); margin: 12px 0 4px; }
+.sig-card-effect  { font-size: 10px; color: var(--moses-dim); font-style: italic; border-left: 2px solid #3A3324; padding: 6px 10px; margin-bottom: 14px; line-height: 1.5; }
+.sig-card.rarity-mythic .sig-card-yield { color: var(--rarity-mythic); }
+.sig-card.rarity-mythic .sig-card-name  { color: var(--rarity-mythic); }
 .sig-card-footer {
   position: absolute; bottom: 16px; left: 24px; right: 24px;
   font-size: 9px; color: #5f573f; letter-spacing: 0.06em;