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
+22
View File
@@ -104,6 +104,28 @@ repoctl describe --repo some-repo-name --output json
Возвращает нормализованный `RepositoryContract` — только контракт, без загрузки KDB. Полезно, чтобы быстро узнать тип, владельца и content roots репозитория, не читая ничего лишнего.
### `kdb` — что вообще есть в базе знаний
```bash
repoctl kdb --repo .
```
Единственная команда, чей `--output human` печатает не строку статуса, а само
содержимое: markdown-таблицу тем (id, объявленные intent-ы, документы, к которым
тема маршрутизирует, и ключи верхнего уровня в `data`) и таблицу документов
(id, путь, роль, статус; `stale` помечен `(!)`). Это сделано намеренно —
вопрос «что в базе знаний» отвечается содержимым, а не статусом.
Находки по-прежнему уходят в stderr, таблица в stdout, поэтому
`repoctl kdb > kdb.md` даёт чистый markdown. `--output json` и `--output yaml`
возвращают обычный конверт с `stewardship/knowledge-overview@0.1` внутри.
Точка входа не угадывается: берётся `spec.knowledge.entrypoint` из
`ops/contract.yaml`, с откатом на `kdb/kdb.yaml`. Репозиторий без базы знаний
получает предупреждение `KNOWLEDGE_ENTRYPOINT_MISSING` и код возврата `3`.
Таблица отвечает «что есть». Чтобы получить только нужное под конкретную
задачу, возьмите intent из колонки Intents и спросите `context`.
### `context` — только нужные знания под задачу
Главная команда для агента. Вместо чтения всей документации репозитория: