From 84dd6fcee4c068bfce5889ce88930491769d0e6a Mon Sep 17 00:00:00 2001 From: jester Date: Sat, 28 Feb 2026 22:26:55 +0000 Subject: [PATCH] docs: append current mod lifecycle model (Feb 2026 implementation state) --- docs/architecture/mod-deployment-safety.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/docs/architecture/mod-deployment-safety.md b/docs/architecture/mod-deployment-safety.md index 164ad09..e5c634d 100644 --- a/docs/architecture/mod-deployment-safety.md +++ b/docs/architecture/mod-deployment-safety.md @@ -306,3 +306,25 @@ This system guarantees: | World data | Excluded, never touched | | Stabilization window | Fixed, hardcoded Phase 1 | | Autonomy | Agent-level, no operator required | + +--- + +## Current Mod Lifecycle Model (2026-02) + +This section reflects the **implemented Phase 1 state** as of February 2026. + +**Install:** +Modrinth resolver → API → Agent → Verified download → `/mods` + +**Enable/Disable:** +Filesystem rename: `.jar` ↔ `.jar.disabled` + +**Delete:** +Soft delete to `/mods-removed` (no auto-purge, no retention policy) + +**Filesystem is canonical state.** +Agent cache invalidated after every mutation. + +Restore of deleted mods handled manually via file browser (planned — see `OPEN_THREADS.md`). + +No retention policy implemented. No install queue. No DB tracking of mod state.