크라우니결정 설명서

확률이 아니라 결정을 준다

작성일 2026-09-29 · 버전 crowny-decide/0.1.0 · 이 문서는 제품 설명과 정량 비교를 함께 담습니다.

1. 무엇을 하는 부품인가

어떤 확률이든 넣으면 티·옴·타·음 네 가지 결정으로 돌려줍니다. 로컬에서, 토큰 없이, 규칙을 전부 보여주면서.

이 엔진은 답을 쓰지 않습니다. 소프트웨어가 곧바로 분기에 쓸 수 있는 결정과 그 결정의 근거를 돌려줍니다. 확률 하나를 받아 "실행할까 보류할까 버릴까 넘길까"를 매 제품마다 다시 정하던 임계 로직을, 규칙이 공개된 부품 하나로 대체하는 것이 목적입니다.

2. 4상 판정

모른다와 잴 수 없다는 다릅니다. 옴은 근거를 더 모으면 풀리고, 음은 이 엔진의 일이 아닙니다.

판정식 (전문 공개)

c = p - 50
c >  d   → 티 (실행)
c < -d   → 타 (폐기)
|c| <= d → 옴 (검색)
p ∉ [0,100] → 음 (이관)
데드존 d 기본값 = 10

임계값이 어디인지 물어보세요. /v1/rules가 식을 그대로 돌려줍니다.

보정 — 스스로 보수적으로 조정한다

판정 뒤에 실제 결과를 /v1/feedback으로 알려주면 장부에 쌓이고, 데드존이 AIMD로 움직입니다.

티/타 적중률 < 80%  → d + 2
둘 다 ≥ 90%        → d - 2
d 범위 [2, 40] · 표본 3 미만 → "미측정"

맞았는지 틀렸는지 알려주면, 자신감을 스스로 낮춥니다. 표본이 셋 미만이면 '미측정'이라고 말합니다.

3. 줄 형식 (5종)

4. HTTP API

결정 응답

{"ok":true,"engine":"crowny-decide/0.1.0","type":"noul",
 "phase":"티","code":"T","trit":1,"action":"실행","p":70,"detail":"-"}

phase ∈ 티/옴/타/음 · code ∈ T/O/A/U · action ∈ 실행/검색/폐기/이관 · p 0..100 또는 −1(측정불가). 기존 6키는 동결(추가만 허용).

배치 JSON · 텍스트 경로

숫자 필드 없이 최상위 state(자유 텍스트)와 질문별 instructions만 주면 규칙기반 텍스트 경로가 돕니다. 외부 모델 호출 0회, 토큰 0.

POST /v1/decide  Content-Type: application/json
{"state":"카드가 이중결제되었습니다 과금 오류입니다",
 "questions":{"pay":{"type":"noul","instructions":"결제 문제인가?"}}}

{"ok":true,"dict_rows":366,"engine":"crowny-decide/0.1.0","deadzone":10,
 "answers":{"pay":{"type":"noul","phase":"티","code":"T","trit":1,"action":"실행","p":100,
   "evidence":[{"word":"이중결제","polarity":1,"weight":3},{"word":"오류","polarity":1,"weight":3}],
   "matched":2,"domain":"결제","unknown_ratio":0,"reason":"ok"}},
 "summary":{"티":1,"옴":0,"타":0,"음":0}}

질문 ≤32 · state ≤8,000자 · instructions ≤512자 · evidence ≤32건(초과분은 evidence_more). reason은 ok·no_polarity_match·polarity_balanced·instruction_unmapped·unknown_ratio_high 등 10종.

오류 응답

입력이 규격 밖이면 4xx invalid_line, 입력은 규격 안인데 판단 근거가 없으면 200 phase:"음"입니다. 전자는 호출자 버그, 후자는 정직한 판정입니다.

5. 연결 방법

HTTP

curl "http://127.0.0.1:9562/v1/decide?q=noul%7C70"

MCP

{"mcpServers":{"crowny-decide":{"command":"/bin/bash",
 "args":["~/.crowny/도구/tiomta-judge/현재/mcp/mcp도구.sh"]}}}

도구 decide_json은 서버와 같은 라이브러리(libs/텍스트경로.한선)를 쓰므로 텍스트 판정 결과가 HTTP와 동일합니다.

SDK · CLI

가져오기 "sdk/결정클라이언트.한선"     // 한선씨
const decide = require('./sdk/decide.js') // JS
bin/decide 'noul|70'                      // CLI
bin/decide-server                         // 서버 상주

요건: crownyc 바이너리(peer, 미동봉). bin/설치검증.toau가 부팅 게이트로 확인합니다.

6. 외부 결정 모델(Jev) 대비 정량 비교

측정 조건: 2026-09-29, 격리 포트 9583, dict_rows=366, 로컬 루프백 왕복 포함. 비교군은 TypeSafe AI의 Jev(jev-1.13.0)이며, Jev 실 API 왕복은 0건(키 미보유)이라 Jev 값은 전부 공표값입니다. 우위는 4상 — 티=우리 우위, 옴=조건부, 타=Jev 우위, 음=비교불가.

우위 계수 — 티 8 · 옴 5 · 타 2 · 음 3 (총 18지표).

표본이 말해주는 것 한 줄

정확도를 가르는 것은 어휘가 아니라 문장 구조입니다. 도메인 사전 행수와 도메인별 정확도 사이에 상관은 보이지 않았습니다(행수 최다인 긴급 50행이 70.0%, 만족 44행이 100%).

7. 이 엔진이 못 하는 것

• 풍자·반어 — 탐지조차 못 하고 조용히 틀립니다. 반어가 흔한 입력원에는 텍스트 경로를 쓰지 마십시오.
• 양보·조건절 — -지만은 주절을 가중하지 않고, -면은 가정을 사실로 셉니다. 복문 정확도 40.0%의 직접 원인입니다.
• 부정 결속이 절 경계를 넘는 결함(미수리) — 안전하며 이상 없습니다가 위험=티로 뒤집힙니다. 60문장 중 유일한 반대 방향 오답이며, reason:"ok"·p=100으로 확신을 갖고 틀리므로 하류에서 걸러낼 신호가 없습니다. 수리 전까지 위험 도메인 부정문 판정에 쓰지 마십시오.
• 비교급·장문 다단 추론 — 단어 가방 방식의 범위 밖입니다.
• 다국어 — 비한국어 입력은 전량 음이며, 호출 전에 걸러내는 기능도 아직 없습니다.
• 고동시성 — 동시 10에서 개별 지연이 9.2배(16.12→148.50 ms)로 늘어납니다. 동시성 요구가 크면 프로세스를 여러 포트로 분산하십시오.

8. 권고

하이브리드로 쓰면 이렇게 됩니다. 1차로 이 엔진을 통과시키고, reason이 no_polarity_match·polarity_balanced·instruction_unmapped인 답만 상위 모델로 넘깁니다. 60문장 실측에서 유료 경로로 넘어가는 비율은 18.3%였습니다. 반대로, 상위 모델이 낸 confidence를 noul|<confidence×100> 줄로 다시 이 엔진에 넣으면 임계 판정과 행동 지시를 한 곳에서 받을 수 있습니다.

표본 단서 — 정확도 수치의 근거인 60문장은 내부에서 직접 작성한 표본이며 실서비스 로그가 아닙니다. 사전 어휘를 알고 쓴 문장이 섞여 낙관 편향이 있을 수 있습니다. 실서비스 로그 300문장 재측정 전까지 이 수치를 대외 단독 근거로 쓰지 마십시오.