Tru8 Evidence Research

Tru8 — AI を活用した証拠調査プラットフォーム

Tru8 は証拠を整理し、何が重要かを判断できるようにします。主張または URL を送信すると、Tru8 はオープンウェブや専門 API から証拠を取得し、階層（一次資料／報道／論評）と種類（データ／公式情報／ニュース／分析／意見／学術資料）に分類し、主張を要素に分解して、証拠を各要素に対応付け、全体像を要約ではなく構造化して提示します。

使命：「整理するのは私たち。判断するのはあなた。」

クイックスタート

前提条件

• Docker と Docker Compose
• Python 3.11+
• Node.js 20+

1. インフラストラクチャを起動する

docker-compose up -d    # PostgreSQL 16, Redis 7, Qdrant

2. バックエンド

cd backend
python -m venv venv
source venv/bin/activate    # Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env        # Edit with your API keys
alembic upgrade head
uvicorn app.main:app --reload    # http://localhost:8000

3. フロントエンド

cd web
npm install
npm run dev    # http://localhost:3000

プロジェクト構成

tru8/
├── backend/              # FastAPI backend + evidence pipeline
│   ├── app/
│   │   ├── api/v1/       # REST endpoints (checks, agent, verify, payments)
│   │   ├── core/         # Config, auth, pricing, manifest signing
│   │   ├── models/       # SQLModel schemas (Check, Claim, Evidence, ClaimConsensus)
│   │   ├── pipeline/     # Two-phase evidence pipeline
│   │   ├── services/     # API adapters, search, payments, consensus
│   │   └── utils/        # Classifiers, deduplication, query planning
│   ├── alembic/          # Database migrations
│   ├── tru8_mcp/         # MCP server package for AI agents
│   └── tests/            # 990 unit + integration tests
├── web/                  # Next.js 14 frontend
│   ├── app/              # Pages (dashboard, developers, public reports)
│   ├── components/       # Evidence views, claim map, marketing
│   └── lib/              # API client, tiers, diagnostics
├── shared/               # Shared TypeScript types
├── docker-compose.yml    # PostgreSQL, Redis, Qdrant, MinIO (optional)
└── .claude/CLAUDE.md     # Full engineering context

パイプライン

ユーザーによる主張選択ゲートを備えた 2 フェーズパイプライン（記事モード）：

Phase 1:  Ingest → Extract claims → Classify article → Rank claims
          [PAUSE — user selects claims]

Phase 2:  Fact-check lookup → Decompose into elements → Retrieve evidence →
          Score relevance → Classify tier/type → Map evidence to elements →
          Derive orientation → Complete

Post:     Coverage recovery (Stage 5.1), video recommendations, auto-archiving

証拠は、ウェブ検索と専門ソースアダプターを通じて収集されます。

カテゴリ	ソース
ウェブ検索	Serper.dev、Brave Search、SerpAPI（フォールバックチェーン）
ファクトチェック	Google Fact-Check API
政府	GOV.UK、Hansard、GovInfo、Companies House、ONS
法律	UK Legislation (legislation.gov.uk)
経済	FRED、Marketaux、World Bank
学術	Semantic Scholar、OpenAlex、PubMed
気候	NOAA、WeatherAPI、Open-Meteo、GBIF
アーカイブ	Wikipedia（参考文献のマイニングを含む）、Library of Congress、Internet Archive
健康	WHO
スポーツ	Transfermarkt、Football-Data.org
動画	YouTube Data API

6 つの証拠ビュー

ビュー	答える質問
カートグラファー	この議論の全体像はどのようなものですか？
ライブラリアン	これは全資料を網羅し、明確にラベル付けされていますか？
インタープリター	この証拠は、このサブクエスチョンへの答えになりますか？
プロジェクショニスト	カメラの前では何が語られましたか？
クロノロジスト	証拠はいつ公開されましたか？
シーカー	まだ分かっていないことは何ですか？

