Cogload

Рабочее имя. Финальное продуктовое имя — TBD до релиза.

macOS menu-bar приложение, оценивающее «темп» работы пользователя в реальном времени и подсказывающее, когда защитить фокус, а когда сделать паузу. Локально, приватно, без сети.

Прототип-референс — PaceBar. Цель: сначала достичь паритета, затем расширить за счёт opt-in модулей (контекст приложений, календарь, физиологические сигналы).

Документация

Старт — docs/00_index.md.

• docs/00_index.md — обзор продукта, принципы, архитектурный замысел.
• docs/01_roadmap.md — этапы M0–M10.
• docs/architecture/ — слои, контракты модулей, разрешения и реестр.
• docs/plans/ — пошаговые планы по этапам.
• docs/decisions/ — ADR (architecture decision records).

Сборка (M0)

swift build           # собирает все локальные пакеты + executable
swift run CogloadApp  # запускает menu-bar приложение
./scripts/test-all.sh # юнит-тесты по всем пакетам (root + Packages/*)

Dev setup

Один раз поставить инструменты и активировать pre-commit-хуки:

brew install lefthook swiftlint swift-format
lefthook install

После этого git commit автоматически прогонит swift-format -i и swiftlint --strict по staged Swift-файлам. CI прогоняет то же самое жёстко (см. .github/workflows/ci.yml).

Структура

.
├── Package.swift              # корневой манифест: app + локальные пакеты
├── Sources/CogloadApp/        # @main, AppDelegate, AppComposition
├── Tests/CogloadAppTests/
├── Packages/
│   ├── Core/                  # протоколы, EventBus, ModuleRegistry, Clock, Log
│   ├── Sensors/               # SystemEvents, Idle, AppSwitch
│   ├── Processing/            # FeatureExtractor, BaselineModel, Scorer
│   ├── Advisors/              # PaceAdvisor, CheckInAdvisor
│   └── Surfaces/              # MenuBar, Popover, Notifications, Settings
└── docs/

Подробнее — docs/architecture/00_overview.md.

Лицензия

Proprietary — All rights reserved. См. LICENSE. Лицензия может быть пересмотрена в будущем (например, на open-source перед публичным релизом).