[2026-05-17] htpc-emulators-setup: Windows games Proton, SteamGridDB key, Rayman save

wiki/concepts/agent-memory-architecture.md

@@ -0,0 +1,75 @@
+---
+namespace: work
+tags: [system, agent, memory, architecture, ai]
+created: '2026-05-18'
+updated: '2026-05-18'
+last_synced: '2026-05-18'
+confidence: 0.85
+sources:
+  - arXiv 2603.07670 (Memory for Autonomous LLM Agents, март 2026)
+  - zylos.ai AI Agent Memory Architectures survey (апрель 2026)
+  - wiki/raw/inbox/research-vault-strategy-memory-20260516.md
+---
+# Agent Memory Architecture
+
+Когнитивная таксономия памяти для LLM-агентов, основанная на arXiv 2603.07670. Применительно к personal-os (Hermes).
+
+## Три уровня памяти
+
+| Уровень | Определение | Реализация в Hermes |
+|---------|-------------|----------------------|
+| **Episodic** | Сессионные логи — что произошло в конкретных взаимодействиях | SQLite + `session_search` ✅ |
+| **Semantic** | Факты, предпочтения, постоянное знание | `MEMORY.md` + `USER.md` (нужна curation) |
+| **Procedural** | Навыки, workflows, пошаговые паттерны | `skills/` ✅ |
+
+## Ключевые выводы из arXiv 2603.07670
+
+- **Gap между "есть память" и "нет памяти"** > gap между разными LLM backbone. Выбор памяти важнее выбора модели.
+- **Без рефлексии агент деградирует:** в Generative Agents эксперименте — 48 ч без memory reflection → repetitive behavior.
+- **Summarization drift:** после 3+ циклов сжатия критические инструкции теряются. Решение: vault как immutable store, не только MEMORY.md.
+
+## Overflow Rule (MEMORY.md)
+
+Запись в MEMORY.md — только короткие стабильные факты:
+- Длина > 150 символов → перенести в vault, оставить pointer
+- Содержит пошаговые инструкции → в `skills/`
+- Детальный технический контекст → в `wiki/tech/`
+
+```
+MEMORY.md: "media-pipeline питфолы → wiki/tech/media-pipeline-pitfalls.md"
+wiki/tech/media-pipeline-pitfalls.md: (полный разбор)
+```
+
+## 4-tier pipeline (LLM Wiki v2 / rohitg00)
+
+Расширенная модель:
+```
+Working Memory   → сырые наблюдения текущей сессии
+Episodic Memory  → сжатые саммари сессий
+Semantic Memory  → кросс-сессионные факты (wiki)
+Procedural Memory → паттерны, workflows, skills
+```
+
+**Confidence scoring:** каждый факт имеет score (кол-во источников, свежесть, противоречия). Устаревает со временем.
+
+**Event-driven automation:**
+- New source → auto-ingest
+- Session end → compress into observations
+- On query → check if answer worth filing back
+- On schedule → periodic lint
+
+## Правило разграничения (Alex's personal-os)
+
+```
+MEMORY.md       → SSH хосты, namespace rules, токены, конфиги (≤150 chars)
+USER.md         → предпочтения, стиль (редко меняется)
+wiki/tech/      → технические питфолы, баг-паттерны (длинные, с контекстом)
+personal/projects/ → статус проектов, дебаггинг-логи
+skills/         → процедуры и workflows пошагово
+```
+
+## Связанные страницы
+
+- [[personal-os-architecture]] — как память встроена в общий стек
+- [[wiki-ingest-process]] — как сессии кристаллизуются в wiki
+- [[personal-os-self-modification]] — как система эволюционирует

wiki/concepts/vault-strategy.md

