Python-first documentary corpus factory with REST, MCP, workers and lightweight UI
KFabric's 7 tools have minimal descriptions and incomplete parameter documentation. Tool names follow verb_noun convention (discover_, collect_, analyze_, consolidate_, generate_, build_, prepare_) but descriptions are absent or trivial in the source. Input schemas are visible with basic type info (string, array) but lack enums, ranges, or validation constraints. No output schemas documented. Error handling is not evident. The server exposes domain-specific operations but lacks the LLM-optimized descriptions and parameter guidance required for reliable agent selection and invocation.
No tool descriptions visible in source code. All 7 tools lack descriptions required for LLM selection and context.
Parameter descriptions missing. All 7 tools have parameters (query_id, candidate_id, document_id, fragment_ids, corpus_id) with only type and name, no descriptions explaining what each parameter controls or its valid range/format.
No output schemas documented. Tools return results but no schema visible for what fields/structure agents should expect. Agents cannot plan downstream calls or extract data reliably.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 41 | 2026-07-28+ | v2 |
No error handling guidance. Tools marked with WRITE risk (collect_candidate, consolidate_fragments, generate_fragment_synthesis, build_corpus, prepare_index) but no error recovery patterns, retryability hints, or confirmation steps visible.
Parameter IDs lack context. Tools accept query_id, candidate_id, document_id, corpus_id, fragment_ids but no guidance on format, length, or how to obtain them. LLMs cannot infer valid values.