From 84aa02077453a9dd0c897385ef95a8fd9eb68f88 Mon Sep 17 00:00:00 2001 From: Ralph Chang Date: Sat, 2 May 2026 20:49:23 +0800 Subject: [PATCH] chore(release): prepare v1.5.3 --- CHANGELOG.md | 20 ++++++++++++++++++++ RELEASE_NOTES.md | 29 +++++++++++++++++++++++++++++ package.json | 2 +- 3 files changed, 50 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 0f95ec2..ff47891 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,6 +5,26 @@ All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). +## [1.5.3] - 2026-05-02 + +### Added + +- Published the read-only `memory-diag` package binary for package-qualified `npx --package opencode-working-memory memory-diag` usage. +- Added user-facing diagnostics commands for concise status, rejected memory review, missing memory review, and per-memory explanation. + +### Changed + +- Reworked the diagnostics CLI into focused command, model, formatter, and utility modules while preserving legacy aliases and maintainer diagnostics. +- Updated README and configuration docs to document the supported `memory-diag` CLI workflow and package-qualified `npx` usage. +- Raised the Node.js requirement to `>=22.6.0` for the TypeScript diagnostics CLI runtime. + +### Fixed + +- Avoided repeated workspace snapshot construction in status diagnostics. +- Replaced per-memory evidence summary lookups with grouped evidence processing to avoid N+1 diagnostics work. +- Added top-level CLI error handling for cleaner user-facing failures. +- Removed a diagnostics model circular dependency by extracting evidence grouping helpers to a neutral module. + ## [1.5.1] - 2026-04-30 ### Added diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md index 82f53c7..6134353 100644 --- a/RELEASE_NOTES.md +++ b/RELEASE_NOTES.md @@ -1,5 +1,34 @@ # Release Notes +## 1.5.3 (2026-05-02) + +### Published Memory Diagnostics CLI + +This release makes the read-only workspace memory diagnostics CLI available as the package binary `memory-diag`, with user-facing commands for checking memory health and understanding why memories are rejected, missing, shown, or hidden. + +> Good memory is selective memory — and diagnostics should explain the selection. + +### What Changed + +- **Published CLI bin**: run diagnostics with `npx --package opencode-working-memory memory-diag` or `memory-diag status`. +- **User-facing commands**: `status`, `rejected`, `missing`, and `explain ` are documented as the supported public workflow. +- **Legacy compatibility**: existing maintainer and legacy commands remain accepted with deprecation notices where applicable. +- **Cleaner CLI architecture**: the former monolithic diagnostics script is now split into focused command, model, formatter, and utility modules. +- **Faster diagnostics**: evidence grouping avoids repeated per-memory evidence queries in snapshot diagnostics. +- **Cleaner failures**: top-level CLI error handling now reports usage and unexpected command errors without noisy stack traces. +- **Docs alignment**: README and configuration docs now use package-qualified `npx` commands to avoid resolving an unrelated package named `memory-diag`. + +### Requirements + +- Node.js `>=22.6.0` is now required because the published diagnostics binary runs TypeScript through Node's `--experimental-strip-types` support. + +### Validation + +- `npm run typecheck` — `TYPECHECK_PASS` +- `npm test` — 358 tests passing, `TEST_PASS` + +--- + ## 1.5.1 (2026-04-30) ### Evidence Loop and Explainability diff --git a/package.json b/package.json index a090e58..351cf5d 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "opencode-working-memory", - "version": "1.5.2", + "version": "1.5.3", "description": "Three-layer memory architecture for OpenCode with workspace memory and hot session state", "type": "module", "main": "index.ts",