pi-goosedump 0.12.11 → 0.12.12

package/README.md

@@ -15,33 +15,38 @@ x64, macOS arm64, and Windows x64. If no compatible binary is available, the
 extension keeps Pi's normal compaction behavior and its goosedump features
 report that they are unavailable.
 
+## Memory in a nutshell
+
+1. **Remember:** [`gpt-oss-20b`](https://github.com/jarkkojs/goosedump/blob/main/docs/models/gpt-oss-20b.md)
+   extracts typed, atomic statements with source provenance. [`bge-small-en-v1.5`](https://github.com/jarkkojs/goosedump/blob/main/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 extension queues remembering after its own successful compactions. Learning
+runs in the background and does not delay compaction.
+
 ## Tools
 
 - **`goose_search`** ranks session messages and returns compact overviews with
   entry IDs.
 - **`goose_get`** expands entry IDs returned by `goose_search` or `goose_grep`.
 - **`goose_grep`** filters session messages with a glob pattern.
-- **`goose_recall`** searches durable memory learned from remembered sessions.
-  It searches the current working directory by default, can filter facts,
-  decisions, preferences, procedures, or lessons, and returns typed excerpts
-  with source provenance within a 4,096-byte/token-safe output budget. Exact
-  lexical and entity-anchor hits remain first; cached BGE embeddings fill
-  remaining slots with paraphrased matches. Active memories are returned by
-  default; set `history` to include superseded statements. Entity-seeded and
-  expanded hits are annotated as `related by` (query or shared anchors).
-- **`goose_remember`** asks goosedump to learn durable memory from a session.
-  Defaults to the current Pi session; pass `provider`/`session` to target
-  another session. After extension-generated compaction, learning is queued in the
-  background so compaction does not wait for model extraction.
+- **`goose_remember`** learns durable memory from a session. It defaults to the
+  current Pi session.
+- **`goose_recall`** recalls typed memories with source provenance. It searches
+  active memories in the current project by default; `history` includes
+  superseded statements and `allProjects` searches every project.
 - **`goose_compact`** starts asynchronous compaction of the current Pi session.
-  Set `keep` to preserve the last N user turns verbatim.
-- **`goose_sessions`** lists or deletes saved sessions scoped to the current working directory. Deleting the active session is safety-blocked.
-- **`goose_forget`** deletes a derived memory (`mem_<id>`) or every retained source from a `provider:id` session.
-- **`goose_memory_status`** reports storage, evidence, tombstone, and type counts.
-  The session-history tools accept an optional `provider` (`pi` by default),
-  `session`, and `scope` (`lineage` by default or `all`). The current Pi session
-  is used when both provider and session are omitted. Non-Pi providers require an
-  explicit session ID. Targets sent to goosedump are always provider-qualified.
+  `keep` preserves the last N user turns verbatim.
+- **`goose_sessions`** lists or deletes sessions from the current working
+  directory. The active session cannot be deleted.
+- **`goose_forget`** deletes one memory or all retained sources from a session.
+- **`goose_memory_status`** reports storage, embedding coverage, tombstones, and
+  type counts.
+
+Session-history tools default to the current Pi session and active lineage.
+Non-Pi providers require an explicit session ID.
 
 Examples:
 
@@ -52,7 +57,6 @@ goose_get({ ids: ["entry-a", "entry-b"] })
 goose_grep({ pattern: "*timeout*" })
 goose_recall({ query: "prior architecture decision" })
 goose_recall({ query: "database", type: "decision" })
-
 goose_recall({ query: "database", history: true })
 goose_remember({})
 goose_compact({ keep: 2 })
@@ -105,22 +109,13 @@ global setting.
 
 ## Compaction behavior
 
-The extension replaces Pi's normal summary during manual, scheduled, and
-automatic compaction. It invokes `goosedump session compact`, preserves the
-previous compaction summary, summarizes only the newly compacted range, and
-passes the effective summary budget to goosedump. When necessary, goosedump
-removes older read-only paths, completed items, chronology lines, and
-modified/created paths in that order while preserving goals, blockers, decisions,
-preferences, and the newest actionable context. A `keep:N` request keeps the last
-N active user turns; it is cancelled when no earlier history is available to summarize.
-
-After a successful extension-generated compaction, the extension explicitly asks
-goosedump to remember the compacted session (`memory remember <target> --json`).
-If remembering fails, the summary is kept and a warning is surfaced, so memory
-learning errors never discard the compaction result.
-
-Compactions with custom instructions continue to use Pi's normal compactor. If
-goosedump fails, the extension reports the error and falls back to Pi.
+The extension uses `goosedump session compact` for manual, scheduled, and automatic
+compaction. It preserves the previous summary, summarizes only the new range, and
+passes the effective token budget. `keep:N` leaves the last N user turns verbatim.
+
+After success, memory learning is queued in the background. A learning failure
+keeps the summary and displays a warning. Custom instructions use Pi's normal
+compactor; other goosedump failures fall back to Pi.
 
 ## License
 

package/dist/index.ts

@@ -1443,7 +1443,7 @@ function createGoosedumpIntegration(options = {}) {
       pi.registerTool(defineTool({
         name: "goose_remember",
         label: "goose_remember",
-        description: "Learn durable, auditable memory from a session. Defaults to the current Pi session.",
+        description: "Use local gpt-oss-20b to extract typed memories and provenance from a session; store BGE embeddings in SQLite. Defaults to the current Pi session.",
         promptSnippet: "Persist important context from the current or another session into durable memory",
         promptGuidelines: [
           "Use goose_remember after a milestone when important facts, decisions, preferences, procedures, or lessons should be retained.",
@@ -1472,7 +1472,7 @@ function createGoosedumpIntegration(options = {}) {
       pi.registerTool(defineTool({
         name: "goose_recall",
         label: "goose_recall",
-        description: "Recall durable context learned from remembered sessions. Searches the current project by default and returns bounded atomic memories with provenance. Active memories are returned by default; set history to include superseded statements.",
+        description: "Recall project-scoped memory. Lexical and entity matches come first; BGE vector matches fill remaining slots. Returns bounded records with provenance; history includes superseded statements.",
         promptSnippet: "Recall durable context from earlier sessions",
         promptGuidelines: [
           "Use goose_recall for decisions, evidence, and context that may have disappeared from the current session.",
@@ -1552,7 +1552,7 @@ function createGoosedumpIntegration(options = {}) {
       pi.registerTool(defineTool({
         name: "goose_memory_status",
         label: "goose_memory_status",
-        description: "Show durable memory storage and type counts.",
+        description: "Show durable memory storage, embedding coverage, tombstones, and type counts.",
         promptSnippet: "Inspect durable memory health and statistics",
         promptGuidelines: [
           "Use goose_memory_status to inspect memory volume, type counts, and tombstones."

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-goosedump",
-  "version": "0.12.11",
-  "description": "Pi extension for goosedump-backed session-history search, entry expansion, and compaction",
+  "version": "0.12.12",
+  "description": "Pi extension for goosedump session search, durable memory, and compaction",
   "keywords": [
     "compaction",
     "goosedump",
@@ -38,7 +38,7 @@
   },
   "dependencies": {
     "@earendil-works/pi-tui": "^0.82.1",
-    "@jarkkojs/goosedump": "^0.12.11",
+    "@jarkkojs/goosedump": "^0.12.12",
     "@sinclair/typebox": "^0.34.49"
   },
   "devDependencies": {