Use cases· Last updated

Citation production rollout with Jev

A generator produced a claim and a source pointer. Jev answers whether the source supports the claim. Code decides publish, hedge, or strip the citation.

This unofficial page is the production rollout slice of the citation checking pack. Intent: apply the Jev (TypeSafe System One) decision model to citation checking production rollout. Primary search language: Citation Jev production rollout. Confirm patterns on docs.typesafe.ai. This site does not sell, issue, or proxy TypeSafe keys. Use a credential you already have from the console or a documented gateway.

Independent angle (cover ≠ clone): Cite vs generate boundary + failure modes. Cover the citation-check intent; do not mirror a citation-check-noul recipe slug.

Citation use-case context

Production rollout for citation checking is Operate-pillar work: pin, shadow, canary, abort. It is not a launch-checklist clone of a rival “build with System One” guide — we only talk about this pack’s blast radius (showing a public citation next to a customer answer).

Hub: RAG passage classification. Compare, when the other tool is the real job: citation services.

Production Rollout inputs

Ship the contracted payload, the pinned id, and a documented safe default when the API is unavailable:

{
  "claim": "Pro plans include a 14-day refund window.",
  "source": { "id": "kb-refunds", "quote": "Pro subscribers may request a refund within 14 days of purchase." },
  "answer_draft": "Yes — you have two weeks on pro."
}

Decision signals and actions

Stage What changes Citation rule
Shadow Nothing customer-visible Log publish/hedge/strip; keep showing today’s citations.
Canary One low-blast slice auto-acts Enforce strip on contradicts only.
Abort Auto-act off New claim schema or source corpus → replay the gold set.

Keep the workflow code you already designed:

def cite(ans):
    if ans["contradicts"].noul >= T_CONTRA:
        return "strip_or_rewrite"
    if ans["supports"].noul >= T_SUP and ans["sufficient"].score >= 2:
        return "publish_with_source_id"
    return "hedge_or_review"

Do not treat a Noul of 0.5 as a “medium” citation checking score — it means yes and no are equally likely. Conjunctions stay in your code.

Guardrails and escalation

Safe default if System One errors or confidence is low: do not show a public citation next to the customer answer. TypeSafe’s confidence-gated examples use a lower bar for recoverable reads than for irreversible actions. Those numbers are illustrations. For citation checking, treat public_citation as the high bar (showing a public citation next to a customer answer). Tune on labels — see offline evaluation.

Evaluation and rollout notes

Promotion gate = evaluation green on the pinned id + audit traces for the canary. Pin jev-1.13.0 (the versioned id) after you fit thresholds. jev-latest and the marketing line jev-1.13 can move. Log the response model. TypeSafe’s published list price for jev-1.13 is $0.042 per million input tokens (vendor claim — confirm on the models page); output tokens are free on that same page. Unused distractors still bill as input.

Official Python and JavaScript SDKs read TYPESAFE_API_KEY and retry documented 429/529. This site does not sell, issue, or proxy TypeSafe keys. Use a credential you already have from the console or a documented gateway.

Pack map

Slice Page
Graph and primitives decision workflow
What may enter state input contracts
What to gather first evidence collection
Atomic rules policy checks
Act / review / abstain confidence thresholds
Reviewer payload human handoff
What to persist audit trail
How it breaks failure modes
Labeled replay evaluation
Shadow → canary you are here

FAQ

Can I ship on jev-latest? Pin jev-1.13.0 (the versioned id) after you fit thresholds. jev-latest and the marketing line jev-1.13 can move. Log the response model. Shadow first.

What is the safe default if System One is down? Fail closed on showing a public citation next to a customer answer. Do not guess.

Where is the rest of the Citation pack? Start with Citation evaluation and Citation confidence thresholds. Cluster hub: Use cases.

Can Jev write the bibliography? No. It judges support. Formatting and URL fetching stay in code or another tool.

Is this the same as RAG passage relevance? Related but not the same intent. Relevance is “can this passage help?” Citation is “does this quote support this claim?”

What this page does not claim

Disclaimer

This is an independent unofficial site and is not affiliated with TypeSafe AI; official documentation is available at https://docs.typesafe.ai.

Primary documentation: https://docs.typesafe.ai. Hub: Use cases.

Sources

Public TypeSafe or adjacent documentation only. No private claims.