Repository navigation
Open
Description
Цель
Системный сборщик мусора (GC-модуль) в opencode-mem: каждая OpenCode-сессия помечает ресурсы, которые она создаёт (worktree, ZeroCreds-коннекшены, credentials, …), а при завершении сессии они автоматически выметаются. Кроссплатформенно на уровне плагина/леджера; платформенно-специфичная очистка изолирована в подключаемых коллекторах.
Проблема (логика)
- Сессии создают ресурсы, которые их переживают:
git worktree, ZeroCreds-коннекшены (macOS Keychain), credentials, subagent-артефакты. - Встроенной очистки нет. Worktree копятся (был ad-hoc
scripts/prune-worktrees.shв цепочке groom, в мейн не вошёл), ZeroCreds-коннекшены копятся (реально висит 11, часть с 401cloudflare_token_context_unconfirmed). У Claude Code та же дыра — нетclaude gc, только открытые фича-реквесты (Add cleanup/GC for stale session artifacts (todos, team inboxes, sub-agent state) anthropics/claude-code#44917, #93988). - Всё нужное уже есть в форке, осталось собрать:
- подписка плагина на события —
ctx.event.subscribe({ types: ["session.deleted"] }); - нативные API —
Worktree.Service(list/create/remove) иcredential(CRUD); - паттерн леджера —
operational-memory+mem_record(таблица +*-store.ts+ тул-плагин).
- подписка плагина на события —
Архитектура (решение)
- Леджер — таблица
gc_record(БД):session_id → { kind, ref, force, status }, по образцуmem_record.project_idберём из сессии, как делаетmem-record-store. - Тул
gc_tag— агент регистрирует созданный ресурс (каталог worktree,connection_id, credential id) с флагомforce(можно ли автоудалять без подтверждения). - Коллекторы — подключаемые, каждый умеет удалять один вид ресурса:
worktree— нативныйWorktree.Service.remove(кроссплатформенно);zerocreds— MCPconnection_delete(mac-gated, Keychain);credential— нативныйcredentialAPI.
- Триггер выметания — на
session.deletedплагин загружает активные ресурсы сессии, просит каждый коллектор удалить их, строки помечаетswept/failed. - Орфан-вымет + ручной режим — тул/команда
gcдля on-demand чистки и сверки ресурсов, чья сессия уже не существует (процесс мог умереть безsession.deleted).
План (шаги)
- 1. Скелет + ворктри-коллектор — таблица
gc_record+ drizzle-миграция,gc-record-store.ts, тулgc_tag, коллекторworktree, подписка наsession.deleted, регистрация плагина вinternal.ts. Кроссплатформенно. - 2. ZeroCreds-коллектор (mac-gated) + вымет коннекшенов через
connection_delete. - 3. Credential-коллектор (нативный
credentialAPI). - 4. Орфан-вымет + ручной
gcтул/команда + видимость в TUI (gc status). - 5. Политика хранения/безопасность:
forceпо умолчанию off, авто-вымет толькоforce-помеченных; журналfailedдля диагностики.
Критерии приёмки (шаг 1)
- Тул
gc_tagрегистрирует ресурс за текущей сессией; дубль по(session_id, kind, ref)не плодится. - На
session.deletedпомеченный ворктри удаляется черезWorktree.Service.remove, строка становитсяswept. force: falseресурс на авто-вымете не удаляется, помечаетсяfailed/остаётсяactiveс причиной.- Юнит-тесты леджера + коллектора проходят в
packages/core.
Metadata
Metadata
Assignees
Labels
No labels
Activity