---

name: Agents and infrastructure inventory description: Канонічний реєстр активних сервісів, cron, проектів, агентів. Оновлювати після додавання/видалення будь-чого. Це замість того щоб щоразу ре-інвентарувати через ls. type: reference originSessionId: ff491aab-005d-4454-ba7e-7018272512dc

Інфраструктура — канонічний реєстр

Оновлено: 2026-04-17. При будь-яких змінах (додали сервіс, деплой нового проекту, видалили проект) — одразу оновити цей файл.

🤖 Агенти

Агент	Середовище	Модель	Коли активний
Claude Cloud (Telegram)	VPS tmux claude-bot	Opus 4.7	Завжди, основний
Claude Desktop (Cowork)	Windows Cowork mode	Sonnet/Opus	Коли Сергій на десктопі
Gemini Fallback	VPS Python (standalone)	Gemini CLI	Активується коли Anthropic API down >5 хв

🛡 AI-сервіси / Crews (агенти, не проекти)

Перенесено з розділу «Проекти» 2026-05-03 — за правилом «це сервіси/агенти, а не проекти, що ми «розробляємо для бізнесу»».

Агент	Середовище	Модель	Призначення
Watchdog	systemd claude-watchdog.service, hourly cron, /srv/services/claude-watchdog/watchdog.py	Python (rule-based) + Anthropic check	Моніторинг claude-bot: API 401, responsiveness, post-boot, subagent-detection. 🎯 100%
Case Builder Crew	CrewAI 4-agent, Gemini API, /srv/projects/case-builder-crew/	gemini-3.1-pro-preview	Генерація клінічних кейсів під SKU. Review gate — Telegram apprоve перед інтеграцією. Деталі: project_case_builder_crew.md, feedback.
Dev Crew	Gemini Sandbox API, /srv/projects/dev-crew/crew.py	gemini-3.1-pro-preview	7-роль департамент розробки (IT Director, Backend, Frontend, Code Analyst, QA, UI/UX, DevOps). Деталі: team_dev_crew.md.
legal-advisor	REST API через gemini-sandbox.key, /srv/projects/legal-advisor/	gemini-3.1-pro-preview	Штатний AI-юрист БАД. 8 категорій + slash-команди. Підключається у Search Campaign Builder, Content Generator, Brand Threads. 🎯 ~65%
PM-Agent v0.3	systemd, /srv/services/pm-agent/pm_agent.py, Gemini Sandbox	gemini-3.1-pro-preview	Auto-update wiki frontmatter (last_updated, readiness_pct ±10%/добу), ## 🤖 PM Changelog sections, git commit, interactive answers folder.
Drift Detector	systemd drift-detector.timer (daily 18:00 UTC), /srv/services/pm-agent/drift_detector.py	rule-based git diff	Порівнює git-активність /srv/projects/<X>/ vs /srv/wiki/projects/<area>/<X>/. Алерти → /root/.claude/projects/-/memory/drift_alerts.md (НЕ в Telegram).
Inbox Watcher	systemd path unit inbox-watcher.path → inbox-watcher.service (oneshot), /srv/services/inbox-watcher/watcher.sh	bash + curl	Моніторить /root/.claude/projects/-/memory/inbox-from-desktop/ — як з'являється новий .md файл, шле Telegram-повідомлення в чат 312194208 з префіксом 🤖 [Desktop→VPS auto]. Це триггерить VPS Claude через MCP-плагін Telegram. State: /var/lib/inbox-watcher/seen.txt. Log: /var/log/inbox-watcher.log. Створено 2026-05-05.
Google Ads Crew	Gemini CLI, /srv/projects/google-ads-crew/	Gemini CLI	5-агентна AI-команда для Google Ads creative + audit. MVP готово, є reports. Підключається у проекти ad-analytics-hub/google-ads. 🎯 ~70%.
banner-builder	Claude subagent, /root/.claude/agents/banner-builder.md + skill /root/.claude/skills/interactive-banner/	Sonnet	Будує DV360-банери (300×250 / 300×600, typology: quiz / mini-game / static-cta) з pixel-GET трекінгом до BigQuery, авто-деплоєм у /srv/services/interactive-banners/<brand>/, оновленням gallery index.html та Playwright screenshot валідацією. Trigger: /interactive-banner <brand> <type> <size> або прямий запит. Brand presets: fluvir/menopace/zest/proflex. Tracking endpoint: banner-analytics-<brand>.cloudfunctions.net/track. Створено 2026-05-13.

⚙️ Systemd services (active)

