@jarkkojs/goosedump 0.12.10 → 0.12.11

package/README.md

@@ -46,39 +46,54 @@ session list [--query QUERY] [--json]
 session show PROVIDER:ID [--entry ID] [--all] [--from ID] [--before ID] [--as PROVIDER]
 session find PROVIDER:ID GLOB [range options] [--as PROVIDER]
 session search PROVIDER:ID QUERY [range options] [--page NUMBER] [--as PROVIDER]
-session compact PROVIDER:ID [range options] [--previous-summary SUMMARY] [--summary-max-tokens NUMBER] [--plain] [--remember] [--as PROVIDER]
+session compact PROVIDER:ID [range options] [--previous-summary SUMMARY] [--summary-max-tokens NUMBER] [--plain] [--as PROVIDER]
 session copy PROVIDER:ID --to PROVIDER [--yes]
 session remove PROVIDER:ID [--yes]
 
-memory search QUERY [--provider PROVIDER] [--path PATH] [--type TYPE] [--limit NUMBER]
-memory status
-memory forget HASH|PROVIDER:ID
+memory remember PROVIDER:ID [--all] [--json]
+memory recall QUERY [--project PATH | --all-projects] [--type TYPE] [--limit NUMBER] [--max-tokens NUMBER] [--history] [--json]
+memory list [--project PATH | --all-projects] [--type TYPE] [--limit NUMBER] [--history] [--json]
+memory show MEM_ID [--json]
+memory forget MEM_ID|PROVIDER:ID [--yes] [--json]
+memory status [--json]
 
-model pull
+model pull [all|embedding|text]
 ```
 
-`session copy` and `session remove` print their plan by default. Pass `--yes`
-to carry out the change. This makes destructive and cross-provider operations
-safe to inspect without a separate dry-run mode.
+`session copy`, `session remove`, and `memory forget` print their plan by default.
+Pass `--yes` to carry out the change.
 
 ## Persistent memory
 
-`session compact` emits a summary without retaining the selected range. Add
-`--remember` only when the selected content may become durable memory.
+`session compact` only creates a bounded summary; it never changes durable memory.
+Use `memory remember PROVIDER:ID` to retain unseen source events and extract atomic
+facts, decisions, preferences, procedures, and lessons with exact provenance.
+Remembering the same unchanged session is idempotent. When a new statement is close
+to an existing active memory of the same type, the older memory is marked superseded
+and linked to the successor. Human and JSON reports list each added statement
+(with `mem_` IDs) and any memories it superseded.
+
+`memory recall` searches the current project by default and fills an estimated token
+budget with ranked active memories. It first preserves exact lexical and entity-anchor
+matches (paths, crates, symbols, commands, concepts), expands through shared anchors,
+then fills remaining slots with BGE semantic matches. Existing databases are embedded
+in bounded batches; `memory status` reports indexed and pending counts. Pass `--history`
+to include superseded statements. Use `memory list` to browse, `memory show` to inspect
+provenance revision hashes, entities, and supersession links, and `memory forget` to preview
+deletion. Forgetting a memory ID removes the
+derived statement; forgetting `provider:session-id` removes that session's retained
+source events. Applied forgetting leaves content-free tombstones so deleted memory is
+not learned again accidentally.
+
 Summary output is bounded to an estimated 4096 tokens by default. Set
 `--summary-max-tokens NUMBER` to choose another budget, or use `0` for no limit.
 The bound is best-effort when preserved goals, blockers, decisions, and preferences
 alone exceed it.
 
-Use `memory search` to retrieve learned decisions, facts, preferences,
-procedures, and episodes; `memory status` to inspect the store; and
-`memory forget` with a hash printed by `memory search` or a `provider:session-id`
-to remove it. Forgetting creates durable tombstones so the same content is not
-learned again accidentally.
-
-Persistent formats are versioned and never migrated. An incompatible cache is
-rebuilt, while an incompatible memory database is rejected and must be
-reinitialized explicitly. A prior schema is never transformed in place.
+Session-index caches are versioned clean-break formats and are rebuilt when
+incompatible. Durable memory migrations preserve existing sources, statements, and
+evidence links; an unsupported schema version is rejected and must be reinitialized
+explicitly.
 
 ## Inference performance
 
@@ -90,8 +105,11 @@ GOOSEDUMP_INFERENCE_THREADS=6 \
 goosedump session compact pi:context-id
 ```
 
-GPT-OSS-20B text generation continues to use goosedump's custom CPU engine.
-Download its weights ahead of time with `goosedump model pull`.
+Compaction directive selection and durable-memory extraction use goosedump's custom
+GPT-OSS-20B CPU engine. Semantic recall uses the pinned 36.7 MB BGE-small-en-v1.5
+`Q8_0` encoder. Download both ahead of time with `goosedump model pull`, or select one
+with `goosedump model pull text` or `goosedump model pull embedding`. Recall falls back
+to lexical and entity matching when the embedding model is not cached.
 
 The `bench` feature builds a standalone harness that shells out to
 `goosedump session compact` with `GOOSEDUMP_PROFILE_COMPACT=1` and reports

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jarkkojs/goosedump",
-  "version": "0.12.10",
+  "version": "0.12.11",
   "description": "Coding agent context data browser",
   "license": "Apache-2.0 AND LGPL-2.1-or-later",
   "homepage": "https://github.com/jarkkojs/goosedump#readme",
@@ -21,10 +21,10 @@
     "LICENSE-LGPL-2.1"
   ],
   "optionalDependencies": {
-    "@jarkkojs/goosedump-darwin-arm64": "0.12.10",
-    "@jarkkojs/goosedump-linux-arm64": "0.12.10",
-    "@jarkkojs/goosedump-linux-x64": "0.12.10",
-    "@jarkkojs/goosedump-win32-x64": "0.12.10"
+    "@jarkkojs/goosedump-darwin-arm64": "0.12.11",
+    "@jarkkojs/goosedump-linux-arm64": "0.12.11",
+    "@jarkkojs/goosedump-linux-x64": "0.12.11",
+    "@jarkkojs/goosedump-win32-x64": "0.12.11"
   },
   "publishConfig": {
     "access": "public"