SigRank — AI Operator Benchmarking

SignalAF · SigRank ウェブアプリ

signalaf.comで、AI オペレーターのトークンテレメトリーを閲覧し、個人プロフィールを確認し、トークンカスケードの指標を比較できます。

ライブサイト · リーダーボード · 測定方法 · CLI と MCP · ローカルセットアップ

このリポジトリには、リーダーボードのホームページ、オペレータープロフィール、比較、Hall of Signal、編集ページ、アカウント、課金、サーバー API を含む Next.js アプリケーションが含まれています。

サイトを閲覧する

セクション	できること
リーダーボード／ホームページ	期間とプラットフォームでフィールドを絞り込み、RAW 指標と派生指標を確認できます
オペレータープロフィール	個人統計、送信履歴、バッジ、アカウント設定を確認できます
比較	2 人のオペレーターのテレメトリーと指標の差を調べられます
Hall of Signal	記録とバッジ一覧を閲覧できます
SigRank の概要	測定と登録の流れを理解できます
Field、記事、ブログ、Wiki	研究、解説、指標の定義を読むことができます

一部の機能は制限されています。機能フラグをご覧ください。この README はソースツリーについて説明するものであり、すべてのデプロイで任意の連携が設定されていることを保証するものではありません。

自分の結果を取得する

このアプリケーションを使うために、クローンする必要はありません。CLI/MCP パッケージを実行してください。

npx sigrank                       # inspect local usage in the terminal
npx sigrank enroll                # bind your device using a Settings connect code
npx sigrank submit --dry-run      # inspect the payload without sending it
npx sigrank submit                # publish a signed snapshot

signalaf.comにサインインして、接続コードを作成してください。元のボードに掲載されたプロフィールの所有権を申請するには、[email protected] を通じた所有権確認が必要です。

測定内容

4 つのトークン柱、すなわち入力、出力、キャッシュ書き込み、キャッシュ読み取りがカスケードに反映されます。Yield は次の式で計算されます。

Υ = (cache_read × output) / input²

サーバーは送信内容を検証し、再スコアリングします。Leverage、Velocity、SNR、10xDEV はトークン処理のパターンを表すもので、モデルの品質、作業の品質、生産性、またはビジネス成果を測る指標ではありません。

Upsilonは測定エンジン、SigRankはSignalAF上の公開リーダーボード兼証明の場です。プロトコルの仕様はTTEOPに準拠します。定義と制限事項については、測定方法とWikiをご覧ください。

順位付けされたテレメトリーに、プロンプトのテキスト、応答、ソースコードは必要ありません。送信内容には、ID、デバイス／署名、プラットフォーム、レポートのメタデータも含まれます。CLI のプライバシーに関する詳細をご覧ください。

技術スタック

• Next.js 16 App Router、React 19、TypeScript（strict）
• Tailwind CSS 3
• Supabase（Postgres、Auth、Realtime）
• Stripe Checkout、Billing Portal、webhooks
• レート制限用の Upstash Redis（Supabase Postgres へのフォールバック）
• zod、Node test runner、Vitest、Playwright

ローカルセットアップ

Node 22.x が必要です（package.json の engines、.nvmrc）。

npm install
cp .env.example .env.local   # optional; see Environment
npm run dev                  # http://localhost:3000

未設定のローカル開発では、対応する読み取りパスでスナップショットデータまたはデモデータを使用できます。これはライブテレメトリーではありません。ライブボードのデータ、認証、署名付き書き込み、課金を利用するには、それぞれに対応するサービスを設定する必要があります。一致するレコードがない設定済みデータベースでは、オペレーターの履歴を捏造せず、空の結果を返します。

スクリプト

コマンド	説明
npm run dev	開発サーバーを起動します
npm run build	本番環境向けにビルドします（next build --webpack）
npm run start	本番ビルドを配信します
npm run lint	ESLint を実行します
npm test	__tests__/ 内の Node テストスイートを実行します
npm run test:ui	Vitest のコンポーネントテストを実行します
npm run test:canonical	canonical ingest の整合性を確認します（MO§ES Υ 18436.98）
npm run test:coverage	c8 のカバレッジ計測付きで npm test を実行します
npm run e2e	Playwright テストを実行します（e2e:local は localhost:3000 を対象とします）
npm run verify	tsc --noEmit、canonical テスト、npm test を実行します
npm run db:parity	ローカルのマイグレーションとリモートの台帳を比較します（CI では db:parity:ci を使用します）
npm run snapshot	コールドストアのボードスナップショットを更新します
npm run sitemap:validate	サイトマップを検証します（:live は本番環境を確認します）

PR を作成する前に、npm run verify と npm run build を実行してください。

環境

.env.example を .env.local にコピーしてください。すべての変数と説明が記載されています。値をコミットしないでください。本番環境の値は Vercel の環境変数に設定されています。

