[P0] 02. Описать фактический workspace и безопасный onboarding #1

Closed
opened 2026-09-13 15:32:51 +03:00 by codex-bot · 1 comment
Owner

Источник: локальный todo/wealthledger-engineering-improvements.md, пункт 02, анализ от 13.09.2026. Исходные критерии приведены ниже, чтобы issue не зависела от наличия локального TODO.

Что осталось сделать

02. Описать фактический workspace и безопасный onboarding. Размер: S/M. Владельцы: root, docs.

Исправить устаревший Git-факт в root AGENTS. Добавить root README: назначение,
фактические repos и расположение, получение checkout, Node/npm/OpenSpec,
существующие команды запуска и проверки, известное ограничение миграций.
Дать ссылки на repo README и docs вместо копирования их подробностей.
Зафиксировать, что принадлежит root-репозиторию: вложенные repos и локальные
данные сейчас видны как untracked и не должны случайно попасть в массовый add.
Готово, когда: по README можно собрать требуемую структуру без угадывания;
команды и Git-описание соответствуют workspace; правила root tracking проверены
на вымышленных данных, чужие файлы и вложенные .git сохранены.
Основание: A, с. 5, 19, 29; B, с. 1, 28; текущая read-only Git-проверка.

Из README не переносить старое утверждение о незакрытом Prisma blocker: он снят. Настройки tracking сначала проверить на вымышленных данных; не добавлять вложенные repos или пользовательские данные в main.

Основание текущего статуса

В Gitea workspace представлен репозиторием WealthLedger/main. Локально есть .git, но root AGENTS утверждает обратное; root README отсутствует. Это конфликт описания topology, который нужно явно разрешить при 02. Вложенные frontend/backend/docs/specs остаются независимыми репозиториями.

Проверка 13.09.2026: статическая сверка текущих файлов и remediation registry; через MCP проверены репозитории, issues, ветки и Actions workflows. Все пять main-веток имеют protected=false, список workflows пуст, существующих issues не найдено. Внешние CI, server-side updater, история секретов и свежий npm audit этой сверкой не проверялись; полные application gates повторно не запускались.

Проверяемая revision main: ee2adc9fda6ce319422e5fe89143b9a1584d690f.

Remediation registry остаётся владельцем статусов audit findings. Создание issue не означает выполнение или изменение статуса finding. Закрыть после проверки критериев и ссылки на фактические результаты.

Связанные issues

<!-- wealthledger-engineering-improvements:main:02 --> Источник: локальный `todo/wealthledger-engineering-improvements.md`, пункт 02, анализ от 13.09.2026. Исходные критерии приведены ниже, чтобы issue не зависела от наличия локального TODO. ## Что осталось сделать **02. Описать фактический workspace и безопасный onboarding.** Размер: S/M. Владельцы: root, docs. Исправить устаревший Git-факт в root AGENTS. Добавить root README: назначение, фактические repos и расположение, получение checkout, Node/npm/OpenSpec, существующие команды запуска и проверки, известное ограничение миграций. Дать ссылки на repo README и docs вместо копирования их подробностей. Зафиксировать, что принадлежит root-репозиторию: вложенные repos и локальные данные сейчас видны как untracked и не должны случайно попасть в массовый add. **Готово, когда:** по README можно собрать требуемую структуру без угадывания; команды и Git-описание соответствуют workspace; правила root tracking проверены на вымышленных данных, чужие файлы и вложенные `.git` сохранены. **Основание:** A, с. 5, 19, 29; B, с. 1, 28; текущая read-only Git-проверка. Из README не переносить старое утверждение о незакрытом Prisma blocker: он снят. Настройки tracking сначала проверить на вымышленных данных; не добавлять вложенные repos или пользовательские данные в main. ## Основание текущего статуса В Gitea workspace представлен репозиторием `WealthLedger/main`. Локально есть `.git`, но root AGENTS утверждает обратное; root README отсутствует. Это конфликт описания topology, который нужно явно разрешить при 02. Вложенные frontend/backend/docs/specs остаются независимыми репозиториями. Проверка 13.09.2026: статическая сверка текущих файлов и remediation registry; через MCP проверены репозитории, issues, ветки и Actions workflows. Все пять main-веток имеют protected=false, список workflows пуст, существующих issues не найдено. Внешние CI, server-side updater, история секретов и свежий npm audit этой сверкой не проверялись; полные application gates повторно не запускались. Проверяемая revision main: `ee2adc9fda6ce319422e5fe89143b9a1584d690f`. [Remediation registry](https://git.personal.ksv741.ru/WealthLedger/docs/src/commit/7bc8792b9853768734066c31a323b70886d73a23/development/audit-remediation.md) остаётся владельцем статусов audit findings. Создание issue не означает выполнение или изменение статуса finding. Закрыть после проверки критериев и ссылки на фактические результаты. ## Связанные issues - [docs: [P0] 02.docs. Обновить описание workspace по факту исправлений](https://git.personal.ksv741.ru/WealthLedger/docs/issues/3)
Author
Owner

Закрываем как выполненную после merge root PR #10 и docs PR #14.

Root README и AGENTS описывают пять независимых Git-репозиториев, структуру checkout, подготовку и существующие команды; подробные инструкции остаются у владельцев репозиториев. Root tracking ограничен allowlist, вложенные репозитории и локальные данные не включаются в root.

Проверки при подготовке изменений: tracking проверен на искусственных данных с сохранением вложенных Git-репозиториев и пользовательских файлов; Markdown, локальные ссылки и git diff --check прошли. Самописный tracking-тест затем удалён по явному решению владельца — постоянный root gate не является условием принятого решения. Актуальные изменения root: 95e4361; docs: 97069d6.

Закрываем как выполненную после merge [root PR #10](https://git.personal.ksv741.ru/WealthLedger/main/pulls/10) и [docs PR #14](https://git.personal.ksv741.ru/WealthLedger/docs/pulls/14). Root README и AGENTS описывают пять независимых Git-репозиториев, структуру checkout, подготовку и существующие команды; подробные инструкции остаются у владельцев репозиториев. Root tracking ограничен allowlist, вложенные репозитории и локальные данные не включаются в root. Проверки при подготовке изменений: tracking проверен на искусственных данных с сохранением вложенных Git-репозиториев и пользовательских файлов; Markdown, локальные ссылки и git diff --check прошли. Самописный tracking-тест затем удалён по явному решению владельца — постоянный root gate не является условием принятого решения. Актуальные изменения root: 95e4361; docs: 97069d6.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: WealthLedger/main#1