From 22774c5ed2588444061d70a734f3f7ab0ea55524 Mon Sep 17 00:00:00 2001
From: Ralph Chang <sdwolf4103@gmail.com>
Date: Sun, 26 Apr 2026 14:18:34 +0800
Subject: [PATCH] docs: add RELEASE_NOTES.md for v1.2.0

---
 RELEASE_NOTES.md | 111 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 111 insertions(+)
 create mode 100644 RELEASE_NOTES.md

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
new file mode 100644
index 0000000..e984631
--- /dev/null
+++ b/RELEASE_NOTES.md
@@ -0,0 +1,111 @@
+# Release Notes
+
+## 1.2.0 (2026-04-26)
+
+### Memory V2 Architecture
+
+This release introduces a complete architectural redesign from the previous four-tier memory system to a streamlined three-layer architecture:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  LAYER 1: WORKSPACE MEMORY                                       │
+│  Persists across sessions in same workspace (survives restart)  │
+│  Extracted during compaction - NO EXTRA API CALL                │
+└──────────────────────────────────────────────────────────────────┘
+          ↑
+┌──────────────────────────────────────────────────────────────────┐
+│  LAYER 2: HOT SESSION STATE                                      │
+│  Per-session, auto-tracked, resets on new session                │
+│  Tracks: Active files, Open errors, Recent decisions            │
+└──────────────────────────────────────────────────────────────────┘
+          ↑
+┌──────────────────────────────────────────────────────────────────┐
+│  LAYER 3: NATIVE OPENCODE STATE                                  │
+│  Uses OpenCode's built-in todos - No plugin storage needed       │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+### Key Features
+
+- **Cross-session memory**: Workspace memory persists between sessions in the same workspace
+- **No extra API calls**: Memory extraction piggybacks on OpenCode's existing compaction summary
+- **Zero configuration**: Works out of the box with sensible defaults
+- **Zero tools**: No manual memory management needed - fully automatic
+
+### Added
+
+- **Workspace Memory**: Long-term memory that survives restarts and compactions
+  - Types: `feedback`, `project`, `decision`, `reference`
+  - Sources: `explicit` (user), `compaction`, `manual`
+  - Limits: 5200 chars / 28 entries
+
+- **Hot Session State**: Automatic tracking for current session
+  - Active files with action-based ranking
+  - Open errors with fingerprinting
+  - Recent decisions for compaction promotion
+
+- **Quality Gates**:
+  - Canonical deduplication of workspace memories
+  - Negative memory request filtering ("don't remember")
+  - Compaction quality gate (rejects git hashes, stack traces, path-heavy facts)
+
+### Fixed
+
+- **False positive error tracking**: `exitCode === undefined` no longer creates spurious errors from commands like `git log` or `cat`
+- **XML truncation**: Workspace memory rendering never truncates closing `</workspace_memory>` tag
+- **Negative memory filtering**: Correctly interprets "don't remember this" and "不要記住"
+- **"always" trigger removed**: No longer treats "always" as a memory trigger keyword
+
+### Changed
+
+- **Storage location**: `~/.local/share/opencode-working-memory/workspaces/{workspaceKey}/`
+- **No manual tools**: Removed `core_memory_update`, `core_memory_read` - memory is fully automatic
+- **Hook-based extraction**: Memory is extracted during `experimental.session.compacting` hook
+
+### Breaking Changes
+
+- Previous four-tier architecture is replaced with three-layer architecture
+- Core Memory blocks (goal/progress/context) removed in favor of typed entries
+- Working Memory slots and pool replaced with Hot Session State
+- Pressure monitoring and smart pruning removed (not needed with new architecture)
+
+### Migration
+
+- Old memory files (`.opencode/memory-core/`, `.opencode/memory-working/`) are not migrated
+- New storage location is used (`~/.local/share/opencode-working-memory/`)
+- No action required - plugin starts fresh with new architecture
+
+### Technical Details
+
+- **Plugin entry**: `index.ts` exports `{ id: "working-memory", server: MemoryV2Plugin }`
+- **Hooks implemented**:
+  - `experimental.chat.system.transform` - Inject workspace memory and hot session state
+  - `tool.execute.after` - Track active files and open errors
+  - `experimental.session.compacting` - Extract workspace memory candidates
+  - `event` - Handle session lifecycle events
+
+### Files in Package
+
+```
+index.ts
+src/extractors.ts
+src/opencode.ts
+src/paths.ts
+src/plugin.ts
+src/session-state.ts
+src/storage.ts
+src/types.ts
+src/workspace-memory.ts
+README.md
+LICENSE
+```
+
+---
+
+## 1.1.2 (Previous Version)
+
+- Four-tier memory architecture
+- Core Memory blocks (goal/progress/context)
+- Working Memory with slots and pool
+- Pressure monitoring with interventions
+- Smart pruning of tool outputs
\ No newline at end of file