@jarkkojs/goosedump 0.11.3 → 0.12.1

package/README.md

@@ -25,68 +25,72 @@ Source builds require a C compiler for the bundled SQLite library.
 ## Quick start
 
 ```sh
-goosedump list
-goosedump show pi:context-id
-goosedump grep pi:context-id '*database*'
-goosedump search pi:context-id 'migration failure'
-goosedump compact pi:context-id
+goosedump session list --query '.provider == "pi"'
+goosedump session show pi:context-id
+goosedump session find pi:context-id '*database*'
+goosedump session search pi:context-id 'database failure'
+goosedump session compact pi:context-id
 ```
 
-Use `goosedump --help` or the
+Every command that operates on a saved session takes an explicit
+`provider:session-id` target. Use `goosedump --help` or the
 [manual page](https://github.com/jarkkojs/goosedump/blob/main/man/man1/goosedump.1)
-for all commands and options.
+for complete usage.
 
-## Features
+## Commands
 
-- Lists and filters contexts across all supported providers.
-- Renders provider-native output and converts conversations between provider
-  formats.
-- Searches session history with BM25 ranking and glob matching.
-- Imports contexts into another provider's store; pair with `delete` to move
-  them.
-- Recalls durable memory harvested from compacted context ranges.
+The command tree mirrors the things it manages:
+
+```text
+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] [--plain] [--remember] [--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
+
+model pull
+```
+
+`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.
 
 ## Persistent memory
 
-`compact` emits a summary without retaining the selected range by default. Pass
-`--train` to harvest it into the platform state directory
-(`~/.local/state/goosedump/goosedump.db` on Linux). Stored entries are classified
-as decisions, facts, preferences, procedures, or episodes and include trust,
-confidence, validity, scope, derivation, and concrete source provenance. Admission
-screening quarantines instruction-like, generated, and malformed content before
-retrieval. Indexing uses a durable pending/indexed/failed ledger, recovers interrupted
-work, and stops automatic retries after three attempts. Use `recall --type TYPE` to
-restrict a search, `stats` to inspect type, governance, and ingestion counts,
-`govern review` to inspect quarantined entries, and `ingest review` to inspect
-indexing failures.
-
-Memory keeps historical provenance. Deleting or moving a source context does
-not remove previously harvested content. `forget HASH` and `forget PROVIDER:ID`
-remove memory and create durable tombstones that prevent re-ingestion. Use
-`govern approve`, `quarantine`, `supersede`, `contradict`, and `expire` for explicit
-lifecycle control. Pass `compact --train` only when the selected range may be
-retained; screening is defensive and is not a substitute for secret filtering.
-Reset one terminal failure for another bounded retry cycle with
-`ingest retry HASH`.
-
-`mutate` performs an optional local merge of two archived memories. It normally
-waits for sufficient usage evidence; `mutate --force` is intended for testing.
-The fixed `GPT-OSS-20B MXFP4` text model is downloaded on first use, or ahead of
-time with `goosedump pull`.
+`session compact` emits a summary without retaining the selected range. Add
+`--remember` only when the selected content may become durable memory.
+
+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.
 
 ## Inference performance
 
-The custom GPT-OSS-20B CPU engine defaults to the physical CPU core count, capped by
-the CPUs available to the process. Override the compute thread count:
+The custom GPT-OSS-20B CPU engine uses physical CPU cores, capped by the CPUs
+available to the process, by default. Override the compute thread count:
 
 ```sh
 GOOSEDUMP_INFERENCE_THREADS=6 \
-goosedump compact pi:context-id
+goosedump session compact pi:context-id
 ```
 
-GPT-OSS-20B text generation uses the custom CPU engine. Measure a representative
-context before changing the defaults. The `bench` feature builds a standalone harness
-that shells out to `goosedump compact` with `GOOSEDUMP_PROFILE_COMPACT=1` and reports
+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:
 
 ```sh
@@ -94,14 +98,15 @@ end-to-end and per-stage timings:
 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.
+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 tools, durable-memory recall, and goosedump compaction to Pi:
+session-history search, entry expansion, durable-memory recall, CWD-scoped session management,
+memory forget/status maintenance, and turn-driven goosedump compaction to Pi:
 
 ```sh
 pi install npm:pi-goosedump
@@ -117,7 +122,13 @@ cargo fmt --check
 
 The published Linux x64 and arm64 binaries are static glibc PIEs.
 
-## License
+## Licensing
+
+1. `pi-goosedump`: Apache 2.0
+2. `goosedump`: LGPL 2.1+
+
+### Third Party Attribution
 
-The Rust program is licensed under `LGPL-2.1-or-later`. The npm distribution
-also contains Apache-2.0-licensed components.
+1. GPT-OSS-20B: Apache 2.0
+   - Downloaded on first use at run-time. The model is not distributed together
+     with goosedump.

package/package.json

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