75 lines
2.6 KiB
JSON
75 lines
2.6 KiB
JSON
{
|
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
"$id": "https://kb.local/wire/v1/bulk_search_input.schema.json",
|
|
"title": "BulkSearchInput v1",
|
|
"description": "v0.20.2 (Todo #2): 한 줄(ndjson)당 하나의 bulk search query. `kebab search --bulk` 가 stdin 에서 줄 단위로 받는다. `query` 만 required (string — nested object 아님); 나머지는 optional. `kebab-app::bulk::parse_one` 이 source of truth.",
|
|
"type": "object",
|
|
"required": ["query"],
|
|
"properties": {
|
|
"query": {
|
|
"type": "string",
|
|
"description": "검색 텍스트. required. nested object ({\"text\":...}) 가 아니라 평문 string."
|
|
},
|
|
"mode": {
|
|
"type": "string",
|
|
"enum": ["lexical", "vector", "hybrid"],
|
|
"description": "검색 모드. optional, default `hybrid`."
|
|
},
|
|
"k": {
|
|
"type": "integer",
|
|
"minimum": 0,
|
|
"description": "반환 hit 수. optional. 생략 또는 0 → app 이 config `search.default_k` (default 10) 로 해석."
|
|
},
|
|
"trust_min": {
|
|
"type": "string",
|
|
"enum": ["primary", "secondary", "generated"],
|
|
"description": "최소 trust level (해당 level 이상 포함). optional."
|
|
},
|
|
"ingested_after": {
|
|
"type": "string",
|
|
"format": "date-time",
|
|
"description": "RFC3339 date-time. 이 시각 이후 ingest 된 문서만. optional."
|
|
},
|
|
"media": {
|
|
"type": "array",
|
|
"items": { "type": "string" },
|
|
"description": "media kind OR 필터 (`md` → `markdown` alias 정규화). optional."
|
|
},
|
|
"tag": {
|
|
"type": "array",
|
|
"items": { "type": "string" },
|
|
"description": "tag OR 필터. optional."
|
|
},
|
|
"lang": {
|
|
"type": "string",
|
|
"description": "ISO 언어 코드 필터. optional."
|
|
},
|
|
"path_glob": {
|
|
"type": "string",
|
|
"description": "doc_path glob 필터. optional (parse_one 추가 지원 필드)."
|
|
},
|
|
"doc_id": {
|
|
"type": "string",
|
|
"description": "특정 doc_id 로 제한. optional (parse_one 추가 지원 필드)."
|
|
},
|
|
"max_tokens": {
|
|
"type": "integer",
|
|
"minimum": 0,
|
|
"description": "응답 JSON token budget (chars/4 근사). optional."
|
|
},
|
|
"snippet_chars": {
|
|
"type": "integer",
|
|
"minimum": 0,
|
|
"description": "per-hit snippet 문자 cap. optional."
|
|
},
|
|
"cursor": {
|
|
"type": "string",
|
|
"description": "이전 응답의 opaque base64 cursor (pagination). optional."
|
|
},
|
|
"trace": {
|
|
"type": "boolean",
|
|
"description": "true 시 pipeline trace 캡처 (캐시 우회). optional, default false."
|
|
}
|
|
}
|
|
}
|