Обзор базы знаний жил как `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>
70 lines
2.2 KiB
Python
70 lines
2.2 KiB
Python
from __future__ import annotations
|
|
|
|
from stewardship.cli import main
|
|
|
|
|
|
def test_validate_exit_codes(make_repo, negative_repo):
|
|
good = make_repo("positive/infra-lxd")
|
|
assert main(["validate", "--repo", str(good), "--output", "json"]) == 0
|
|
|
|
bad = negative_repo("secret-field")
|
|
assert main(["validate", "--repo", str(bad), "--output", "json"]) == 1
|
|
|
|
|
|
def test_missing_repository_returns_exit_3(tmp_path):
|
|
missing = tmp_path / "does-not-exist"
|
|
assert main(["validate", "--repo", str(missing), "--output", "json"]) == 3
|
|
|
|
|
|
def test_context_strict_truncation_returns_exit_4(make_repo):
|
|
repo = make_repo("positive/infra-lxd")
|
|
code = main(
|
|
[
|
|
"context",
|
|
"--repo",
|
|
str(repo),
|
|
"--intent",
|
|
"container.deploy",
|
|
"--materialize",
|
|
"--budget-bytes",
|
|
"1",
|
|
"--strict",
|
|
"--output",
|
|
"json",
|
|
]
|
|
)
|
|
assert code == 4
|
|
|
|
|
|
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
|