Skip to content

epic: session-scoped resource garbage collector (gc module) #218

Open

Description

@kobzevvv

Цель

Системный сборщик мусора (GC-модуль) в opencode-mem: каждая OpenCode-сессия помечает ресурсы, которые она создаёт (worktree, ZeroCreds-коннекшены, credentials, …), а при завершении сессии они автоматически выметаются. Кроссплатформенно на уровне плагина/леджера; платформенно-специфичная очистка изолирована в подключаемых коллекторах.

Проблема (логика)

  • Сессии создают ресурсы, которые их переживают: git worktree, ZeroCreds-коннекшены (macOS Keychain), credentials, subagent-артефакты.
  • Встроенной очистки нет. Worktree копятся (был ad-hoc scripts/prune-worktrees.sh в цепочке groom, в мейн не вошёл), ZeroCreds-коннекшены копятся (реально висит 11, часть с 401 cloudflare_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 + тул-плагин).

Архитектура (решение)

  1. Леджер — таблица gc_record (БД): session_id → { kind, ref, force, status }, по образцу mem_record. project_id берём из сессии, как делает mem-record-store.
  2. Тул gc_tag — агент регистрирует созданный ресурс (каталог worktree, connection_id, credential id) с флагом force (можно ли автоудалять без подтверждения).
  3. Коллекторы — подключаемые, каждый умеет удалять один вид ресурса:
    • worktree — нативный Worktree.Service.remove (кроссплатформенно);
    • zerocreds — MCP connection_delete (mac-gated, Keychain);
    • credential — нативный credential API.
  4. Триггер выметания — на session.deleted плагин загружает активные ресурсы сессии, просит каждый коллектор удалить их, строки помечает swept/failed.
  5. Орфан-вымет + ручной режим — тул/команда 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-коллектор (нативный credential API).
  • 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.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions