Files
obsidian-vault/personal/projects/personal-os/personal-os-architecture-decision-2026-10-04.md
T

48 lines
8.3 KiB
Markdown
Executable File
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Personal OS — архитектурный проект R2
> Дополнение 10.10: строка «n8n/Node-RED не обоснованы» относилась к семантике истины, а не к оркестрации. Для визуальной исполняемой карты потоков развёрнут Windmill (open source, durable runs, холст) на том же PostgreSQL; правила, claims и принятие остаются кодом и таблицами. См. [[personal-os-windmill-system-map-2026-10-10]].
> Актуальное уточнение 05.10: [шесть уровней Personal OS](/Users/admin/Developer/personal-os/planning/personal-os-six-layer-analysis-2026-10-05.md). Условия: личный доступ, открытые компоненты, без изменения систем компании. Очередность: покрытие проектов → эталон и явные связи → испытание Cognee/Graphiti → роли и важность → внимание и ретроспекция. Исследование выявило потери Asana; исправления и модельные прогоны ещё не выполнены. Корпоративный shortlist больше не определяет первый этап.
> Дополнение 04.10: [понимание потока работ и этапы WG-0–WG-4](/Users/admin/Developer/personal-os/planning/personal-os-work-graph-research-2026-10-04.md). Приоритет проверки — покрытие корпуса, обнаружение связей, текущая ситуация и роль пользователя. Это исследовательское уточнение для согласования; выбранный PostgreSQL core сохраняется, новые модели и graph runtime не внедрены.
4 октября 2026. Подготовленный вариант для утверждения Алексом. Противоречия ранних вариантов устранены; реализация и новые расписания не включены.
## Действующий план и исследовательское уточнение
[Полная спецификация R2, 21 лист и приёмка](/Users/admin/Developer/personal-os/planning/system-review-2026-10-04/review.md) и [точный контракт PostgreSQL/графа](/Users/admin/Developer/personal-os/planning/personal-os-evidence-graph-design-2026-10-04.md). [Печатные схемы и исходники](/Users/admin/Developer/personal-os/planning/system-review-2026-10-04/README.md). Контракты R2 сохраняются с уточнениями [шести уровней](/Users/admin/Developer/personal-os/planning/personal-os-six-layer-analysis-2026-10-05.md); очередность E1–E5 ниже заменяет прежнее начало с UI.
## Зафиксированное решение
| Область | Решение |
|---|---|
| Стек | Node с постепенным TypeScript, PostgreSQL, локальный dispatcher; Python worker допустим для выбранного готового компонента после E3. Swift — нативные watchers/iPad. n8n/Node-RED и полная Swift-перепись не обоснованы. |
| Истина | Versioned records/spans → typed assertions → review/resolution → atomic publication. Проекты, PR, файлы, сессии, произвольные типы, косвенные пути и карьера связаны в одной БД. JSON/Obsidian — проекции. |
| Агентный контур | Изолированный worker с immutable packet, read capabilities и JSON output; кандидат → структурная и смысловая проверка → publisher. Source refresh принадлежит collector. |
| Взаимодействие | Первый клиент — локальная карточка на Mac; один следующий шаг, почему, свежесть, scoped correction. iPad над тем же API принимается отдельно. |
| Управление | Code constraints → LLM ranking → deterministic gate; presence/context имеет отдельную быструю версию. Ретро готовит одну гипотезу; diff/eval/shadow/review предшествуют release. |
## Сквозной поток
Разрешённые источники → discovery/cursors → immutable source records → identity + exact links → semantic candidates → verifier/resolver → publication → planner → delivery decision (plan + context + policy) → пользователь → scoped feedback → пересчёт. История цикла → ретроспектор → improvement proposal → проверяемый diff → принятая версия.
У semantic claims в первом пилоте ручное принятие в пределах reviewer budget; нерассмотренные остаются candidate. Точные API facts принимаются кодом. Автоматизация отдельных классов включается после holdout и явного решения о policy. Критические прерывания и внешние действия требуют принятой области полномочий.
## Порядок реализации
[Детальный план действий E1–E5](/Users/admin/Developer/personal-os/planning/personal-os-action-plan-2026-10-05.md) задаёт исполняемые пакеты. Сейчас в очереди E1.1: fixtures подтверждённых потерь и независимая сверка покрытия. Изменение runtime ещё не начато.
| Этап | Конкретный результат и gate |
|---|---|
| E1. Покрытие | Полный согласованный срез трёх проектов; upstream/local manifest; все memberships, stories и дети; проверка повторного обхода. |
| E2. Эталон и явный граф | 60–100 разнообразных эпизодов для начала; source IDs, временные роли, независимый holdout; без доминирования одного кейса. |
| E3. Выбор механизма | Сравнение правил/PG, Cognee и Graphiti на одном корпусе; ошибки связывания, отмены, стоимость и ручная нагрузка. Один выбранный механизм. |
| E4. Роли и важность | Проверенный профиль, объяснимые категории участия и порядок; двухнедельное наблюдение рекомендаций без автоматических внешних изменений. |
| E5. Контур внимания | Ограничения дня, текущий фокус, scoped feedback, единый контекст аналитиков, replay/restore и эксплуатационная приёмка SC1–SC8. |
Adapters и holdout используют одну версию контракта. UI fixtures допустимы как независимая подготовка, но не заменяют gates покрытия и понимания работ. iPad не блокирует Mac pilot. Gate failures остаются в shadow. Полный список success criteria/проверок и владельцев — разделы 18–20 общего пакета.
## Что требует решения пользователя
Принятие подготовленной архитектуры и scope автономности; рабочая граница/окна, классы данных для модели, актуальность карьерных целей и budget caps. Выбор внутренних таблиц и устранение технических противоречий уже выполнены в проекте. Этот документ сам по себе не выдаёт разрешение на запуск/установку расписания.