feat(cli): add repoctl kdb, the one command whose human output is content

Обзор базы знаний жил как `python -m stewardship.kdb_table` - работало, но не
как остальной инструмент. Теперь это обычная подкоманда:

    repoctl kdb --repo .

Вписана в контракт, а не рядом с ним: `--output json|yaml` возвращает штатный
конверт с `stewardship/knowledge-overview@0.1` внутри, находки уходят в stderr,
коды возврата прежние (0, и 3 при отсутствии базы знаний).

Одно осознанное отличие от прочих команд: `--output human` печатает саму
таблицу, а не строку статуса. Для `emit` это не исключение - параметр
`human_renderer` был предусмотрен и до сих пор не использовался. Вопрос «что в
базе знаний» отвечается содержимым; строка «kdb: success» на него не отвечает.
Таблица идёт в stdout, поэтому `repoctl kdb > kdb.md` даёт чистый markdown.

Точка входа берётся из `spec.knowledge.entrypoint` контракта с откатом на
`kdb/kdb.yaml` - репозиторий, держащий базу в другом месте, не будет объявлен
не имеющим её.

Скилл kdb-table переписан на команду вместо вызова модуля. docs/repoctl.md
получил раздел. Спецификацию править не пришлось: закрытого перечня команд она
не содержит.

Тесты: три на CLI (таблица в stdout и находки в stderr, конверт в json, отказ с
кодом 3), плюс прежние два на разбор entrypoint. 159 passed, mypy strict чист.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Alexander Baranov
2026-08-27 13:07:36 +03:00
co-authored by Claude Opus 5
parent 39c7da3eb1
commit c10df0e3af
7 changed files with 158 additions and 49 deletions
+28
View File
@@ -39,3 +39,31 @@ def test_context_strict_truncation_returns_exit_4(make_repo):
def test_init_apply_without_hash_returns_exit_2(tmp_path):
code = main(["init", "--repo", str(tmp_path), "--apply", "--output", "json"])
assert code == 2
def test_kdb_prints_the_table_on_stdout_and_findings_on_stderr(make_repo, capsys):
"""Piping stdout must give clean Markdown, so findings may not land in it."""
repo = make_repo("positive/infra-lxd")
assert main(["kdb", "--repo", str(repo)]) == 0
out = capsys.readouterr().out
assert out.startswith("## ")
assert "| Topic | Intents | Documents | Facts in data |" in out
assert "### Documents" in out
def test_kdb_json_is_an_envelope_like_every_other_command(make_repo, capsys):
import json
repo = make_repo("positive/infra-lxd")
assert main(["kdb", "--repo", str(repo), "--output", "json"]) == 0
envelope = json.loads(capsys.readouterr().out)
assert envelope["command"] == "kdb"
assert envelope["outcome"] == "success"
assert envelope["data"]["schema"] == "stewardship/knowledge-overview@0.1"
def test_kdb_without_a_knowledge_base_warns_and_returns_exit_3(make_repo, capsys):
repo = make_repo("positive/infra-lxd")
(repo / "kdb" / "kdb.yaml").unlink()
assert main(["kdb", "--repo", str(repo)]) == 3
assert "KNOWLEDGE_ENTRYPOINT_MISSING" in capsys.readouterr().err
+1
View File
@@ -175,6 +175,7 @@ def test_kdb_table_reads_the_entrypoint_the_contract_declares(tmp_path) -> None:
)
out = render(tmp_path)
assert "repo:x - 1 topics, 1 documents" in out
assert "<!-- kb/index.yaml -->" in out # видно, откуда взято, раз путь нестандартный
assert "**t-one**" in out and "do-a-thing" in out
assert "(!)" in out # a stale document is marked, not silently listed