@@ -0,0 +1,59 @@
+---
+namespace: work
+tags: [system, vault, obsidian, strategy, llm-wiki, enrichment]
+created: '2026-05-18'
+updated: '2026-05-18'
+last_synced: '2026-05-18'
+confidence: 0.9
+sources:
+  - personal/projects/personal-os/obsidian-vault-strategy.md
+  - wiki/raw/inbox/research-vault-strategy-memory-20260516.md
+---
+# Vault Strategy — Три задачи
+
+Ключевой принцип: три разных задачи, которые **нельзя смешивать**.
+
+## Три задачи
+
+| Задача | Что это | Где |
+|--------|---------|-----|
+| **A: Vault Enrichment** | frontmatter + aliases + wikilinks на личные заметки → searchable | `personal/`, `family/` |
+| **B: LLM Wiki** | research сессии → wiki pages → compounding knowledge base | `wiki/` |
+| **C: Proactive Research** | агент сам генерирует гипотезы и исследует | `wiki/research-queue.md` → Saturday cron |
+
+## Ключевые принципы
+
+### Topic Map как источник правды
+`family/index.md` и `personal/index.md` — не каталоги файлов, а **топик-карты vault**:
+- Топики/кластеры (Алтай, Лаки Парк, Kraken, psychologist-app…)
+- Какие файлы принадлежат каждому кластеру
+- Hub-note каждого кластера
+
+**Enrichment воркер читает карту первым делом**. Если находит новый кластер → добавляет в карту. Карта самодополняется.
+
+### Karpathy LLM Wiki — что это и что нет
+- **Да:** `wiki/` для накопления research о технике, workflows, инфраструктуре, AI tools
+- **Нет:** личные списки (дела, фильмы, покупки)
+- **Да:** crystallization — research сессии → wiki pages
+- **Нет:** операционные логи, разовые фиксы
+
+### Overflow: когда заметка идёт в wiki
+- Знание **painful to re-derive** (без wiki — 15 мин + 10 web-запросов повторно)
+- Фит с доменом wiki (tech, workflows, infra, AI tools)
+- Содержит факты, а не разговор
+
+## Статус проектов (2026-05-16)
+
+| Проект | Статус |
+|--------|--------|
+| Vault Enrichment | 🟡 В процессе (enrichment cron воскресенье 03:00) |
+| LLM Wiki Accumulation | ✅ Готов (crystallization + synthesize + inbox) |
+| Proactive Research | ✅ Готов (research-queue.md + cron суббота 05:00) |
+| Cross-domain Enrichment | ✅ Готов (vault-cross-enrichment cron воскресенье 04:00) |
+
+## Связанные страницы
+
+- [[vault-filling-guide]] — что куда в vault
+- [[wiki-ingest-process]] — как wiki-curation работает
+- [[personal-os-architecture]] — полная картина системы
+- [[concepts/agent-memory-architecture]] — память агента (семантический уровень)

wiki/entities/library-app.md

@@ -0,0 +1,69 @@
+---
+namespace: work
+tags: [system, tool, infrastructure, taiga]
+created: '2026-05-18'
+updated: '2026-05-18'
+last_synced: '2026-05-18'
+confidence: 1.0
+sources:
+  - personal/projects/library-app.md
+---
+# Library App
+
+Персональный веб-интерфейс для библиотеки книг на TrueNAS (Taiga). Развёрнут 2026-05-16.
+
+## Что это
+
+Замена inpxer — полноценный сайт для просмотра коллекции Flibusta (687k книг) + личных книг, с отметками статуса чтения, связями между книгами и графом.
+
+## Доступ
+
+- **URL:** `https://library.mallexxx.duckdns.org`
+- **Контейнер:** `library-app` на TrueNAS (Taiga)
+- **Расположение:** `/mnt/RED_2TB/docker/library/`
+
+## Стек
+
+- Backend: Python + FastAPI
+- Frontend: Vue 3 + Tailwind CSS (CDN, без build)
+- Граф: vis.js
+- Контейнер: python:3.12-slim
+
+## Данные
+
+| Хранилище | Назначение | Лимит |
+|-----------|------------|-------|
+| `books.db` (SQLite) | Flibusta коллекция, пересоздаётся при старте из INPX (~23 сек) | 687k книг, 227 MB |
+| `library.db` (SQLite) | Персистентный: статусы чтения, связи | Никогда не удалять |
+
+**library.db таблицы:**
+- `read_log(book_id, status, date_updated, rating, notes)` — статусы `read | reading | want`
+- `relations(book_id, related_id, type, weight, fetched_at)` — кэш связей
+
+## Связи между книгами
+
+Строятся при первом открытии книги, кэшируются в `relations`:
+1. `same_author` — все книги автора (мгновенно из books.db)
+2. `same_series` — книги той же серии (мгновенно)
+3. `same_genre` — топ-20 жанра по дате (мгновенно)
+4. `openlibrary` — readers also read через OpenLibrary API (async, ~300ms, обновляется раз в 30 дней)
+
+## Ссылки на скачивание
+
+- Flibusta: `https://books.mallexxx.duckdns.org/download/{id}` (inpxer)
+- Личные книги: `https://docs.mallexxx.duckdns.org/books/{path}` (FileBrowser)
+
+## Известные питфолы
+
+- **inpxer Badger DB lock:** при последовательных/параллельных запросах к inpxer сервер зависает. Решение: скачивать книги с паузой ≥3 сек между запросами.
+- **books.db пересоздаётся при каждом перезапуске** (~23 сек) — нормальное поведение.
+- **library.db на хосте** — `docker rm` не удаляет. Важно: не монтировать как tmpfs.
+
+## Статус
+
+✅ Задеплоен 2026-05-16. 687,722 книг.
+
+## Связанные страницы
+
+- [[personal-os-architecture]] — Taiga как хост, TrueNAS infrastructure
+- [[personal-os-schema]] — паттерны хранения данных в personal-os

