КАК ПРОВЕРИТЬ ЭТОТ ПАКЕТ САМОСТОЯТЕЛЬНО
=======================================

Все команды выполняются из корня распакованного архива и не требуют сети,
кроме шага установки зависимостей.

1. ЦЕЛОСТНОСТЬ ФАЙЛОВ
   Каждый файл пакета перечислен в MANIFEST.sha256 с контрольной суммой.
   Проверка на macOS/Linux:

       shasum -a 256 -c MANIFEST.sha256

   Ожидается «OK» напротив каждой строки. Сам MANIFEST.sha256 в список не
   входит — его целостность подтверждает checksum архива, который вам передали
   отдельным файлом .tar.gz.sha256.

2. ЗАВИСИМОСТИ (единственный шаг с сетью)

       python3 -m pip install -r code/web/requirements.txt -r requirements-dev.txt

   Версии зафиксированы точно, без диапазонов. Список и лицензии —
   THIRD-PARTY-NOTICES.md. Второй файл нужен только для тестов (pytest);
   для работы приложения достаточно первого.

3. ПРОВЕРКА ОКРУЖЕНИЯ

       python3 scripts/doctor.py

   Печатает состояние Python, зависимостей, переменных, хранилища и режима
   записи. Код выхода 0 — можно запускать.

4. ТЕСТЫ (офлайн)

       python3 -m pytest code/tests -q

   Ожидается: 282 passed, 3 skipped. Пропущенные — тесты, которым нужен
   настоящий каталог с проектами (переменная SECOND_BRAIN_PATH); на демо они
   не запускаются намеренно. Без установленного `git` пропустятся ещё
   несколько: даты «изменён» берутся из git-истории.

   Прогон герметичен: тесты используют собственный справочник направлений и не
   зависят от того, как вы настроили config/directions.json.

5. ДЕМО (офлайн, без ключей)

       bash scripts/run_demo.sh

   Поднимает интерфейс на http://127.0.0.1:8030 с синтетическими данными
   demo/vault. Проверьте глазами: главная, /projects, карточка проекта,
   страница плана, /ideas, /backlog, /done, /kanban.

6. ПРОВЕРКА ЗАПИСИ (безопасно, на демо-данных)
   Отметьте фазу на странице плана. Ожидается:
   - файл demo/vault/plans/… изменился ровно в одной строке;
   - в demo/state/backups появилась копия файла с отметкой времени;
   - в demo/state/project_pulse_writes.jsonl появилась запись об операции.

ЧТО ЭТИ ПРОВЕРКИ НЕ ДОКАЗЫВАЮТ
------------------------------
Контрольные суммы подтверждают, что файлы не изменились по дороге, но не
подтверждают личность отправителя. Сверьте checksum архива с тем, кто вам его
передал, по отдельному каналу связи.
