feat: add Jev decisions to DebateLab by Programcode · Pull Request #60 · Programcode/DebateOwl

Programcode · 2026-09-21T18:03:12Z

Summary

add OpenRouter Jev decisions for Crossfire coaching signals, semantic source ranking/retention, and case source-use tracking
add Auto Fast for Basic and Pro users, normally routing to GLM 5.3 Flash, plus Pro-only Auto Pro for stronger models
rank the Sources menu by case use, importance, and strength with localized English, Spanish, and Hungarian labels
keep Crossfire replies independent of optional Jev work, with signed replay-bounded sidecars and complete usage accounting

Verification

npm run verify
- 1,232 unit tests passed
- 10 collaboration tests passed
- 236 Edge tests passed
- production build passed
- 219 browser tests passed; 1 unrelated navigation timing test recovered as flaky; 2 intentional skips
live OpenRouter Jev smoke passed against typesafe/jev-1.13 (returned typesafe/jev-1.13-20260917, 330 input / 33 output tokens)
exact-head review approved with no Critical or Important findings

Notes

uses the existing OPENROUTER_API_KEY; no new secret or dependency
no database migration
merge is intentionally left to Adam

Summary by CodeRabbit

New Features
- Added Auto Fast and Auto Pro model options with automatic routing and subscription-aware access.
- Added live Crossfire coaching signals for answer quality, concessions, and follow-up opportunities.
- Added semantic source assessments, including case usage, importance, relevance, and evidence strength.
- Added Smart, usage, importance, and evidence-strength sorting to the source library.
- Added localized support for English, Spanish, and Hungarian interfaces.
Documentation
- Added guidance for the new model routing, source assessments, and Crossfire coaching features.

vercel · 2026-09-21T18:03:18Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
debate-navigator	Ready	Preview	Sep 21, 2026 6:03pm UTC

Copilot

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

coderabbitai · 2026-09-21T18:03:21Z

Understand this PR’s impact

Explore downstream dependencies and potential security impact with Blast Radius.

Preview blast radius → · Advanced feature

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Free

Run ID: 9455395c-605a-40fb-83cb-2172bfe7ece5

📥 Commits

Reviewing files that changed from the base of the PR and between 8a938e1 and 249648d.

📒 Files selected for processing (53)

docs/architecture.md
docs/superpowers/plans/2026-09-21-jev-decisions.md
docs/superpowers/specs/2026-09-21-jev-decisions-design.md
docs/testing.md
e2e/crossfire.spec.ts
package.json
scripts/smoke-jev.d.mts
scripts/smoke-jev.mjs
src/components/ModelSelector.tsx
src/components/features/shared/SourceQualityList.tsx
src/lib/ai/client.ts
src/lib/ai/providers/types.ts
src/lib/ai/schemas/generate.ts
src/lib/ai/streaming.ts
src/lib/crossfire/reducer.ts
src/lib/crossfire/schemas.ts
src/lib/stores/session-store.ts
src/lib/stores/settings-store.ts
src/locales/en.json
src/locales/es.json
src/locales/hu.json
src/pages/CrossfirePage.tsx
src/pages/LibraryPage.tsx
src/test/ai/client-analytics.test.ts
src/test/ai/client-branches.test.ts
src/test/ai/crossfire-client.test.ts
src/test/ai/streaming-integration.test.ts
src/test/components/ModelSelector.test.tsx
src/test/components/SourceQualityList.test.tsx
src/test/crossfire/reducer.test.ts
src/test/crossfire/schemas.test.ts
src/test/crossfire/storage.test.ts
src/test/pages/CrossfirePage.test.tsx
src/test/pages/LibraryPage.test.tsx
src/test/scripts/smoke-jev.test.ts
src/test/security-hardening.test.ts
src/test/session-store.test.ts
src/test/settings-store.test.ts
supabase/README.md
supabase/functions/_shared/auto-model-router.test.ts
supabase/functions/_shared/auto-model-router.ts
supabase/functions/_shared/crossfire-signals.test.ts
supabase/functions/_shared/crossfire-signals.ts
supabase/functions/_shared/jev.test.ts
supabase/functions/_shared/jev.ts
supabase/functions/_shared/model-catalog.ts
supabase/functions/_shared/research.ts
supabase/functions/_shared/source-decisions.test.ts
supabase/functions/_shared/source-decisions.ts
supabase/functions/ai-stream/handler_test.ts
supabase/functions/ai-stream/index.ts
supabase/functions/ai/handler-research.test.ts
supabase/functions/ai/index.ts

Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review.

📝 Walkthrough

Walkthrough

Changes

The pull request integrates TypeSafe Jev through OpenRouter for automatic model routing, semantic source decisions, and Crossfire coaching signals. It adds validation, usage tracking, persistence, UI updates, localized text, tests, and a live smoke command.

Jev client and routing

Layer / File(s)	Summary
Shared Jev client and contracts `supabase/functions/_shared/jev.ts`, `supabase/functions/_shared/model-catalog.ts`, `supabase/functions/_shared/jev.test.ts`	Adds typed Jev requests and responses, strict validation, bounded response handling, timeout and abort support, and normalized usage data.
Automatic model routing `supabase/functions/_shared/auto-model-router.ts`, `supabase/functions/ai/index.ts`, `supabase/functions/ai-stream/index.ts`, `src/components/ModelSelector.tsx`	Adds `auto-fast` and `auto-pro`, resolves them to concrete models through Jev, preserves requested and resolved model metadata, and applies entitlement and fallback rules. Tests cover routing, streaming, persistence, and access control.

Semantic source decisions