wiki/index.md

@@ -9,7 +9,7 @@ updated: '2026-05-16'
 # Wiki Index
 
 Auto-maintained catalog of all pages in `wiki/`. Updated by the daily curation cron.
-> Last updated: 2026-05-16 | Total pages: 16
+> Last updated: 2026-05-18 | Total pages: 19
 
 ## Core Architecture
 
@@ -30,6 +30,15 @@ Auto-maintained catalog of all pages in `wiki/`. Updated by the daily curation c
 
 - [[user-profile]] — Alex's personal profile: identity, family, work, interests, goals, travel plans
 
+## Concepts
+
+- [[concepts/agent-memory-architecture]] — Three-level memory model (episodic/semantic/procedural) for LLM agents; overflow rules; Hermes implementation
+- [[concepts/vault-strategy]] — Three distinct vault tasks: enrichment, LLM wiki accumulation, proactive research; topic map principle
+
+## Entities
+
+- [[entities/library-app]] — Personal book library web UI on TrueNAS (687k Flibusta + personal books, deployed 2026-05-16)
+
 ## Tech
 
 - [[tech/media-pipeline-pitfalls]] — Swift media-pipeline: §9.x score engine, transliteration, KP rate limit, Docker run pattern

wiki/log.md

@@ -43,7 +43,31 @@ Activity log for the daily Eagle wiki-curation cron job.
   - Page size: all pages under 200 lines ✅
   - New pages created: none
 
-## 2026-05-17
+## 2026-05-18
+
+- **Conflict scan:** No git conflict markers found across all ~/obsidian/ ✅
+- **Previous run (2026-05-17):** Status = complete, no Unfinished section — nothing to resume
+- **Change detection:** Key commits since last run:
+  - `[2026-05-17] Google Keep import: 20 notes, +7 appended, 162 → family/sort/` — operational import by Eagle
+  - `[2026-05-16] library-app: задеплоен на TrueNAS` — new infrastructure entity, wiki-worthy ✅
+  - `[2026-05-16] htpc-emulators-setup: Steam shortcuts + artwork` — operational, skill updated
+  - `family/sort/` now has 100+ unprocessed keep-* files — out of wiki scope, needs separate triage cron
+- **Architecture check:** `personal-os-architecture.md` current — no updates needed (library-app is on Taiga as expected)
+- **Inbox:** Processed `research-vault-strategy-memory-20260516.md` → created 2 concept pages; moved to processed/ ✅
+- **Sessions crystallized:** 7 sessions checked today
+  - media-pipeline runs (3 sessions) — operational, not crystallized
+  - Google Keep import (1 session) — workflow already in skills, not crystallized
+  - HTPC emulator setup (2 sessions) — MAME NeoGeo BIOS + Windows Proton + Steam shortcuts patterns → added to `steam-emulator-shortcuts` skill (done by Eagle, not wiki-scope)
+  - library-app / inpxer (1 session) — inpxer Badger DB lock → added to skill; library-app entity → wiki-worthy ✅
+- **New wiki pages created (3):**
+  - `concepts/agent-memory-architecture.md` — episodic/semantic/procedural taxonomy, overflow rules, Hermes implementation
+  - `concepts/vault-strategy.md` — three vault tasks (enrichment / LLM wiki / proactive research), topic map principle
+  - `entities/library-app.md` — TrueNAS book library UI, 687k Flibusta books, deployed 2026-05-16
+- **Synthesis page:** not created this run (inbox processing produced 2 new concept pages — sufficient)
+- **Stale check:** all pages current ✅
+- **Lint:** 21 wiki files; frontmatter: all OK ✅; wikilinks: all OK ✅; orphans: none ✅; page sizes: all under 200 lines ✅
+- **Index:** Bumped to 19 pages, last updated 2026-05-18; added Concepts and Entities sections
+- **Validation:** all 4 created/modified files passed validation checks ✅
 
 - **Conflict scan:** No git conflict markers found across all ~/obsidian/ ✅
 - **Previous run (2026-05-16 02:46):** Status = complete, no Unfinished section — nothing to resume