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

8.3 KiB
Executable File
Raw Blame History

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. Условия: личный доступ, открытые компоненты, без изменения систем компании. Очередность: покрытие проектов → эталон и явные связи → испытание Cognee/Graphiti → роли и важность → внимание и ретроспекция. Исследование выявило потери Asana; исправления и модельные прогоны ещё не выполнены. Корпоративный shortlist больше не определяет первый этап.

Дополнение 04.10: понимание потока работ и этапы WG-0–WG-4. Приоритет проверки — покрытие корпуса, обнаружение связей, текущая ситуация и роль пользователя. Это исследовательское уточнение для согласования; выбранный PostgreSQL core сохраняется, новые модели и graph runtime не внедрены.

4 октября 2026. Подготовленный вариант для утверждения Алексом. Противоречия ранних вариантов устранены; реализация и новые расписания не включены.

Действующий план и исследовательское уточнение

Полная спецификация R2, 21 лист и приёмка и точный контракт PostgreSQL/графа. Печатные схемы и исходники. Контракты R2 сохраняются с уточнениями шести уровней; очередность 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 задаёт исполняемые пакеты. Сейчас в очереди 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. Выбор внутренних таблиц и устранение технических противоречий уже выполнены в проекте. Этот документ сам по себе не выдаёт разрешение на запуск/установку расписания.