sigrank-app

# SigRank SignalAF

> **🏆 SigRank SignalAF is live: [signalaf.com](https://signalaf.com)** — the AI operator
> evaluation leaderboard. Ranks how efficiently you use AI by token cascade
> efficiency (Υ = cache_read × output / input²), not how much. Run `npx sigrank`
> to see your cascade now. _Token counts only. Never your prompts._

<div align="center">

<p><img src="./.github/assets/og-card-v2.png" alt="SigRank SignalAF — AI operator evaluation and token cascade efficiency leaderboard" width="800"></p>

**A privacy-preserving AI operator evaluation leaderboard.**

SigRank evaluates the human using the AI — not the AI model itself. Most platforms reward volume. SigRank SignalAF rewards structure.

[![CI](https://github.com/SunrisesIllNeverSee/sigrank-app/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/SunrisesIllNeverSee/sigrank-app/actions/workflows/ci.yml)
[![CodeQL](https://github.com/SunrisesIllNeverSee/sigrank-app/actions/workflows/codeql.yml/badge.svg?branch=main)](https://github.com/SunrisesIllNeverSee/sigrank-app/actions/workflows/codeql.yml)
[![audit](https://github.com/SunrisesIllNeverSee/sigrank-app/actions/workflows/dependency-audit.yml/badge.svg?branch=main)](https://github.com/SunrisesIllNeverSee/sigrank-app/actions/workflows/dependency-audit.yml)
[![Dependabot](https://img.shields.io/badge/Dependabot-enabled-025E8C?style=flat-square&logo=dependabot)](https://github.com/SunrisesIllNeverSee/sigrank-app/network/dependencies)
[![coverage](https://img.shields.io/badge/coverage-c8-brightgreen.svg?style=flat-square)](https://github.com/SunrisesIllNeverSee/sigrank-app/actions/workflows/ci.yml)
[![Lighthouse](https://github.com/SunrisesIllNeverSee/sigrank-app/actions/workflows/lighthouse.yml/badge.svg?branch=main)](https://github.com/SunrisesIllNeverSee/sigrank-app/actions/workflows/lighthouse.yml)
[![E2E](https://github.com/SunrisesIllNeverSee/sigrank-app/actions/workflows/e2e.yml/badge.svg?branch=main)](https://github.com/SunrisesIllNeverSee/sigrank-app/actions/workflows/e2e.yml)
[![live](https://img.shields.io/badge/live-signalaf.com-gold.svg?style=flat-square)](https://signalaf.com)
[![npm](https://img.shields.io/npm/v/sigrank.svg?style=flat-square&color=gold&label=sigrank)](https://www.npmjs.com/package/sigrank)
[![npm downloads](https://img.shields.io/npm/dm/sigrank.svg?style=flat-square&color=blue&label=npm%20downloads)](https://www.npmjs.com/package/sigrank)
[![GitHub stars](https://img.shields.io/github/stars/SunrisesIllNeverSee/sigrank-app.svg?style=flat-square&color=yellow&label=%E2%98%85%20stars)](https://github.com/SunrisesIllNeverSee/sigrank-app/stargazers)
[![deploy](https://img.shields.io/badge/deploy-Vercel-black.svg?style=flat-square)](https://vercel.com)
[![Next.js](https://img.shields.io/badge/Next.js-15-black.svg?style=flat-square)](https://nextjs.org)
[![React](https://img.shields.io/badge/React-19-blue.svg?style=flat-square)](https://react.dev)
[![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue.svg?style=flat-square)](https://www.typescriptlang.org)
[![Supabase](https://img.shields.io/badge/db-Supabase-green.svg?style=flat-square)](https://supabase.com)
[![Stripe](https://img.shields.io/badge/billing-Stripe-purple.svg?style=flat-square)](https://stripe.com)
[![license](https://img.shields.io/badge/license-MIT-green.svg?style=flat-square)](./LICENSE)

</div>

<p align="center">
  <a href="https://www.npmjs.com/package/sigrank"><img src="https://img.shields.io/badge/$%20npx%20sigrank-gold?style=for-the-badge&logo=npm&logoColor=white&labelColor=1a1a1a&color=daa520" alt="npx sigrank" /></a>
  &nbsp;
  <a href="https://github.com/SunrisesIllNeverSee/sigrank-app/stargazers"><img src="https://img.shields.io/badge/★%20Star%20this%20repo-yellow?style=for-the-badge&logo=github&labelColor=1a1a1a" alt="Star this repo" /></a>
</p>

## Table of Contents

- [What is SigRank SignalAF?](#what-is-sigrank-signalaf)
- [The SigRank SignalAF ecosystem](#the-sigrank-signalaf-ecosystem)
- [Get ranked (you don't need this repo)](#get-ranked-you-dont-need-this-repo)
- [How it works](#how-it-works)
- [For developers](#for-developers)
- [Stack](#stack)
- [Quick Start](#quick-start)
- [Scripts](#scripts)
- [Project Map](#project-map)
- [Data Model](#data-model)
- [Environment](#environment)
- [Supabase](#supabase)
- [Scoring Invariants](#scoring-invariants)
- [Development Notes](#development-notes)
- [Related](#related)
- [Community](#community)
- [License](#license)

|                                    The leaderboard                                    |                               Your operator profile                               |
| :-----------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------: |
| [![SigRank SignalAF leaderboard](./.github/assets/board.png)](https://signalaf.com/board/all)  | [![SigRank SignalAF operator profile](./.github/assets/profile.png)](https://signalaf.com) |
| Every operator ranked by **Υ Yield** — the architecture of the cascade, not raw spend |        Cascade layer, class, and fingerprint — all from four token counts         |

---

## What is SigRank SignalAF?

SigRank is an AI operator benchmark measuring token cascade efficiency, not AI models. It scores AI operators by **token cascade efficiency**: how much reusable signal
they create from each unit of input — not how many tokens they burn. The rank metric:

```txt
Υ = (cache_read × output) / input²
```

The board is anonymous by default, claimable by operators, and built around one
question: **is this session compounding signal, or just burning tokens?** Volume is
noise; yield is signal.

This repo is the **Next.js app behind [signalaf.com](https://signalaf.com)** — the
public board, operator profiles, the wiki, account + billing, and the scoring/ingest
engine. You don't clone this to _use_ SigRank SignalAF (see below) — you clone it to work on it.

## The SigRank SignalAF ecosystem

| Repo | What it is | Install |
|------|-----------|---------|
| **[sigrank-app](https://github.com/SunrisesIllNeverSee/sigrank-app)** (this repo) | The leaderboard — signalaf.com. Privacy-preserving operator profiles, class tiers, board rankings. | [signalaf.com](https://signalaf.com) |
| **[sigrank-mcp](https://github.com/SunrisesIllNeverSee/sigrank-mcp)** | The instrument — extracts 4 token pillars, computes the cascade, submits to the leaderboard. MCP server + TUI dashboard. | `npx sigrank` |
| **[bestuser-router-mcp](https://github.com/SunrisesIllNeverSee/bestuser-router-mcp)** | The intent layer — routes "who is the best AI user?" queries to SigRank SignalAF's leaderboard. MCP server for AI assistants. | `npx bestuser-router-mcp` |
| **[sigarena](https://github.com/SunrisesIllNeverSee/sigarena)** | The satellite — public LLM operator evals at sigeconomy.com. Read-only leaderboard, SEO/AEO surface. | [sigeconomy.com](https://sigeconomy.com) |
| **[signaf](https://github.com/SunrisesIllNeverSee/signa)** | The coach — reads your session logs, builds a taste profile, measures ASI, coaches you on token efficiency. | `npx @burnmydays/signaf` |
| **[sigrank-vscode](https://github.com/SunrisesIllNeverSee/sigrank-vscode)** | The IDE extension — see your cascade metrics inline in VS Code. | `code --install-extension sigrank.sigrank` |
| **[fundscore](https://github.com/SunrisesIllNeverSee/fundscore)** | The repo scorer — investor-readiness scoring for GitHub repos. CLI + MCP server. | `npx fundscore` |

### Also in the MO§ES™ suite

| Site | What it is |
| ---- | ---------- |
| **[SIGNOMY](https://signomy.xyz)** | Governed AI agent marketplace where ranked agents form teams, fill slots, run missions, and earn revenue under constitutional protocol. Agents are free. Operators pay. |
| **[MO§ES](https://mos2es.com)** | The governance framework that underpins SigRank SignalAF, SIGNOMY, and all governed agent operations. Structural accountability for agentic systems. |

## Get ranked (you don't need this repo)

SigRank SignalAF runs from your terminal — or wire it as an MCP server for your AI agent:

```bash
npx sigrank                 # see your cascade now (no install, no sign-in)
```

The client reads your local AI session logs on-device, derives your cascade,
and publishes to the board — **token-only, no transcript content.**

```bash
npm install -g sigrank     # bundles ccusage + tokscale + tokendash — no separate installs
sigrank enroll             # sign in: paste a connect code from signalaf.com → Settings
sigrank submit             # publish your verified runs to the board
```

Or explore first, no sign-in:

```bash
sigrank                    # full tabbed TUI: dashboard · compare · board · watch
npx sigrank board --once   # print the live leaderboard once
bunx sigrank board --once  # same, via Bun (faster startup if you have it)
```

Cautious? `sigrank submit --dry-run` prints the exact signed payload — four token
counts and a signature — and sends nothing.

```bash
$ sigrank submit --dry-run
📦 Payload (not sent):
  input:          1,251,211
  output:        11,296,121
  cache_create:     128,196
  cache_read:    2,555,179,769
  Υ Yield:          18,436.98
  class:            TRANSMITTER
  signature:        ed25519:9f3a...
```

Full CLI + MCP docs: **[sigrank-mcp](https://github.com/SunrisesIllNeverSee/sigrank-mcp)** ·
package: **[sigrank on npm](https://www.npmjs.com/package/sigrank)**.

## How it works

- **Four raw token pillars** — `input`, `output`, `cache_creation`, `cache_read` — are the
  only inputs. No message content, ever.
- The **cascade engine** derives Υ Yield, Leverage, Velocity, 10xDEV, SNR, and efficiency
  from those four numbers. The server re-scores every submission authoritatively.
- Operators are placed in **signal classes** (Transmitter, Architect, …) by their cascade
  shape, and ranked globally by Υ.
- **SIGNA RATE** is the class credential; **Υ Yield** is the rank metr