Questions for Jev builders
Builders should be able to answer these before calling the stack “done.” If you cannot, you have a demo. This is an independent interrogation, not a tutorial clone and not a TypeSafe playbook.
This page is for engineers wiring System One. jev.pro is an independent unofficial field guide — not affiliated with TypeSafe AI. Confirm facts on docs.typesafe.ai. We do not sell keys.
Open-cluster pages are independent field-guide notes. Replicas and third-party interfaces mentioned anywhere on jev.pro are not Jev and not endorsed.
Contract
- Which primitive per action?
- Where is
other? - Noul vs Choice threshold mix-up prevented?
- State filtered? Field paths backticked?
- Pin vs alias?
- Door id ≠ another door’s id?
- 429/529 backoff; 401/422 no retry?
- Dual-stack parity if you ship both?
- Trace fields complete?
Choice is an unordered set, max 255; add other / none if incomplete; returns choice, probabilities, confidence. Score is 2–10 ordered levels with a fractional expected score; keep arithmetic in code; do not treat score as dollars. Noul is P(yes); 0.5 means uncertain, not “medium.” Confidence is peakedness of the Choice/Score distribution; Noul has none. Structured instructions may be an object or array; backtick field paths. Criteria are descriptions a person could apply.
Atomic questions are composed in code. One POST, many questions. First-party API is only POST /v1/systemone (plus GET /v1/models). Do not invent undocumented extra routes. Official SDK names (confirm current docs): Python typesafe-sdk, JS @typesafe-ai/sdk. First call walkthrough: first API call.
Product
What happens on timeout? Who edits criteria? Is generation clearly out of scope?
Timeout should fail closed, not privileged auto-act. Criteria edits are a new decision contract — replay gold. Generation (emails, replies) is out of scope for Jev; decide then draft on an LLM. Scope: when to use Jev.
First PR checklist
Pin, filter, other, traces, 429/529, no generation, dual-stack smoke, gold JSONL path. If the PR is “add typesafe-sdk” only, it is not done. See implementation checklist.
Persist a decision trace. Write the action space including abstain. Ship gates: launch checklist. Security interrogation: questions for security. Architectures that skip these boxes: anti-patterns.
If you are replacing a mega-prompt, the migration guide is the dual-run path — this page is the “can you answer these?” gate after that work.
What this page does not claim
- Not a replacement for official SDK refs.
- Not official TypeSafe onboarding.
- Answering yes to every bullet is not a certification.
FAQ
Python package name?
typesafe-sdk. JS: @typesafe-ai/sdk. Confirm current docs.
Undocumented extra routes?
Don’t invent them. Evaluation is POST /v1/systemone.
Can I threshold a Choice like a Noul?
No. Use confidence (and the map) on Choice. Threshold noul on Noul.
Disclaimer
This is an independent unofficial site and is not affiliated with TypeSafe AI; official documentation is available at https://docs.typesafe.ai. Never treat jev.pro as TypeSafe official documentation. We do not sell, issue, or proxy API keys.
Open-cluster pages are independent field-guide notes. Replicas and third-party interfaces mentioned anywhere on jev.pro are not Jev and not endorsed. Hub: Open. Siblings: implementation checklist, questions for security, first api call. Canonical: https://docs.typesafe.ai.