@jarkkojs/goosedump 0.12.10 → 0.12.12

package/README.md

@@ -1,8 +1,8 @@
 # goosedump
 
 `goosedump` browses, searches, converts, and compacts saved coding-agent
-conversations. It supports Claude Code, Codex, Crush, Gemini CLI, Goose,
-OpenCode, and Pi.
+conversations, and keeps project-scoped durable memory. It supports Claude Code,
+Codex, Crush, Gemini CLI, Goose, OpenCode, and Pi.
 
 It builds on ideas from [`lllyasviel/VCC`](https://github.com/lllyasviel/VCC).
 
@@ -46,71 +46,80 @@ 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
+## Compaction
 
-`session compact` emits a summary without retaining the selected range. Add
-`--remember` only when the selected content may become durable memory.
-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.
+`session compact` creates a summary; it never changes durable memory. Summaries are
+bounded to an estimated 4,096 tokens by default. Use `--summary-max-tokens` to
+change the budget or `0` to disable it. The bound is best-effort when preserved
+goals, blockers, decisions, and preferences already 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.
+## Durable memory
 
-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.
+Memory is explicit and separate from compaction:
 
-## Inference performance
+1. **Remember:** [`gpt-oss-20b`](docs/models/gpt-oss-20b.md) extracts typed,
+   atomic statements with source provenance. [`bge-small-en-v1.5`](docs/models/bge-small-en-v1.5.md)
+   embeds each statement. SQLite stores the statements, vectors, and provenance.
+2. **Recall:** lexical and entity matches come first. Cosine-similar BGE vectors
+   fill the remaining slots. There is no separate vector database.
 
-The custom GPT-OSS-20B CPU engine uses every logical CPU available to the
-process by default. Override the compute thread count:
+Memories are classified as decisions, facts, preferences, procedures, or lessons.
+
+`memory remember` processes only new session entries, so remembering an unchanged
+session is idempotent. A new version of a memory can supersede an older active
+statement of the same type.
+
+Recall searches active memories from the current project by default. Use
+`--history` for superseded statements or `--all-projects` to search everywhere.
+`memory show` displays provenance, and `memory forget` leaves a tombstone so
+forgotten content is not learned again accidentally.
+
+Session-index caches are rebuilt when their format changes. Durable-memory schema
+migrations preserve stored sources, statements, and evidence links.
+
+## Local inference
+
+Both models run locally. Download them with `goosedump model pull`, or use
+`model pull text` or `model pull embedding`. Recall still uses lexical and entity
+matching when the embedding model is not cached.
+
+Text inference uses every logical CPU by default. Override it with
+`GOOSEDUMP_INFERENCE_THREADS`:
 
 ```sh
-GOOSEDUMP_INFERENCE_THREADS=6 \
-goosedump session compact pi:context-id
+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`.
-
-The `bench` feature builds a standalone harness that shells out to
-`goosedump session compact` with `GOOSEDUMP_PROFILE_COMPACT=1` and reports
-end-to-end and per-stage timings:
+The optional `bench` feature measures `session compact`. Keep the machine,
+session range, and model cache unchanged when comparing runs:
 
 ```sh
-# Edit benches/bench.txt to point at a real context, then:
+# Point benches/bench.txt at a real session first.
 cargo bench --features bench
 ```
 
-Each case emits JSON with per-run timing (including model loading), median and
-p95 latency, and per-stage medians and p95s. Keep the machine, context range,
-and model cache unchanged when comparing configurations.
-
 ## Pi extension
 
 The bundled [pi-goosedump extension](packages/pi-goosedump/README.md) adds
-session-history search, entry expansion, durable-memory recall, CWD-scoped session management,
-memory forget/status maintenance, and turn-driven goosedump compaction to Pi:
+session search, durable memory, session management, and goosedump compaction to
+Pi:
 
 ```sh
 pi install npm:pi-goosedump
@@ -134,5 +143,6 @@ The published Linux x64 and arm64 binaries are static glibc PIEs.
 ### Third Party Attribution
 
 1. GPT-OSS-20B: Apache 2.0
-   - Downloaded on first use at run-time. The model is not distributed together
-     with goosedump.
+2. bge-small-en-v1.5: MIT
+
+The models are downloaded at run time and are not distributed with goosedump.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jarkkojs/goosedump",
-  "version": "0.12.10",
+  "version": "0.12.12",
   "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.12",
+    "@jarkkojs/goosedump-linux-arm64": "0.12.12",
+    "@jarkkojs/goosedump-linux-x64": "0.12.12",
+    "@jarkkojs/goosedump-win32-x64": "0.12.12"
   },
   "publishConfig": {
     "access": "public"