変数	用途
NEXT_PUBLIC_SUPABASE_URL、NEXT_PUBLIC_SUPABASE_ANON_KEY、SUPABASE_SERVICE_ROLE_KEY	Supabase のライブ読み取りとサービスロールによる書き込み。サーバークライアントには3つすべてが必要です。
STRIPE_SECRET_KEY、NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY、STRIPE_WEBHOOK_SECRET、STRIPE_PRICE_*	課金と Webhook
NEXT_PUBLIC_SITE_URL	Stripe のリダイレクトと公開 URL
UPSTASH_REDIS_REST_URL、UPSTASH_REDIS_REST_TOKEN（または Vercel の KV_REST_API_URL、KV_REST_API_TOKEN）	共有レートリミッター。Upstash がない場合、リミッターは Supabase Postgres（api_rate_limit_hit、マイグレーション 0055）を使用し、その後インスタンスごとのインメモリーカウンターを使用します。機密性の高い書き込みルートはフェイルクローズします。
SIGRANK_RULESET	サーバー専用の RS.xx スコアリング上書き設定
SIGRANK_API_KEY	公開 API 用の信頼された一括読み取りキー（x-api-key）
SIGRANK_INGEST_WRITE	1 にすると、検証済みスナップショットをボードに永続化します。
CRON_SECRET	/api/cron/recompute 用のベアラートークン
NEXT_PUBLIC_POSTHOG_KEY、NEXT_PUBLIC_POSTHOG_HOST、POSTHOG_KEY	プロダクト分析
RESEND_API_KEY、*AGENTMAIL_API_KEY	お問い合わせフォームと取引メール
ALGOLIA_*、EXA_API_KEY、MOTHERDUCK_*、AI_GATEWAY_*、VERCEL_CLIENT_*、SIGNALAF_LIVE_TOKEN	検索、エンリッチメント、分析、AI ゲートウェイ、Vercel 連携、ライブデモ
NEXT_PUBLIC_REALTIME_ENABLED	false に設定すると、ボードのライブ更新を無効にします

フィーチャーフラグ

フラグは lib/features.ts で定義されています。ゲートが設定されたフラグはすべてデフォルトでオフで、1 または true を指定できます。

フラグ	制御対象
NEXT_PUBLIC_GATE_CHALLENGES	投げ合いチャレンジ。NEXT_PUBLIC_GATE_ARENA も必要です。オフの場合、/api/v1/challenges は 404 を返します。
NEXT_PUBLIC_GATE_ARENA	チャレンジ投稿インターフェース（チャレンジゲートと併用が必要）
NEXT_PUBLIC_GATE_SIGNAL_DROP	週間シグナルドロップ
NEXT_PUBLIC_GATE_BRACKETS	ブラインドブラケット／Circle Wars
NEXT_PUBLIC_GATE_TRADING_CARD_SPECIES	トレーディングカード上の種バッジ

データベースとマイグレーション

マイグレーションは supabase/migrations/ にあります。ハードコードされたマイグレーション数に頼らず、このディレクトリと npm run db:parity を使用して、現在のスキーマとリモート台帳の状態を確認してください。依存するコードをデプロイする前に、必要なマイグレーションを適用してください。適用前に、保留中の SQL と対象プロジェクトを確認してください。

Row Level Security ポリシー、シードデータ、セキュリティテストは supabase/ にあります。独自のインスタンスを実行する方法については、supabase/README.md を参照してください。

プロジェクトマップ

パス	内容
app/	App Router のページと API ルート
app/api/v1/	公開 API：取り込み、請求、デバイス、課金、メトリクス、リーダーボード
app/api/mcp/, app/api/plugins/sigrank/mcp/, app/api/exchange/mcp/	MCP エンドポイント（メインサーバー、アナリストプラグイン、交換）
app/exchange/, app/api/exchange/	貢献交換の UI と API
components/	UI コンポーネント
lib/board/	ボードの読み取り：Supabase、スナップショット、モックへのフォールバック
lib/ingest/	ペイロードの解析、署名チェック、カスケードの実体化
lib/analytics/	スコアリングエンジンとサーバー専用ルールセットの境界
lib/exchange/, lib/exchange-gateway/	交換サーバーのロジックと移植可能なゲートウェイのリファレンス
lib/infra/	Supabase クライアント、Stripe、レート制限、API ゲート
supabase/	マイグレーション、ポリシー、シード、SQL テスト、エッジ関数
__tests__/, e2e/	Node、Vitest、Playwright のテスト

開発規約：

• ページはデフォルトでサーバーコンポーネントです。フック、ハンドラー、またはブラウザー API を使う場合にのみ 'use client' を追加してください。
• RS.xx のスコアリング設定をクライアントコードに含めないでください。
• モジュールスコープでランダム値や実時間の読み取りを行わないでください。

デプロイ

main へのプッシュで Vercel にデプロイされます（vercel.json）。毎日の cron が /api/cron/recompute を呼び出します。環境変数は Vercel で設定してください。OpenNext を使う Cloudflare 向けの手順もあります（npm run preview、npm run deploy、wrangler.jsonc）。

セキュリティ

脆弱性は非公開で報告してください。メンテナーにメールするか、非公開の GitHub セキュリティアドバイザリを作成してください。脆弱性について公開 issue を作成しないでください。SECURITY.md を参照してください。

関連情報

• sigrank-mcp：npx sigrank CLI、TUI、MCP サーバー
• signalaf.com/score：4 つのトークン数を入力すると、予測利回りが表示されます
• MO§ES™：Upsilon を支えるガバナンスフレームワーク

コントリビューション

再現手順と Node のバージョンを添えて、issue を作成してください。コードを変更する場合は、main からブランチを作成し、変更を小さく保ち、npm run verify を実行してから PR を作成してください。コントリビューションガイドと行動規範を参照してください。

ライセンス

MIT。LICENSE を参照してください。