Jev 지식관리 실습 키트 v2 (입력 + 검색)
==========================================

TypeSafe System One(Jev)에 보내는 요청 파일 6개입니다.
노트를 어디에 넣을지(입력 라우팅 3종)와 검색 후보 중 무엇을 고르고 남길지(검색 3종)를 연습합니다.
원칙은 하나입니다. Jev는 제안하고, 실행은 코드와 사람이 합니다.

모든 예시 문장, 노트 제목, 프로젝트 이름은 이 키트를 위해 새로 쓴 가상 데이터입니다.
실제 노트 원문, 사람 이름, 파일 경로는 들어 있지 않습니다.
공개 전에 이 요청 파일 6개를 실행해 보지 않았으므로, 응답값은 직접 확인하세요.


파일
----
s1-cmds-routing.json            입력  Choice 8 + 보류        정의를 붙인 서브카테고리 분류 (87개 중 8개 발췌)
s2-vault-routing.json           입력  Choice 2 + 보류        개인 볼트 대 위키 볼트
s3-project-routing-l1-l2.json   입력  Choice 6 + 보류, 질문 2개  프로젝트 이름만(L1) 대 이름 + README 요약(L2)
s4-retrieval-choice.json        검색  Choice 8 + 해당 없음    검색 후보 8개 중 하나 고르기
s5-retrieval-noul-keepset.json  검색  Noul 8개               후보마다 예/아니오로 유지 집합 만들기
s6-reverse-order-reask.json     입력  Choice 8 + 보류, 질문 2개  선택지 순서를 뒤집어 다시 묻기


쓰는 법 1: 웹 Playground
------------------------
1. https://console.typesafe.ai/playground 에 로그인합니다.
2. State 칸에는 파일의 "state" 값만, Questions 칸에는 "questions" 값만 붙여 넣습니다.
   파일 전체를 붙이면 안 됩니다.
3. 모델이 jev-latest인지 확인하고 실행합니다.
S6은 선택지 순서 자체가 실습 내용이므로, JSON 키 순서를 바꾸는 포매터를 거치지 마세요.


쓰는 법 2: 터미널 curl
----------------------
API 키는 https://console.typesafe.ai/ 에서 만들고, 아래 YOUR_KEY 자리에만 넣습니다.
키를 노트, 파일, 채팅에 붙이지 마세요.

  curl -sS -X POST https://api.typesafe.ai/v1/systemone \
    -H "Authorization: Bearer YOUR_KEY" \
    -H "Content-Type: application/json" \
    -d @s1-cmds-routing.json

여섯 개를 차례로 보내려면:

  for f in s*.json; do
    echo "== $f"
    curl -sS -X POST https://api.typesafe.ai/v1/systemone \
      -H "Authorization: Bearer YOUR_KEY" -H "Content-Type: application/json" \
      -d @"$f"
    echo
  done

응답에서 볼 필드
- answers.<질문 이름>: Choice는 choice, probabilities, confidence. Noul은 noul 하나(confidence 없음).
- model: 실제로 실행된 모델 버전. 비교하려면 요청의 model을 jev-1.13.0으로 고정하고 이 값을 기록하세요.
- usage.input_tokens: 과금 기준. 가격은 입력 100만 tokens당 $0.042이며, 실행 전 공식 페이지에서 다시 확인하세요.


코드가 적용할 규칙
------------------
- Choice: probabilities의 최댓값을 제안으로 씁니다. 1위와 2위가 같으면 보류, 1위가 보류나 해당 없음이면 사람에게 넘깁니다.
- S6: 두 순서의 1위가 다르면 보류하고 사람이 판정합니다.
- Noul: 문턱을 넘을 때만 유지합니다(엄격 부등호). 값이 문턱과 정확히 같으면 유지하지 않습니다.
- 문턱을 과제 사이에 복사하지 않습니다. 선택지가 적은 과제에서 맞던 confidence 구간이 87개 분류에서는 맞지 않았습니다.
- 여러 질문의 확률을 더하거나 곱해 새 지표를 만들지 않습니다.
- Jev 답은 제안 칸에만 저장합니다. 파일 이동, 메타데이터 수정, 삭제, 발행은 규칙을 가진 코드와 승인한 사람이 합니다.
- Jev가 응답하지 않으면(429, 529) 기능이 코드 규칙만으로 돌아가게 둡니다.


내 노트로 바꿔 쓸 때
--------------------
- 요청은 미국에 호스팅된 외부 API로 갑니다. 입력을 학습에 쓰지 않는다는 정책이지만, 무보관(ZDR)은 기본이 아니라 기업용 옵션입니다.
- 사람 정보, 회의나 대화 기록, 건강 정보, 가족 이야기, 고객 자료가 든 노트는 보내기 전에 코드로 거르세요.
  이메일, 전화번호, 로컬 경로는 가리세요.
- 이 규칙을 그대로 적용하면 S4, S5의 회의 관련 질의는 보내지 않는 것이 맞습니다. 이 키트의 문장은 가상이라 연습용으로만 둡니다.
- state에는 판단에 필요한 필드만 넣습니다(예: 제목 200자, 요약 600자, 태그 8개, 본문 앞 1,200자).
  개수나 날짜 계산은 Jev에게 묻지 말고 코드가 계산한 값을 넣습니다.
- 실제로 보낸 요청, 응답, 응답의 model을 파일로 남겨 두면 나중에 문턱을 다시 잡을 때 씁니다.


수치 읽는 법
------------
각 시나리오의 근거 수치는 2026-09-26 1라운드 실측(jev-1.13.0, 1,557회 호출, 전부 HTTP 200)입니다.
정답은 사람이 새로 매긴 라벨이 아니라 볼트에 이미 있던 분류값과 위치였습니다.
그래서 모든 수치는 "이미 있는 판단을 얼마나 재현하는가"로만 읽습니다.

Yohan Koo (CMDSPACE), https://cmdspace.work