Layer / File(s)	Summary
Source assessment and persistence `supabase/functions/_shared/source-decisions.ts`, `supabase/functions/ai/index.ts`, `src/lib/stores/session-store.ts`, `src/lib/ai/client.ts`	Adds bounded source ranking, case-use classification, semantic metadata validation, assessment persistence, provenance preservation, and weak-source retention rules.
Source library presentation `src/pages/LibraryPage.tsx`, `src/components/features/shared/SourceQualityList.tsx`, `src/locales/*.json`	Adds semantic badges, Smart and metadata-based sorting, source detail fields, and localized source-quality labels.

Crossfire signals

Layer / File(s)	Summary
Signal evaluation and attachment `supabase/functions/_shared/crossfire-signals.ts`, `supabase/functions/ai/index.ts`, `src/lib/crossfire/schemas.ts`, `src/lib/crossfire/reducer.ts`	Adds signed signal tokens, newest-exchange evaluation, Jev-backed answer signals, validation, replay prevention, and reducer attachment to answer turns.
Asynchronous Crossfire UI `src/pages/CrossfirePage.tsx`, `src/lib/ai/client.ts`, `e2e/crossfire.spec.ts`, `src/locales/*.json`	Requests signals after the main answer, aborts obsolete requests, renders quality and follow-up badges, and covers retry and delayed-signal behavior.

Smoke verification and documentation

Layer / File(s)	Summary
Live Jev smoke command `scripts/smoke-jev.mjs`, `scripts/smoke-jev.d.mts`, `package.json`, `src/test/scripts/smoke-jev.test.ts`	Adds a credentialed smoke command that sends a fixed typed request, validates the response, limits output, and reports latency and normalized usage.
Architecture and verification documentation `docs/architecture.md`, `docs/testing.md`, `supabase/README.md`, `docs/superpowers/*`	Documents the Jev client, routing, source decisions, Crossfire sidecar flow, smoke verification, constraints, and release checks.

Estimated code review effort: 5 (Critical) | ~120 minutes

Sequence Diagram(s)

sequenceDiagram
  participant Client
  participant AIEndpoint
  participant JevClient
  participant OpenRouter
  participant SessionStore
  Client->>AIEndpoint: send model, sources, or Crossfire request
  AIEndpoint->>JevClient: evaluate bounded decision
  JevClient->>OpenRouter: POST typed Jev request
  OpenRouter-->>JevClient: return validated decision and usage
  JevClient-->>AIEndpoint: return decision
  AIEndpoint->>SessionStore: persist metadata or signal state
  AIEndpoint-->>Client: return response and metadata

Note

🎁 Summarized by CodeRabbit Free

Your organization is on the Free plan. CodeRabbit will generate a high-level summary and a walkthrough for each pull request. For a comprehensive line-by-line review, please upgrade your subscription to CodeRabbit Essentials by visiting https://app.coderabbit.ai/settings/billing.

_{Comment @coderabbitai help to get the list of available commands.}

Programcode · 2026-09-21T18:13:50Z

@coderabbitai review

coderabbitai · 2026-09-21T18:13:56Z

⚠️ Action not completed

Review rate limited.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

Programcode · 2026-09-21T18:19:04Z

@coderabbitai review

coderabbitai · 2026-09-21T18:19:10Z

✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

Programcode added 9 commits September 21, 2026 15:48

docs: specify Jev decision features

eb56f86

docs: plan Jev decision implementation

b70da1a

feat(ai): add OpenRouter Jev decisions client

080de68

feat(ai): add Jev automatic model routing

2128ff4

feat(sources): rank and retain evidence with Jev

b1f22b4

feat(crossfire): add live Jev coaching signals

5a6da41

test(ai): add Jev integration verification

6dad7ec

fix(ai): harden Jev fallback and Crossfire signals

5c90825

fix(crossfire): bound Jev signal sidecars

249648d

Copilot AI lite review requested due to automatic review settings September 21, 2026 18:03

Copilot AI reviewed Sep 21, 2026

vercel Bot deployed to Preview September 21, 2026 18:03

View deployment

Programcode merged commit f49bc6c into main Sep 21, 2026
11 checks passed

Programcode deleted the t3code/assess-jev-usage branch September 21, 2026 18:49

Navigation Menu

Repository navigation

feat: add Jev decisions to DebateLab - #60

feat: add Jev decisions to DebateLab#60
Programcode merged 9 commits into
mainfrom
t3code/assess-jev-usage

Programcode commented Sep 21, 2026 •

edited by coderabbitai Bot

Loading

Uh oh!

vercel Bot commented Sep 21, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

coderabbitai Bot commented Sep 21, 2026 •

edited

Loading

Walkthrough

Changes

Sequence Diagram(s)

Uh oh!

Programcode commented Sep 21, 2026

Uh oh!

coderabbitai Bot commented Sep 21, 2026 •

edited

Loading

Uh oh!

Programcode commented Sep 21, 2026

Uh oh!

coderabbitai Bot commented Sep 21, 2026 •

edited

Loading

Uh oh!

Uh oh!

This branch was successfully deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

Programcode commented Sep 21, 2026 • edited by coderabbitai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Verification

Notes

Summary by CodeRabbit

Uh oh!

vercel Bot commented Sep 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

coderabbitai Bot commented Sep 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Changes

Sequence Diagram(s)

Uh oh!

Programcode commented Sep 21, 2026

Uh oh!

coderabbitai Bot commented Sep 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Programcode commented Sep 21, 2026

Uh oh!

coderabbitai Bot commented Sep 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

This branch was successfully deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Programcode commented Sep 21, 2026 •

edited by coderabbitai Bot

Loading

vercel Bot commented Sep 21, 2026 •

edited

Loading

coderabbitai Bot commented Sep 21, 2026 •

edited

Loading

coderabbitai Bot commented Sep 21, 2026 •

edited

Loading

coderabbitai Bot commented Sep 21, 2026 •

edited

Loading