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:
co-authored by
Claude Opus 5
parent
39c7da3eb1
commit
c10df0e3af
@@ -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` — только нужные знания под задачу
|
||||
|
||||
Главная команда для агента. Вместо чтения всей документации репозитория:
|
||||
|
||||
Reference in New Issue
Block a user