Сервіс	Що робить	Файл
claude-bot.service	Telegram-агент (я) в tmux — legacy, заміщений bridge'ом	/etc/systemd/system/claude-bot.service
claude-telegram-bridge.service	Активний Telegram-агент — Python bridge на Claude Agent SDK з resume сесії. Підтримує text + voice (faster-whisper) + photo (Read tool) + document (PDF/text/code через Read tool). Замінює зламаний --channels plugin:telegram (anthropics/claude-code#38259)	/srv/services/claude-telegram-bridge/bridge.py
agent-rpc.service	Desktop↔VPS autonomous communication — HTTP endpoint 127.0.0.1:8092 (POST /ask з X-Agent-Secret header). Викликає claude --print для non-interactive відповіді. Замінив federation-broker (disabled 2026-05-12). Secret: /srv/passepartout/agent-rpc-secret.txt. Logs: /var/log/agent-rpc.log.	/srv/services/agent-rpc/main.py
federation-broker.service	DISABLED 2026-05-12 — WS-канал ed25519, replaced by agent-rpc. Code залишився у /srv/services/federation-broker/ (~23 MB з .venv) як historical reference. *.service.disabled файли.	—
public-stack (docker compose)	Public Docker stack — окремий compose з 9 контейнерами (Caddy + 4 med-detective + biogaia + 3 nginx-static). Caddy автоматично TLS через Let's Encrypt DNS-01 (Cloudflare API). Pilot mode на 127.0.0.1:8480/8443, prod switch через transition.sh prod. За Cloudflare orange-cloud proxy — DDoS захист, схований origin IP.	/srv/public-stack/docker-compose.yml
claude-watchdog.service	Моніторинг API + responsiveness + post-boot	/srv/services/claude-watchdog/watchdog.py
arteggia-bot.service	Telegram-бот акції Arteggia×Vertebra (чекає токен)	/srv/projects/arteggia-bot/src/bot.py
biogaia-story.service	Flask-app для BioGaia казок	live /biogaia/
novnc.service	VNC браузер (Xvfb :99, порт 6080)	логіни add.ua тощо
docker: srv-caddy-1	Reverse proxy	docker-compose.yml
docker: srv-n8n-1	n8n автоматизація	localhost:5678

⏰ Cron

Розклад (UTC)	Що робить	Ціль
0 3 * * *	MCC CSV download	Google Ads
30 3 * * *	MCC daily analyzer	звіт у Notion
30 4 * * *	daily_delta_monitor	delta-алерти у Notion
0 5,11,17 * * *	Pediatric News bot	@smart_pediatric_news
0 6 * * *	wiki → Notion sync	sync-to-notion.py
0 6 * * 1-5	morning-checkin	ранкова перевірка
0 15 * * 5	weekly-review	п'ятниця підсумок
0 * * * *	watchdog.py (cron)	щогодинна перевірка задач
*/5 * * * *	security-alert + ssh-login-alert	безпека
*/15 * * * *	serhii-brain git pull	синхронізація пам'яті
*/10 * * * *	sysstat-collect	метрики (systemd timer)
одноразові	remind.py з датами	особисті нагадування

📦 Проекти (/srv/projects/) — статуси

🟢 Активні / в продакшні

• ad-analytics (362M) — BigQuery, MCC Daily Monitor, delta-моніторинг. 🎯 %55% (SA+BQ працюють, daily_delta_monitor у cron; відсутнє: tabletki-source + cookie-refresh для MCC CSV fallback)
• Pharmagen-KZ (umbrella) — парасолевий проект генерації CIS-контенту, consolidated 2026-04-22. Три підпроекти під спільним Gemini-ключем gemini-pharmagen-kz.key:
  • pharmagen-kz (core, /srv/projects/pharmagen-kz/) — FastAPI+LangGraph+React19, 2 MVP (розсилки для лікарів + соцмережі KZ). 🎯 %~40%
  • baryonic-orion (/srv/projects/baryonic-orion/, 727M) — Next.js 16 + grammY + SQLite. PR/NEWS_HOOK/BRIEF/SEO через TG-бот+dashboard. 🎯 %~50% (не задеплоєний)
  • crewai-content (/srv/projects/crewai-content/, 16K) — Python CrewAI. 2026-04-17 розширено під DV360 interactive banners (game_designer, dv360_tech_specialist, legal_gate, game_styleboard + run_crew_interactive_banner()). Використана під Zest Дитячий Магній launch. 🎯 %~90% для Zest, DV360 готовий.
  • Wiki: /srv/wiki/pharmagen/index.md (головна). 🎯 Парасоль ~50%.
• biogaia-story (1.9M) — Flask, live: http://31.131.26.203/biogaia/. 🎯 %80% (деплой ✅, польовий тест)
• pediatric-news (236K) — бот працює, 3×/день. 🎯 %60%. Оригінальний план (відео-аватар, $10/відео, HeyGen) на HOLD. Pivot: Threads-адаптація + органіка. TODO: Threads API research + style guide адаптатора.
• heafolik-reviews (48K) — 18 відгуків готово. ✅ 3 на модерації (Add×2 15.04 dup-same-day risk, EVA×1 16.04), 🔴 10 заблоковано (capcha/Cloudflare/SMS), ⚠️ 3 без продукту в базі. SKIP: Prom.ua+Google Maps. Правило: 1 успіх/день → стоп, 1 день паузи. 🎯 %25% (заблокера — 2captcha token)
• arteggia-bot — Telegram-бот @arteggia_promo_bot для акції «2× Arteggia → безкоштовна Vertebra» (медізін). aiogram 3 + Gemini 2.5 Flash через Replicate (OCR) + SQLite + systemd. Період: 01.04.2026–31.12.2026. 🎯 %90% — live, OCR тест пройдено 20.04. Залишилось: (1) CSV-loader реальних промокодів (зараз placeholder ARTEGGIA-TEST-2026), (2) Redis FSM storage (зараз рестарти гублять стан юзерів). Wiki: /srv/wiki/arteggia-bot/. Unit: arteggia-bot.service.

🟡 В розробці / MVP

• lunar-hubble (1.2M) — Родинне дерево + TG бот. 🎯 %~50%
• brand-threads — Threads-комунікація брендів Deltamedical. Моніторинг трендових постів + AI-коментарі у тоні бренду (обхід реклам-обмежень БАДи/ЛЗ). Референс: Галичина Масло. 🎯 %ідея (див. /srv/wiki/brand-threads/)
• pharmagen-kz (38M) — AI-генератор фарм-контенту для CIS-ринку (не тільки KZ). Два MVP: (1) розсилки для лікарів/фармацевтів (WhatsApp/SMS/email), (2) соцмережі KZ (Instagram post/stories/carousel, RU→KZ translate + image gen). Flow: продакт-інструкція → аудиторія → формат → текст RU → approve → переклад+картинка. FastAPI+LangGraph+React+Gemini. 🎯 %~40% (базу є, треба CIS-розширення + 2-click UX + апгрейд моделей). Див. /srv/wiki/pharmagen/
• search-campaign-builder (40K) — Pipeline v2 (2026-04-23): 6 агентів (Research+Volume+Copy+Legal+Assets+CSV). Google Ads API підключено (mock-fallback). Чекає OAuth handoff від Сергія (24.04). 🎯 %70%
• zest-24-channel — media buy Zest на зовнішньому каналі «Живи у формі» (YT@Zhyvy_u_formi + TT/IG @zhyvy_u_formi, ≈54M views). Стратегія «жорсткий брендинг / заміна банерки»: пекшот-врізка в 30-50% відео, SKU-ротація тиждень=SKU. Legal — лояльний режим (media buy). Передумова запуску: pull-list нотифікованих SKU (Закон №4122-IX, штраф >380K). 🎯 %15% — стратегія+legal готові, чекає go. Wiki: /srv/wiki/zest-24-channel/. Дані: /srv/projects/zest-24-channel/data/. Створено 2026-04-23. <!-- crewai-content merged → див. baryonic-orion / Content Generator CIS -->
• legal-advisor (264K) — Штатний юрист БАД. База: Закон №4122-IX + 4200 health claims (Наказ МОЗ №1145 Додаток 2). 3 функції: legal_review() / generate_compliant_copy() / check_keyword(). Нова специфікація (2026-04-17): 8 категорій перевірки + slash-команди /check /rewrite /explain /sources + OCR для банерів + URL-fetch. Гапи: OCR/URL/slash-команди ще не імплементовані. 🔴 НЕ підключено до робочих команд (навмисно — за домовленістю, буде інтегрований у Search Campaign Builder + Content Generator коли Сергій дасть go). Docs: /srv/projects/legal-advisor/docs/. Wiki: /srv/wiki/legal-advisor/. 🎯 ~65%. 2026-04-22: перейшов з Gemini CLI на REST API через gemini-sandbox.key, default model — gemini-3.1-pro-preview. Env override: LEGAL_ADVISOR_MODEL=<model>.
• lego-monitor (16K) — LEGO 75810 ціновий моніторинг.
• loyalty-analysis (372K) — аналіз лояльності (статус?).
• plasma-skylab (240K) — PIM для Deltamedical (агрегатор продуктового контенту → партнерам через їх шаблони/канали). Enterprise PIM коштує $200K/3роки — будуємо свій. MVP є у Кам+Ростислав (на "OpenBall"❓—можливо Odoo). Головний челлендж — бізнес-процес (ДЖЕС+marketing approval+реєстрація→ approval flow з юристами→ distribution у шаблонах партнерів). 🎯 %10-15%. Next: Сергій повертається ~24.04.

🔵 Allocated / в беклозі

• dev-crew (20K) — AI-команда (Backend + Frontend + QA…), перший проект: BioGaia. ⚠️ один файл, можливо scratch.
• fb-account-manager (12K) — чекає розблокування FB.
• ga4-access (24K) — допоміжний, потенційно merge в ad-analytics.
• ruby-oort (244K) — статус?
• zest-content (70M) — Zest Mg Kids launch. ✅ завершено (медіаплан + PPTX).
• family-tree (952K) — ⚠️ дубль lunar-hubble — видалити.

🔑 Passepartout (/srv/passepartout/)

Файл	Вміст
telegram/claude-bot.token	Telegram bot token (актуальний)
telegram/tree-bot.token	Tree-bot (родинне дерево)
telegram/pediatric-news-bot.token	Pediatric News bot
google/bigquery-sa.json	ad-pipeline-worker@ad-analytics-hub.iam...
google/ad-pipeline-worker-sa.json	дубль? (перевірити)
google/gemini.key	Gemini API key
google/google-ads-developer-token.txt	Google Ads dev token
google/mcc-account-ids.json	MCC акаунт-ID
google/cookies-*.json	DEPRECATED 2026-05-11 — переходимо на BQDTS-only + REST OAuth. Перенесено у _archive-2026-05-11/
github/tokens.txt	PAT ghp_fHc2w... (expires 2026-05-14)
ssh/claude-desktop-2026-04-23.pub	Desktop Claude SSH pub-ключ (fp h2WYv5X...), from="193.93.78.10", приватний у Windows Cred Manager
meta/andrii-savchenko-fb.txt	FB credentials
meta/cookies-andrii-savchenko-fb.json	FB куки
reviews/cookies-add-ua.json	add.ua (для Heafolik)
supabase/lunar-hubble.env	Supabase Lunar Hubble
lifecell-esim.txt	eSIM +380737465658

📂 Wiki (/srv/wiki/)

• open-tasks.md — backlog
• tech-stack.md — стек
• projects-overview.md — список проектів зі статусами
• AGENTS.md — архітектура двоінстанційна
• README.md — головна
• sessions/ — handoff нотатки між сесіями
• skills/ — скіли (ppc-*, review-publication)
• _meta/ — meta (ця інстанція, тощо)
• Синхронізується з Notion щодня 06:00 UTC через sync-to-notion.py

🧠 Memory (/root/.claude/projects/-/memory/)

Індекси:

• MEMORY.md — робочий (завжди завантажується)
• MEMORY-PERSONAL.md — особистий

Auto-load на SessionStart (через /usr/local/bin/session-start-check.sh):

• decisions_log.md (rolling 14 днів)
• rules.md (правила поведінки)
• agents_inventory.md (цей файл)
• open-tasks.md (задачі в роботі)
• остання сесія з sessions/
• Неперекриті Telegram-питання (через /usr/local/bin/telegram-unanswered.py) — додано 2026-04-30. Сканує JSONL транскрипти за 24 год, шукає inbound без mcp__plugin_telegram_telegram__reply tool_use ≥5 хв.

🔔 Telegram unanswered watchdog (додано 2026-04-30)

Мета: не пропускати питання Сергія через два механізми:

• SessionStart — на старті нової сесії бачу блок «⚠️ Неперекриті Telegram-питання за 24 год».
• Cron 15 хв — telegram-nudge.timer (systemd) → /usr/local/bin/telegram-nudge-check.sh → якщо є питання без reply ≥15 хв, бот сам пінгує Сергія через Bot API.

Файли:

• /usr/local/bin/telegram-unanswered.py — детектор. Сканує /root/.claude/projects/-/*.jsonl і /root/.claude/projects/-srv/*.jsonl. Inbound = type=user з origin.kind=channel + <channel source="plugin:telegram:telegram">. Outbound = tool_use з name=mcp__plugin_telegram_telegram__reply. Логіка: для кожного chat_id порівнює latest_inbound_ts vs latest_reply_ts.
• /usr/local/bin/telegram-nudge-check.sh — cron-скрипт. Дедуплікує по chat_id:message_id у /var/lib/telegram-nudge/seen.json (тримає останні 500). Лог: /var/log/telegram-nudge.log.
• /etc/systemd/system/telegram-nudge.{service,timer} — systemd одиниці. Timer: OnUnitActiveSec=15min, Persistent=true.
• Bot token: /srv/passepartout/telegram/claude-bot.token.

Як перевірити роботу:

• systemctl list-timers telegram-nudge.timer
• /usr/local/bin/telegram-unanswered.py --format human --hours 24 --grace 0 — показує всі inbound без reply
• tail /var/log/telegram-nudge.log

⚠️ Known issues / TODO

• family-tree і crewai-content — кандидати на видалення (дублі)
• /var/log/claude-watchdog.log 0 байт — systemd StandardOutput=append чомусь не пише (перевірити)
• Хостер може знову натиснути ACPI power — watchdog тепер помітить, HandlePowerKey=ignore застосовано