maps: fix — репо-папки как обычные файлы (было submodule/gitlink), 45 MAP.md теперь в репо

claude-memory/MAP.md

@@ -0,0 +1,84 @@
+# claude-memory
+
+## Назначение
+Приватный канон долговременной памяти агента Claude по проекту **servaki** (оператор german/Gerka1). Это **не код, а база знаний** — набор Markdown-заметок (`node_type: memory`) с фактами об инфраструктуре, проектах, workflow и договорённостях оператора. Локальный путь: `~/.claude/projects/C--Windows-System32/memory`, remote — Gitea `git1.servaki.online/german/claude-memory` (создан 2026-06-30). Пуш через `git -c http.extraHeader="Authorization: token <tok>"`; `.gitignore` режет `*.env` и `.servaki-secrets/`.
+
+`MEMORY.md` — индекс всех заметок с однострочными аннотациями и wiki-ссылками (`[[...]]`) между ними.
+
+## Архитектура
+Модулей/сервисов нет — это граф взаимосвязанных заметок. Ниже — карта wiki-ссылок (`[[...]]`) между файлами памяти.
+
+```mermaid
+graph TD
+  IDX[MEMORY.md — индекс]
+  EXCH[servaki-agent-exchange]
+  REPOS[servaki-gitea-repos]
+  BRANCH[servaki-git-branch-workflow]
+  YAUTH[servaki-monitor-yauth-auth]
+  NAMING[servaki-orbita-naming]
+  MEDIA[media-gen-skills]
+  GATE[servaki-gate-project]
+
+  IDX --> EXCH
+  IDX --> REPOS
+  IDX --> BRANCH
+  IDX --> YAUTH
+  IDX --> NAMING
+  IDX --> MEDIA
+  IDX --> GATE
+
+  EXCH --> REPOS
+  REPOS --> EXCH
+  BRANCH --> EXCH
+  BRANCH --> REPOS
+  YAUTH --> REPOS
+  NAMING --> REPOS
+  NAMING --> YAUTH
+  MEDIA --> EXCH
+  GATE --> REPOS
+  GATE --> EXCH
+```
+
+## Entry-points / маршруты
+HTTP entry-points **отсутствуют** — репозиторий не содержит исполняемого кода (только `.md` + `.gitignore`). «Точки входа» здесь = файлы знаний.
+
+| Файл | Тип | О чём |
+|------|-----|-------|
+| `MEMORY.md` | index | Оглавление всех заметок |
+| `servaki-agent-exchange.md` | project | Git-канон (Gitea) + Nextcloud-обмен, роли агентов, `agent-sync`/`ncx.sh` |
+| `servaki-gitea-repos.md` | project | Карта флота Gitea (~46 репо), категории |
+| `servaki-git-branch-workflow.md` | feedback | Правило: фиксы через ветку+PR, не в main |
+| `servaki-monitor-yauth-auth.md` | project | Демо-вход `?yauth` зажат (DEV+demo), прод — Яндекс ID |
+| `servaki-orbita-naming.md` | project | «Орбита» = мониторинг, НЕ репо `orbit-*` |
+| `media-gen-skills.md` | reference | Скилы Runway/Together/hyperframes, окружение ноута |
+| `servaki-gate-project.md` | project | «Ворота» gate-web-relay: реле SR-201 + VPS FastAPI + бот |
+
+## Ключевые цепочки вызовов
+Т.к. кода нет, «цепочки» = сценарии использования памяти агентом.
+
+1. **Старт задачи по servaki** → читать `MEMORY.md` → по ссылке в `servaki-agent-exchange` (где git-канон, где секреты `~/.servaki-secrets/*.env`) → в `servaki-gitea-repos` (какой из ~46 репо трогать).
+2. **Правка любого репо** → `servaki-git-branch-workflow`: создать `fix/*`/`feat/*`, пуш ветки с токеном из `gitea-token.env`, открыть PR, не мерджить без подтверждения.
+3. **Слово «Орбита» от оператора** → `servaki-orbita-naming`: это мониторинг (`servaki-monitor` + `servaki-gps-monitoring`), НЕ боты `orbit-*` (Камелия). Далее `servaki-monitor-yauth-auth`: не ослаблять `?yauth`.
+4. **Задача про Nextcloud/Web-UI/app-password** → `servaki-agent-exchange`: делает браузерный агент, laptop-agent готовит промпт; блокер — нет app-password для headless `ncx`.
+5. **Генерация медиа (видео/звук/картинки)** → `media-gen-skills`: какие скилы стоят, чего не хватает (API-ключи, Node/FFmpeg на ноуте нет), motion=hyperframes отложен.
+
+## Тех-долг
+> Пометка: всё ниже — **предположение** (эвристика на markdown), точность — через codebase-memory-mcp.
+
+- **Dead-code кандидаты:** исполняемого кода нет → классических dead-exports нет. Как «висячие» узлы можно рассматривать заметки, на которые нет входящих ссылок кроме индекса: `media-gen-skills`, `servaki-gate-project` ссылаются наружу, но входящих (кроме `MEMORY.md`) на них нет — низкая связность, не удалять (это листья-справочники).
+- **Возможные дубли/устаревание:**
+  - Счётчик репо расходится внутри одной заметки `servaki-gitea-repos`: «31» → «32» → «33» → «ВСЕГО 46». Требует консолидации в единый актуальный список (предположение).
+  - Пары легко спутать: `mpo-inform-site` vs `site-mpo-inform-ru`/`site-mpoinform-ru`; `delodecor` vs `site-delodecor-ru` — заметка прямо предупреждает «не путать».
+  - `servaki-monitor` упоминается с задвоением («servaki-monitor/servaki-monitor», «servaki-monitor/servaki-monitor») — вероятно опечатка/старый алиас.
+- **Статусные факты с датами** (протухают): «Nextcloud 33.0.6 на 2026-06-30», «обмен холодный с 06-17», «app-password не выдан» — нуждаются в periodic-ревизии.
+
+## Cross-service links (упоминания других сервисов/репо/доменов)
+Домены `*.servaki.online`: `git1.` (Gitea-канон), `n.` (Nextcloud-обмен), `gps.` (прод servaki-monitor), `gate.` (деплой Ворот), `192.168.1.120` (LAN-Gitea cascade).
+Инфра-узлы: mesh1 (+ сервер `261049` для gate), сервер/ВМ **«Лилия»/«Лес»** (headless-агент `lilia`), ноут `laptop-agent`, браузерный `claude-agent`.
+Репо из общего списка, упомянутые здесь: `agent-sync`, `Heritage`, `Afanasov-smart`, `KPgenerator`, `agro-panel`, `banya-bot`, `cascade-de-ru`, `cascade`, `delodecor`, `egorin`, `homeassistant-backup`, `home-router`, `gate-web-relay`, `leronx`, `lilia-ee-media-router`, `matrix-migration`, `mcp-hikvision`, `media-projects`, `mesh1-status`, `mesh2-status`, `mpo-design-system`, `ops-configs`, `orbit-bot`, `orbit-kameliya`, `router-koval`, `mpo-inform-site`, `servaki-gps-monitoring`, `servaki-infra`, `servaki-monitor`, `site-delodecor-ru`, `site-eba-sh-ru`, `site-egida1-ru`, `site-ermashova26-ru`, `site-idea-s-ru`, `site-mpo-inform-ru`, `site-mpoinform-ru`, `site-servaki-online`, `site-tempelhoff-ru`, `smartlight-panel`, `tempelhoff-pbx`, `user-mobile-wa`, `user-bitarov`, `vpn-clients`, `vpn-vps-ruslan`. Плюс `orbit-panel` (пустой).
+
+## TODO для Лилии (codebase-memory-mcp)
+- **Точный call-graph:** здесь кода нет — вместо call-graph построить **граф wiki-ссылок** (`[[...]]`) и front-matter `originSessionId`, связать заметки с реальными репо флота.
+- **Dead-code / устаревшие факты:** выявить протухшие статус-строки (даты, счётчики репо 31→46, «Nextcloud 33.0.6», «app-password не выдан») и слабосвязанные листья-заметки.
+- **Cross-service:** нормализовать упоминания ~44 репо и поддоменов `*.servaki.online` в машиночитаемые ребра «память → репо/сервис»; развести дубли (`mpo-inform-site` vs `site-mpo*`, `delodecor` vs `site-delodecor-ru`).
+- **Снапшот graph.db.zst:** сохранить снимок графа знаний (узлы=заметки, ребра=ссылки) для инкрементального обогащения; при новых сессиях мержить дельту, а не переписывать.