Skip to content

Refactor/structure audit - #1

Merged
LeoLourson merged 2 commits into
mainfrom
refactor/structure-audit
Oct 13, 2026
Merged

LeoLourson merged 2 commits into
mainfrom
refactor/structure-audit

Conversation

@LeoLourson

Copy link
Copy Markdown
Owner

No description provided.

Поле env stdio-сервера MCP переносится в Cordis patch; тесты адаптера больше не зависят от конкретных имён команд, ролей и MCP-серверов, поэтому новая команда или роль не требует правки тестов.
Деление шло сразу по нескольким признакам: create.py и tests/ относились к набору,
template/ — к продукту, README.md и GUIDE.md — к описанию, а стояли в одном ряду корня.
Теперь признак один — отношение файла к проекту.

Набор (tools/):
- create.py перенесён в tools/ и знает корень шаблона как tools/../template;
- tests/kit/ проверяет создание и обновление проекта;
- tests/template/ проверяет инструменты самой заготовки (перенесены из template/tests/).

Продукт (template/) не изменился по составу: в нём по-прежнему ровно то, что получает
созданный проект, и ничего, что получает только репозиторий.

Один вид документа вместо двух разборов:
- scripts/records.py собирает Doc, read_doc, write_doc, docs, find_doc, save_doc, словари
  статусов и заготовки записей; proj.py и lit.py вызывают его;
- proj.py теряет дублирующий разбор шапки и делегирует new/set_field/docs в records;
- из proj.py убрана обратная зависимость: proj.py sync запускает соседний lit.py по пути
  от самого модуля и передаёт ему корень ключом --root, а не жёстким 'scripts/lit.py';
- у lit.py появился configure(root): пути реестра, карточек, текстов и индекс больше не
  вычисляются при импорте, поэтому инструмент можно направить на другой каталог;
- у proj.py появился ключ --root.

Производное вне коммита:
- template/.dsh/skills/ снят с отслеживания и собирается harness.py prepare;
- в корневой .gitignore добавлены .pytest_cache/ и *.pyc.

Документация:
- корневой README.md описывает набор и слои, руководство переехало в docs/guide.md;
- состав команд и ролей остаётся в AGENTS.md, дубли в README шаблона убраны;
- docs/architecture.md фиксирует признак деления, что было рассогласовано и что открыто;
- tests/template/test_docs.py сверяет упомянутые в документации команды, навыки и пути с
  составом .claude/ и падает при расхождении;
- CI зовёт новые каталоги тестов.

Проверено: python -m unittest discover -s tests/kit (4 теста), -s tests/template
(36 тестов), template/scripts/harness.py --root template prepare и check.
@LeoLourson
LeoLourson merged commit 6f4a424 into main Oct 13, 2026
4 of 10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant