feat(kdb-table): render a knowledge base as a table a human can read
База знаний машиночитаема и длинна: чтобы ответить «что там вообще есть», приходилось читать файл целиком. Теперь есть отдельный вывод для человека. - `stewardship.kdb_table` - модуль, а не файл рядом со скиллом: `skills install` переносит только SKILL.md, поэтому скрипт в каталоге скилла не доехал бы до репозитория, куда скилл поставили. Как модуль он доступен везде, где есть repoctl: `python -m stewardship.kdb_table --repo <path>`. - Путь к базе знаний не угадывается: берётся `spec.knowledge.entrypoint` из `ops/contract.yaml` целевого репозитория, с откатом на `kdb/kdb.yaml`. Значит работает на любом adopted-репозитории, а не только там, где путь канонический. - Репозиторий без базы знаний получает одну строку и нулевой код возврата, а не трейсбек. - Читает через `stewardship.io`, то есть тем же ruamel, что и остальной код - новой зависимости нет. - Вне командной поверхности CLI намеренно: контракт `repoctl` - машинный вывод, а это пособие для чтения. Спецификацию менять не пришлось. Скилл `kdb-table` зарегистрирован в SKILLS, поэтому расходится штатным `repoctl skills install` вместе с остальными тремя. Он тонкий: зовёт модуль, печатает markdown как есть и отправляет за контекстом под задачу в `repoctl context --intent`. Проверено: 156 тестов, mypy strict чист, validate на самом репозитории success. Два новых теста закрепляют чтение entrypoint из контракта (включая нестандартный путь) и внятный отказ при отсутствии базы. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 5
parent
c607a14f8b
commit
39c7da3eb1
@@ -145,3 +145,42 @@ def test_cli_refusal_is_an_envelope(tmp_path: Path, capsys) -> None:
|
||||
assert exit_code != 0
|
||||
assert envelope["outcome"] == "failure"
|
||||
assert envelope["findings"][0]["code"] == "SKILLS_MODIFIED"
|
||||
|
||||
|
||||
def test_kdb_table_reads_the_entrypoint_the_contract_declares(tmp_path) -> None:
|
||||
"""The path is never guessed: the contract names it, and a repo may move it."""
|
||||
from stewardship.kdb_table import render
|
||||
|
||||
(tmp_path / "ops").mkdir()
|
||||
(tmp_path / "kb").mkdir()
|
||||
(tmp_path / "ops" / "contract.yaml").write_text(
|
||||
"spec:" + chr(10) + " knowledge:" + chr(10) + " entrypoint: kb/index.yaml" + chr(10),
|
||||
encoding="utf-8",
|
||||
)
|
||||
(tmp_path / "kb" / "index.yaml").write_text(
|
||||
chr(10).join([
|
||||
"spec:",
|
||||
" repository: repo:x",
|
||||
" topics:",
|
||||
" - id: t-one",
|
||||
" intents: [do-a-thing]",
|
||||
" documents: [d-one]",
|
||||
" documents:",
|
||||
" - id: d-one",
|
||||
" path: README.md",
|
||||
" role: reference",
|
||||
" status: stale",
|
||||
]) + chr(10),
|
||||
encoding="utf-8",
|
||||
)
|
||||
out = render(tmp_path)
|
||||
assert "repo:x - 1 topics, 1 documents" in out
|
||||
assert "**t-one**" in out and "do-a-thing" in out
|
||||
assert "(!)" in out # a stale document is marked, not silently listed
|
||||
|
||||
|
||||
def test_kdb_table_says_so_when_there_is_no_knowledge_base(tmp_path) -> None:
|
||||
from stewardship.kdb_table import render
|
||||
|
||||
assert render(tmp_path).startswith("No knowledge base at")
|
||||
|
||||
|
||||
Reference in New Issue
Block a user