@memstack/cli 0.5.0 → 0.7.0

package/README.md

@@ -1,6 +1,6 @@
 # @memstack/cli
 
-CLI for MemStack — shell-based agent memory. Use from bash scripts, Claude Code shell tool, CI pipelines, or any subprocess-capable agent.
+CLI for MemStack — shell-based agent memory. Use from bash scripts, opencode/Claude Code shell tools, CI pipelines, or any subprocess-capable agent.
 
 ## Installation
 
@@ -25,6 +25,7 @@ All via environment variables. Same scheme as @memstack/mcp.
 | `ANTHROPIC_API_KEY` | Anthropic LLM (summarization) | — |
 | `MEMSTACK_OPENAI_BASE_URL` | Custom API endpoint (DeepSeek, etc.) | `https://api.openai.com/v1` |
 | `MEMSTACK_LLM_MODEL` | Model override | `gpt-4o-mini` |
+| `MEMSTACK_EMBED_ON_STORE` | Auto-embed on store | `true` |
 
 ## Commands
 
@@ -105,6 +106,18 @@ memstack import --actor "agent-1" --file ./backup.json
 # {"imported":1500}
 ```
 
+Each memory's original `createdAt` is preserved on import (round-trips exactly with `export`). Importing a snapshot with zero memories fails cleanly with a non-zero exit.
+
+## Input validation
+
+The CLI normalizes and validates input before storing:
+
+- **`--importance`** is clamped to the `0.0–1.0` range (e.g. `--importance 5` stores as `1`, `--importance=-1` stores as `0`).
+- **`--actor`** is trimmed of leading/trailing whitespace (`--actor "  a  "` and `--actor a` are the same actor).
+- **`--tags`** drops empty entries from trailing/double commas (`--tags "a,,b,"` → `["a","b"]`).
+- **`prune --type`** rejects unknown strategies with a non-zero exit instead of silently doing nothing. Valid: `byAge`, `byImportance`, `byCount`, `byType`, `custom`, `compose`.
+- **`prune --actor`** is scoped to that actor only — it never touches other actors' memories.
+
 ## Shell agent usage
 
 ```bash