API とエージェントからのアクセス

Tru8 は、AI エージェント向けに開発者 API と MCP サーバーを提供します。

エージェントコマースゲートウェイ

# Quick check (~15s, heuristic classification)
curl -X POST https://api.trueight.com/api/v1/agent/quick \
  -H "X-API-Key: $TRU8_API_KEY" \
  -d '{"claim": "UK inflation is 3.2%"}'

# Smart endpoint with tier fallback (lookup → consensus → quick → full)
curl -X POST https://api.trueight.com/api/v1/agent/check \
  -H "X-API-Key: $TRU8_API_KEY" \
  -d '{"claim": "UK inflation is 3.2%", "max_tier": "full"}'

ティア	費用	時間	提供内容
ルックアップ	~£0.02	即時	キャッシュされた過去の分析
コンセンサス	~£0.03	即時	ユーザー横断の集約された全体像（チェック数 k>=3）
クイック	~£0.07	~15s	ウェブ検索とヒューリスティック分類
フル	~£0.15	~60-90s	ウェブと専門 API、LLM による分類、要素の分解

決済方法は 3 種類です。x402（USDC/SIWE）、Skyfire（JWT）、プリペイドクレジット。

MCP サーバー

{
  "mcpServers": {
    "tru8": {
      "command": "python",
      "args": ["-m", "tru8_mcp"],
      "env": { "TRU8_API_KEY": "tru8_sk_..." }
    }
  }
}

ツール：tru8_check（階層別フォールバック付きの証拠調査）、tru8_get_result（分析を含む）、tru8_get_result_raw。

マニフェストの検証

完了したすべてのチェックには、HMAC-SHA256 署名付きマニフェストが付与されます。署名後に署名対象のフィールドが変更されていないことを検証します。

curl https://api.trueight.com/verify/{check_id}

テスト

cd backend
pytest tests/ -v                        # Full suite (990 tests)
pytest tests/unit/pipeline/ -v          # Pipeline unit tests
pytest tests/unit/agent/ -v             # Agent/commerce tests
pytest tests/integration/ -v            # Integration tests

インフラストラクチャ

サービス	ポート	用途
PostgreSQL 16	5433	プライマリデータベース（SQLModel）
Redis 7	6379	キャッシュとレート制限
Qdrant	6333	ベクトル類似性検索
MinIO（任意）	9000	ファイルアップロード用のローカル S3

認証：ダッシュボードには Clerk（JWT + JWKS）、開発者アクセスには API キーを使用します。 決済：Stripe（4 つのサブスクリプションティア）と、エージェントによる従量課金。

API ドキュメント

• Swagger UI： http://localhost:8000/api/docs
• ReDoc： http://localhost:8000/api/redoc
• ヘルスチェック： http://localhost:8000/api/v1/health/

環境変数

backend/.env.example を backend/.env にコピーします。主なグループは次のとおりです。

グループ	必須	変数
データベース	はい	DATABASE_URL
Redis	はい	REDIS_URL
認証	はい	CLERK_SECRET_KEY、CLERK_JWT_ISSUER
LLM	はい	GOOGLE_AI_API_KEY、OPENAI_API_KEY
検索	はい（少なくとも1つ）	SERPER_API_KEY、BRAVE_API_KEY、SERP_API_KEY
決済	サブスクリプションの場合	STRIPE_SECRET_KEY、STRIPE_WEBHOOK_SECRET
政府機関の API	任意	FRED_API_KEY、NOAA_API_KEY など
マニフェスト署名	任意	MANIFEST_SIGNING_ENABLED、MANIFEST_SIGNING_KEY

機能フラグ（すべて妥当な値がデフォルトで設定されています）：ENABLE_API_RETRIEVAL、ENABLE_LLM_RELEVANCE_SCORER、ENABLE_QUERY_PLANNING など。全一覧については backend/.env.example を参照してください。

ライセンス

非公開 — All rights reserved。