spark-mind/TODO.md

spark-mind — Оставшиеся TODO

Полный план — в DESIGN.md: автономный контент-продюсер с заземлением на метриках и автономией по заслугам.

Статус: P0–P5 базовые завершены (heartbeat→mind, JSON output, bge-m3 embeddings, sub-agents, SQLite, Telegram+fallback). Далее — программа контент-производства.

Порядок обязателен: есть зависимости между шагами.

Шаг 0 — Основа

• P5: decision.noAction: true — агент может решить, что действие не нужно, и не писать thought (сейчас heartbeat всегда «работает» → шум в памяти).
• Тонкий Channel: ConsoleChannel, TelegramChannel, FileChannel. sendReply сейчас жёстко зашит на Telegram+console.

Шаг 1 — Планировщик (нужен для pipeline/measure/reflection)

• Cron-задачи: триггер {type:'task'} объявлен, но никто не эмитит.
• Проверка due-записей в SQLite → эмит {type:'pipeline'} и {type:'measure'}.
• Ночной {type:'reflection'}.
• Приёмка: задача с датой выполняется в срок.

Шаг 2 — Конвейер контента (центральный объект)

• Таблица content_items (kind: text|image|podcast|video; status: brief→generated→optimized→published→measured→archived).
• Переходы статусов + журнал переходов.
• Привязка к site (свои сайты) и deal_id (клиентские заказы).
• Приёмка: item проходит brief→published, все переходы в журнале.

Шаг 3 — Заземление: outcomes + measure

• Таблица outcomes: metric_kind (reach, engagement, position, traffic, conversion, revenue, speed, quality), direction, horizon_days, due_at.
• Замер через {type:'measure'}: Метрика API / GSC / Yandex Webmaster / Wordstat.
• Нормализация в score [-1..+1]; базлайн области для нового контента.
• Приёмка: метрика замеряется через horizon, score пишется.

Шаг 4 — Автономия по заслугам

• Таблица capabilities (тир на область: text, image, podcast, video, seo_onpage, seo_semantics, publish).
• Тиры 0..4 (observer → suggest → ask → act+report → autonomous).
• +1 тир за 3 нетто-положительных; −1 за 1 отрицательный; затухание 90 дней.
• Границы persona values непреодолимы на любом тире.
• Приёмка: тир растёт после 3 успехов и падает после провала.

Шаг 5 — Методы: skills + reflection

• Таблица skills (name, area, method_md, tool, validated, uses, success_rate, embedding).
• Retrieval нужного метода по эмбеддингу bge-m3 (не грузить всё сразу).
• Наполнение методами из реального стека: editor-pro (text/seo_onpage), ComfyUI (image), Silero TTS (podcast), video-pipeline (video), Wordstat (seo_semantics), Astro (publish).
• reflection: ночной цикл обобщает items+outcomes+thoughts → long-term и self_observations (сейчас мёртвый слой).
• Tool-runtime для под-агентов: tools сейчас — только строки-декларации.

Шаг 6 — Заказы: deals + counterparties

• Таблицы counterparties, deals, deal_events (append-only).
• trust_score выводится из истории, не задаётся руками.
• Заказ клиента на контент: offered→accepted→delivered→paid|refused|defaulted.
• Приёмка: заказ проходит полный цикл.

Шаг 7 — Энергия: ledger

• Таблица ledger.
• Расход: тик, генерация (текст/фото/аудио/видео), публикация, саб-агент.
• Приход: положительные outcomes + донат.
• Низкий баланс → интервал тиков растёт → Deep Rest.
• Приёмка: результат пополняет энергию, дефицит замедляет тики.

Инфраструктура (по мере надобности)

• Конфиг / .env: URL-ы Ollama, dbPath, Telegram захардкожены в index.ts.
• Retry + timeout (AbortController) для LLM/embedding fetch.
• Тесты: parseSparkOutput, Database CRUD, cosine-поиск, нормализация score.
• Web UI (persona setup) вместо DEFAULT_PERSONA в коде.

Каналы вывода

• Telegram: обход SSL-проблемы bot.qw4.ru (tlsv1 unrecognized name, серверная). Сейчас console-only fallback.

Движок

• Spark X2.5-4B: не грузится в Ollama (unknown architecture 'spark2_5'). Варианты: совместимый GGUF / llama.cpp напрямую / остаться на Ornith-1.5-9B. Важно: локальные модели пумолкают (пустой ответ), если subAgent в JSON-схеме structured output.

Косметика

• Устаревший doc-комментарий в mind.ts (класс SparkLLMClient описан как «клиент для Spark X2.5-4B, в MVP заглушка»).
• Дефолт модели в конструкторе SparkLLMClient = 'spark-x2.5-4b'.