opencode-claude-memory 1.3.1 → 1.5.0

package/README.md

@@ -65,6 +65,12 @@ opencode-memory uninstall   # removes shell hook from .zshrc/.bashrc
 npm uninstall -g opencode-claude-memory
 ```
 
+To print the wrapper package version:
+
+```bash
+opencode-memory self -v
+```
+
 This removes the shell hook, the CLI, and the plugin. Your saved memories in `~/.claude/projects/` are **not** deleted.
 
 ## 💡 Why this exists
@@ -110,6 +116,7 @@ The shell hook defines an `opencode()` function that delegates to `opencode-memo
 6. It evaluates the auto-dream gate (default: at least 24h since last consolidation and 5 touched sessions)
 7. If the gate passes, it runs a background consolidation pass to merge/prune memories
 8. Maintenance runs **in the background** unless `OPENCODE_MEMORY_FOREGROUND=1`
+9. Terminal maintenance logs are shown in foreground mode by default, or can be forced on/off with `OPENCODE_MEMORY_TERMINAL_LOG=1|0`
 
 ### Compatibility details
 
@@ -156,6 +163,7 @@ Yes. Set `OPENCODE_MEMORY_AUTODREAM=0`. You can also tune gates with:
 
 - `OPENCODE_MEMORY_EXTRACT` (default `1`): set `0` to disable automatic memory extraction
 - `OPENCODE_MEMORY_FOREGROUND` (default `0`): set `1` to run maintenance in foreground
+- `OPENCODE_MEMORY_TERMINAL_LOG` (default `foreground-only`): set `1` to force terminal logs on, `0` to force them off
 - `OPENCODE_MEMORY_MODEL`: override model used for extraction
 - `OPENCODE_MEMORY_AGENT`: override agent used for extraction
 - `OPENCODE_MEMORY_AUTODREAM` (default `1`): set `0` to disable auto-dream consolidation
@@ -170,6 +178,8 @@ Logs are written to `$TMPDIR/opencode-memory-logs/`:
 - `extract-*.log`: automatic memory extraction
 - `dream-*.log`: auto-dream consolidation
 
+By default, terminal log lines are only printed when maintenance runs in foreground (`OPENCODE_MEMORY_FOREGROUND=1`). Background runs stay quiet unless you explicitly set `OPENCODE_MEMORY_TERMINAL_LOG=1`.
+
 ### Concurrency safety
 
 Lock files prevent concurrent extraction/consolidation runs per project root. Stale locks are cleaned up automatically.

package/bin/opencode-memory

@@ -8,6 +8,7 @@
 # Subcommands:
 #   opencode-memory install    — Install shell hook to ~/.zshrc or ~/.bashrc
 #   opencode-memory uninstall  — Remove shell hook
+#   opencode-memory self -v    — Print the wrapper package version
 #   opencode-memory [args...]  — Run opencode with post-session memory maintenance
 #
 # How it works:
@@ -26,6 +27,7 @@
 # Environment variables:
 #   OPENCODE_MEMORY_EXTRACT=0                 — Disable post-session extraction
 #   OPENCODE_MEMORY_FOREGROUND=1              — Run maintenance in foreground (debug)
+#   OPENCODE_MEMORY_TERMINAL_LOG=1|0          — Force-enable/disable terminal logs (default: foreground only)
 #   OPENCODE_MEMORY_MODEL=...                 — Extraction model override
 #   OPENCODE_MEMORY_AGENT=...                 — Extraction agent override
 #   OPENCODE_MEMORY_AUTODREAM=0               — Disable auto-dream consolidation
@@ -38,6 +40,22 @@
 
 set -euo pipefail
 
+SCRIPT_DIR="$(CDPATH= cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
+PACKAGE_JSON="$SCRIPT_DIR/../package.json"
+
+print_wrapper_version() {
+  local version
+
+  version=$(awk -F'"' '/^[[:space:]]*"version"[[:space:]]*:/ { print $4; exit }' "$PACKAGE_JSON")
+
+  if [ -z "$version" ]; then
+    echo "[opencode-memory] ERROR: Cannot read package version from $PACKAGE_JSON" >&2
+    exit 1
+  fi
+
+  printf '%s\n' "$version"
+}
+
 # ============================================================================
 # Shell Hook Management
 # ============================================================================
@@ -137,6 +155,14 @@ case "${1:-}" in
     uninstall_hook
     exit 0
     ;;
+  self)
+    case "${2:-}" in
+      -v|--version|version)
+        print_wrapper_version
+        exit 0
+        ;;
+    esac
+    ;;
 esac
 
 # ============================================================================
@@ -164,6 +190,7 @@ REAL_OPENCODE="$(find_real_opencode)"
 
 EXTRACT_ENABLED="${OPENCODE_MEMORY_EXTRACT:-1}"
 FOREGROUND="${OPENCODE_MEMORY_FOREGROUND:-0}"
+LOG_ENABLED="${OPENCODE_MEMORY_TERMINAL_LOG:-}"
 EXTRACT_MODEL="${OPENCODE_MEMORY_MODEL:-}"
 EXTRACT_AGENT="${OPENCODE_MEMORY_AGENT:-}"
 
@@ -295,7 +322,17 @@ EOF
 # Helper Functions
 # ============================================================================
 
+should_log() {
+  if [ -n "$LOG_ENABLED" ]; then
+    [ "$LOG_ENABLED" = "1" ]
+    return $?
+  fi
+
+  [ "$FOREGROUND" = "1" ]
+}
+
 log() {
+  should_log || return 0
   echo "[opencode-memory] $*" >&2
 }
 
@@ -303,6 +340,15 @@ is_positive_int() {
   [[ "$1" =~ ^[0-9]+$ ]] && [ "$1" -gt 0 ]
 }
 
+is_bool_flag() {
+  [ "$1" = "0" ] || [ "$1" = "1" ]
+}
+
+if [ -n "$LOG_ENABLED" ] && ! is_bool_flag "$LOG_ENABLED"; then
+  echo "[opencode-memory] Invalid OPENCODE_MEMORY_TERMINAL_LOG=$LOG_ENABLED, expected 0 or 1; defaulting to foreground-only logging" >&2
+  LOG_ENABLED=""
+fi
+
 if ! is_positive_int "$AUTODREAM_MIN_HOURS"; then
   log "Invalid OPENCODE_MEMORY_AUTODREAM_MIN_HOURS=$AUTODREAM_MIN_HOURS, using default 24"
   AUTODREAM_MIN_HOURS=24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-claude-memory",
-  "version": "1.3.1",
+  "version": "1.5.0",
   "type": "module",
   "description": "Claude Code-compatible memory compatibility layer for OpenCode — zero config, local-first, no migration",
   "main": "src/index.ts",