A registry system for kb-pack submissions with validation, indexing, and metadata management. Provides tools for validating pack submissions, rebuilding registry indices, and managing pack metadata.
Two tools with clear, detailed descriptions (194 - 250 chars, well above baseline 34 - 392 range). Input schemas present with type definitions. However, output schemas are completely undocumented, LLMs cannot plan downstream calls or extract results. No parameter descriptions beyond the tool level. Error handling is implicit (exit codes 0/1/2) but not actionable for LLM recovery. No tool annotations (readOnlyHint/destructiveHint). Tool naming is verb-forward (validate_*, rebuild_*) and unambiguous. Composition is sound: two separate concerns, no 'and' coupling. Missing: per-parameter descriptions, output schema documentation, error recovery guidance.
Rebuild index.json and stats.json for the kb-registry. Scans packs/ directory for all {pack_id}-{version}.tar tarballs, aggregates them per pack_id with sorted versions list and latest_version pointer, and derives stats.json from the same data. Preserves counters (subscribe_count / cite_count) from existing stats.json. Idempotent: running twice on the same git state produces byte-identical output.
Pre-merge validator for a single kb-registry pack submission. Runs seven checks in order: tarball integrity, manifest validation, signature verification, pack root verification, content schema validation, experience content validation, and README validation. Exits with code 0 on success, 1 on check failure, 2 on environment error.
Output schemas completely undocumented. LLMs cannot infer what validate_pack or rebuild_index return, blocking downstream tool chaining and result extraction.
Input parameter 'pack_tar_path' and 'registry_root' lack descriptions. LLMs cannot infer format, constraints, or expected values (absolute vs relative path, required vs optional).
Error handling relies on exit codes (0/1/2) with no actionable recovery guidance. LLMs cannot distinguish 'check failed' from 'environment error' or know what to do next.
No tool annotations. rebuild_index is destructive (WRITE risk) but lacks destructiveHint. validate_pack is read-only but lacks readOnlyHint. Agents cannot reason about side effects.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 46 | 2026-07-28+ | v2 |
rebuild_index 'registry_root' parameter marked optional with default CWD, but no guidance on absolute vs relative paths or validation. LLMs may pass invalid paths.