abmind 0.1.4 → 0.1.5-alpha.2

package/CHANGELOG.md

@@ -2,6 +2,53 @@
 
 All notable changes to abmind. Follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [0.1.5] — 2026-06-01
+
+### Added
+- **abmind install** — full onboard: native deps, ollama check, encryption passphrase, memory DB init, user_profile.md seeding, install log
+- **Agent name** — install asks agent name, writes to SOUL.md template (`<agentName>` placeholder)
+- **`--agent-name`** flag for non-interactive installs
+- **`rebuildFtsIndexes()`** on MemoryBackend interface
+- **Block system/agent** from storing memories + 24h TTL cleanup (#701)
+
+### Changed
+- SOUL template: "I am <agentName>, an autonomous agent. abtars is my runtime — it gives me voice and hands."
+- `seedCoreFiles` reads from `templates/core/SOUL.md` (was `core/SOUL.md`)
+- Sleep budget raised to 18 + reset llmCalls on resume (#684)
+
+### Fixed
+- `abmind bundle --help` exits with usage instead of running bundle
+- Scope sleep message query to primary user_id (#696)
+- Lazy-load better-sqlite3 — no top-level require (#713)
+
+## [0.1.4] — 2026-05-31
+
+### Added
+- **Backup** — `abmind backup --database` flag + auto key-file fallback (#707)
+- **FTS self-heal** — `rebuildFtsIndexes()` exposed on MemoryBackend interface (#706)
+- **Session context** — `skipDailies` + `maxAgeMs` options (#658)
+- **SESSION_HISTORY_CAP** — cap history budget at 25000 chars (#656)
+- **buildStatusBlock** — compact system status for session-start (#646)
+- **Curation counter** — skip candidates after 3 failures with same model (#639)
+- **Wiki** — 13 pages (recall, classification, configuration, backup, troubleshooting + rewrites)
+
+### Changed
+- Sleep pipeline: merge core-promotion into retro-derive (two-stage knowledge funnel, #630)
+- Consolidation writes to `weekly/` not `daily/` (#640)
+- Exclude non-numbered files from sleep step loader (#637)
+- [RECENT] shows newest messages, not oldest (#654)
+- README rewrite: selling points, badges, agglutinating language examples
+
+### Fixed
+- `[NO-REPLY]` renamed to `[NO_REPLY]` (underscore) matching bridge filter
+
+## [0.1.3] — 2026-05-20
+
+### Added
+- Dreaming pipeline — multi-step sleep with per-step retry
+- CI/CD — GitHub Actions build + test
+- Community templates — SOUL.md, user_profile.md, agent_notes.md
+
 ## [0.1.2] — 2026-05-07
 
 ### Added

package/README.md

@@ -1,10 +1,12 @@
 # abmind
 
+[![npm](https://img.shields.io/npm/v/abmind)](https://www.npmjs.com/package/abmind) [![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE) [![Node](https://img.shields.io/badge/node-22%2B-green)]()
+
 Persistent memory system for AI agents — store, recall, consolidate, and forget.
 
-SQLite-backed, 4-layer recall (FTS5 + trigram + embeddings + consolidated summaries), overnight sleep maintenance, injection detection, context orchestration, and a classification system inspired by NATO Admiralty Codes.
+**Built for multilingual agents that run 24/7 — not a vector DB wrapper.** SQLite-backed, 4-layer recall (FTS5 + trigram + embeddings + consolidated summaries), overnight sleep maintenance, injection detection, context orchestration, and a classification system inspired by NATO Admiralty Codes.
 
-**Version:** 0.1.2 | **Docs:** [aksika.github.io/abmind](https://aksika.github.io/abmind/) | **License:** Apache 2.0
+**Version:** 0.1.4 | **Docs:** [Wiki](https://github.com/aksika/abmind/tree/dev/docs/wiki) | **License:** Apache 2.0
 
 ## Install
 
@@ -13,38 +15,7 @@ npm install abmind
 abmind install
 ```
 
-Requires Node 22+. Full guide: [Installation](https://aksika.github.io/abmind/)
-
-## Library Usage
-
-```ts
-import { MemoryManager, loadMemoryConfig, recallSearch, buildWakeUp } from "abmind";
-
-// Initialize
-const config = loadMemoryConfig(); // reads ABMIND_HOME, defaults to ~/.abmind
-const memory = new MemoryManager(config);
-
-// Store a message
-memory.recordMessage({
-  role: "user",
-  content: "I prefer dark mode and hate notifications",
-  timestamp: Date.now(),
-  userId: "alice",
-  sessionId: "alice:telegram",
-});
-
-// Recall relevant memories
-const results = await recallSearch(memory.getRecallDeps(), {
-  translated: ["dark mode", "preferences"],
-  userId: "alice",
-  limit: 5,
-});
-console.log(results.memories); // ranked by relevance across all 4 layers
-
-// Build wake-up context for a new session
-const wakeUp = buildWakeUp(memory, "alice");
-// → structured context: recent topics, key facts, emotional state, pending items
-```
+Requires Node 22+. Full guide: [Installation](https://github.com/aksika/abmind/blob/dev/docs/wiki/install.md)
 
 ## Architecture
 
@@ -77,38 +48,75 @@ const wakeUp = buildWakeUp(memory, "alice");
 
 ## Features
 
-### Memory Storage
-- **Typed memories** — fact, preference, decision, experience, skill, relationship, goal
-- **Bilingual** — stores original language + English translation side by side
-- **Emotion tagging** — -5 to +5 per memory, emotion arcs tracked over time
+### Agglutinating Language Support
+
+Most memory systems tokenize on word boundaries — catastrophic for Japanese, Turkish, Hungarian, and other languages where a single word carries dense meaning. Japanese has no spaces ("食べさせられなかった" = "was not able to be made to eat"), Turkish compounds freely ("yapabildiklerimizdenmişsinizcesine" = "as if you were among those we could do"), Hungarian packs sentences into one word ("megcsináltattam" = "I had it done by someone"). abmind uses **trigram fuzzy search** alongside FTS5, so recall works regardless of morphology, word boundaries, or compounding. Store in any language, recall in any language.
+
+### Credential Vault
+
+When your agent receives a secret (API key, token, password):
+1. Encrypts it at rest (AES-256-GCM) as a SECRET memory (class 3)
+2. Immediately redacts the raw credential from conversation history
+3. Only the owner can retrieve it (classification-gated recall)
+4. Backups and exports never contain raw credentials
+
+Your agent remembers secrets without leaking them.
+
+### Multi-Resolution Context
+
+Context assembly at three zoom levels — 3× more coverage in the same token budget:
+- **Recent** — full verbatim conversation (last N turns)
+- **Session** — compressed per-turn atoms (ABM-L format, 3× token reduction)
+- **Long-term** — thematic summaries + recalled memories from weeks/months ago
+
+The agent remembers last week's decisions AND this morning's details.
+
+### Sleep Maintenance (Dreamy)
+
+Nightly background process that curates memory like human sleep:
+- Extracts facts, decisions, preferences from the day's conversations
+- Consolidates daily → weekly → quarterly summaries
+- Detects contradictions ("you said X last week but Y today")
+- Prunes stale memories (Memory Darwinism — unused memories fade)
+- Promotes frequently-recalled memories, demotes stale ones
+- 10-14 LLM calls per cycle, fully autonomous
+
+### Recall (4 layers, ranked)
 
-### Recall (4 layers)
 - **FTS5** — full-text search on English and original content
-- **Trigram** — fuzzy matching for typos, partial words, transliteration
+- **Trigram** — fuzzy matching for typos, partial words, agglutinating morphology
 - **Embeddings** — semantic similarity via Ollama or any OpenAI-compatible endpoint
 - **Consolidated summaries** — weekly/quarterly rollups searchable as memories
 
-### Classification (CIA-AAA / Admiralty Codes)
-- **Classification** — 0 (public) → 1 (internal) → 2 (confidential) → 3 (secret)
-- **Trust / Integrity / Credibility** — per-memory quality scores
-- **Access control** — recall filters by user clearance level automatically
+Results ranked by relevance across all layers. No single layer is a bottleneck.
 
-### ABM-L (Agent Bridge Memory Language)
-- Slot-based compression format for context-window efficiency
-- 3× token reduction vs raw prose, preserving semantic atoms
-- Render-only — stored data stays as clean prose, ABM-L is ephemeral
+### Classification (NATO Admiralty Codes)
 
-### Darwinism (Sleep Maintenance)
-- **Promote** — frequently recalled memories gain confidence
-- **Demote** — stale, contradicted, or low-quality memories decay
-- **Merge** — duplicate/overlapping memories consolidated
-- **Forget** — memories below threshold eventually pruned
+- **Classification** — 0 (public) → 1 (internal) → 2 (confidential) → 3 (secret/encrypted)
+- **Trust / Integrity / Credibility** — per-memory quality scores
+- **Access control** — recall filters by user clearance level automatically
+- **Multi-user isolation** — each user's memories scoped, no cross-user leakage
 
 ### Injection Detection
+
 - 14 detection categories (prompt injection, jailbreak, role hijack, etc.)
 - Blocks malicious input before it enters the memory store
 - Configurable sensitivity per category
 
+### Works Everywhere
+
+Not locked to one CLI or framework:
+
+| Path | Use for |
+|---|---|
+| **abTARS** | In-process memory for the autonomous bridge |
+| **Hermes Agent** | Plugin-compatible memory backend |
+| **OpenClaw** | Native memory slot replacement |
+| **Library** (`import { MemoryManager } from "abmind"`) | Any Node.js agent |
+| **MCP server** (`abmind mcp`) | Editors + hosts with MCP support |
+| **CLI** (`abmind store/recall/...`) | Shell scripts, automation |
+| **Agent hooks** | Kiro CLI, Claude Code, Gemini CLI, Codex |
+
 ## CLI
 
 ```bash
@@ -153,15 +161,36 @@ Add to your host's MCP config:
 
 Works with kiro-cli, Claude Code, Codex CLI, Gemini CLI, Cursor, OpenCode, and any MCP-compatible host.
 
-## Integration Paths
+## Library Usage
+
+```ts
+import { MemoryManager, loadMemoryConfig, recallSearch, buildWakeUp } from "abmind";
 
-| Path | Use for |
-|---|---|
-| **Library** (`import { MemoryManager } from "abmind"`) | Node apps embedding memory directly |
-| **MCP server** (`abmind mcp`) | Editors + hosts with MCP support |
-| **CLI** (`abmind store/recall/...`) | Shell scripts, automation |
-| **OpenClaw plugin** | Native OpenClaw memory slot replacement |
-| **abtars** | In-process memory for the bridge runtime |
+// Initialize
+const config = loadMemoryConfig(); // reads ABMIND_HOME, defaults to ~/.abmind
+const memory = new MemoryManager(config);
+
+// Store a message
+memory.recordMessage({
+  role: "user",
+  content: "I prefer dark mode and hate notifications",
+  timestamp: Date.now(),
+  userId: "alice",
+  sessionId: "alice:telegram",
+});
+
+// Recall relevant memories
+const results = await recallSearch(memory.getRecallDeps(), {
+  translated: ["dark mode", "preferences"],
+  userId: "alice",
+  limit: 5,
+});
+console.log(results.memories); // ranked by relevance across all 4 layers
+
+// Build wake-up context for a new session
+const wakeUp = buildWakeUp(memory, "alice");
+// → structured context: recent topics, key facts, emotional state, pending items
+```
 
 ## Data Location
 

package/config/.env.memory.example

@@ -0,0 +1,114 @@
+# abmind memory configuration
+# Copied to ~/.abmind/config/.env.memory by `abmind install`.
+#
+# Lines starting with `#VAR=value` show the DEFAULT — uncomment to override.
+# Lines with `VAR=` (no leading #) are REQUIRED — fill in.
+
+# === OPTIONAL — commented lines show defaults ===
+
+# Enable memory subsystem (default: true)
+#MEMORY_ENABLED=true
+
+# Memory data directory (default: ~/.abmind/memory)
+#MEMORY_DIR=~/.abmind/memory
+
+# Search strategy: hybrid | embedding | signature (default: hybrid)
+#MEMORY_SEARCH_MODE=hybrid
+
+# Max messages retained per chat (default: 1000)
+#MEMORY_MAX_MESSAGES_PER_CHAT=1000
+
+# Disk budget for memory data in MB (default: 500)
+#MEMORY_DISK_BUDGET_MB=500
+
+# Max SQLite DB size in MB (default: 200)
+#MEMORY_MAX_DB_SIZE_MB=200
+
+# TTL for original-language messages in days (default: 90)
+#MEMORY_ORIGINAL_TTL_DAYS=90
+
+# TTL for English-translated messages in days (default: 365)
+#MEMORY_ENGLISH_TTL_DAYS=365
+
+# Enable memory aging (decay of old messages) (default: true)
+#MEMORY_AGING_ENABLED=true
+
+# Signature bits for fingerprinting (default: 256)
+#SIGNATURE_BITS=256
+
+# === EMBEDDING (optional — ollama or OpenAI-compatible) ===
+
+# Enable semantic embedding search (default: true)
+#EMBEDDING_ENABLED=true
+
+# Embedding provider. "ollama" (default) or "openai" (covers OpenAI, Voyage,
+# Together, any OpenAI-compatible endpoint via URL swap).
+#EMBEDDING_PROVIDER=ollama
+
+# Embedding model name (default: nomic-embed-text for ollama; text-embedding-3-small for openai)
+#EMBEDDING_MODEL=nomic-embed-text
+
+# Provider endpoint. Ollama: http://localhost:11434. OpenAI: https://api.openai.com/v1
+#EMBEDDING_URL=http://localhost:11434
+
+# API key — required for openai provider, ignored for ollama. Masked in all logs/status.
+#EMBEDDING_API_KEY=
+
+# Vector dimensions. Ollama nomic-embed-text=768, OpenAI text-embedding-3-small=1536.
+# Switching providers with a different value requires `abmind embed --reset` — the
+# memory system refuses to start on dimension mismatch (#173).
+#EMBEDDING_DIMENSIONS=768
+
+# Minimum similarity score to count as a match (default: 0.5)
+#EMBEDDING_SIMILARITY_THRESHOLD=0.5
+
+# === ABM-L RENDERING (memory-renderer.ts, #236) ===
+
+# ABM-L codec version for memory + context rendering (default: plain)
+# plain: full English with prefix, universal compatibility
+# v0: legacy positional format
+# v1: slot-based structured format (for experienced users)
+#ABML_VERSION=plain
+
+# Minimum chars before ABM-L compression kicks in for v0 (default: 100)
+#ABML_MIN_CHARS=100
+
+# === THREE-TIER CONTEXT ASSEMBLY (#348) ===
+
+# Enable three-tier context assembly (default: true)
+# When false, falls back to legacy binary (raw messages + summary head).
+# The heuristic classifier still runs at write time regardless.
+#CONTEXT_TIER_ENABLED=true
+
+# Tail boundary — last N turns kept verbatim (default: 20)
+#CONTEXT_TIER_TAIL=20
+
+# Middle boundary — next M turns rendered via ABM-L from hints (default: 50)
+#CONTEXT_TIER_MIDDLE=50
+
+# Enable LLM refinement for middle-tier rendering (default: false)
+# When true, the main chat model refines heuristic output asynchronously.
+# Heuristic always remains the fallback. Costs ~$0.02-0.05/chat/day at cheap model.
+#COMPACTION_LLM_ENABLED=false
+
+# === SESSION-START CONTEXT (#615) ===
+
+# Percentage of maxContext budget for session-start history (default: 3)
+#SESSION_HISTORY_PCT=3
+
+# Minimum messages always included regardless of budget (default: 8)
+#SESSION_HISTORY_MIN_MSGS=8
+
+# Max chars for session-start context (default: 25000)
+#SESSION_HISTORY_CAP=25000
+
+# === SLEEP / DREAMY ===
+
+# Sleep quality tier: basic | budget | normal | ultimate (default: normal)
+#SLEEP_QUALITY=normal
+
+# Day of week for weekly curation steps (default: sunday)
+#SLEEP_CURATION_DAY=sunday
+
+# Max LLM calls per sleep cycle, hard safety cap (default: 15, max: 50)
+#SLEEP_MAX_LLM_CALLS=15

package/dist/cli/abmind-bundle.js

@@ -3,6 +3,10 @@
  * abmind bundle — Print session bundle (SOUL + profile + notes + memory-tools) to stdout.
  * For kiro-cli, claude_code, or any host that needs the bundle via execute_bash.
  */
+if (process.argv.includes("--help") || process.argv.includes("-h")) {
+    console.log("Usage: abmind bundle\n\nPrint session bundle (SOUL + profile + notes + memory-tools) to stdout.");
+    process.exit(0);
+}
 import { loadMemoryConfig } from "../src/memory-config.js";
 import { MemoryManager } from "../src/memory-manager.js";
 const config = loadMemoryConfig();

package/dist/cli/abmind-bundle.js.map

@@ -1 +1 @@
-{"version":3,"file":"abmind-bundle.js","sourceRoot":"","sources":["../../cli/abmind-bundle.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;AAClC,MAAM,EAAE,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;AACrC,MAAM,MAAM,GAAG,EAAE,CAAC,gBAAgB,EAAE,CAAC;AACrC,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC9F,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IACvB,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,MAAM,CAAC,SAAS,GAAG,QAAQ,CAAC,CAAC;IACrF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC"}
+{"version":3,"file":"abmind-bundle.js","sourceRoot":"","sources":["../../cli/abmind-bundle.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IACnE,OAAO,CAAC,GAAG,CAAC,iGAAiG,CAAC,CAAC;IAC/G,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;AAClC,MAAM,EAAE,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;AACrC,MAAM,MAAM,GAAG,EAAE,CAAC,gBAAgB,EAAE,CAAC;AACrC,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC9F,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IACvB,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,MAAM,CAAC,SAAS,GAAG,QAAQ,CAAC,CAAC;IACrF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC"}

package/dist/cli/abmind-hook-notification.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * abmind hook Notification — log as session breadcrumb for retrospective.
+ */
+export {};
+//# sourceMappingURL=abmind-hook-notification.d.ts.map

package/dist/cli/abmind-hook-notification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abmind-hook-notification.d.ts","sourceRoot":"","sources":["../../cli/abmind-hook-notification.ts"],"names":[],"mappings":";AACA;;GAEG"}

package/dist/cli/abmind-hook-notification.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+/**
+ * abmind hook Notification — log as session breadcrumb for retrospective.
+ */
+import { runCliRaw } from "../src/cli-runner-raw.js";
+import { loadMemoryConfig } from "../src/memory-config.js";
+import { MemoryManager } from "../src/memory-manager.js";
+import { SleepDataAccess } from "../src/sleep-data-access.js";
+import { hooksDisabled, logHookError, readStdinJson, ensureHooksDir } from "../src/hook-helpers.js";
+await runCliRaw(import.meta.url, {
+    name: "abmind-hook-notification",
+    help: "Notification hook — log as session breadcrumb.",
+    flags: [],
+    handler: async () => {
+        ensureHooksDir();
+        if (hooksDisabled()) {
+            process.exit(0);
+        }
+        try {
+            const payload = await readStdinJson();
+            const message = payload?.message?.trim();
+            if (!message) {
+                process.exit(0);
+            }
+            const memory = new MemoryManager(loadMemoryConfig());
+            await memory.initialize({ skipEmbeddingCheck: true });
+            try {
+                const db = memory.getDatabase();
+                if (!db) {
+                    process.exit(0);
+                }
+                const sleepData = new SleepDataAccess(db);
+                let userId;
+                try {
+                    userId = sleepData.getPrimaryUserId();
+                }
+                catch {
+                    process.exit(0);
+                }
+                memory.recordMessage({
+                    userId, sessionId: "_S_breadcrumb", role: "assistant",
+                    content: `[NOTIFICATION] ${message.slice(0, 200)}`,
+                    timestamp: Date.now(),
+                });
+            }
+            finally {
+                memory.close();
+            }
+        }
+        catch (err) {
+            logHookError("notification", err);
+        }
+        process.exit(0);
+    },
+});
+//# sourceMappingURL=abmind-hook-notification.js.map

package/dist/cli/abmind-hook-notification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abmind-hook-notification.js","sourceRoot":"","sources":["../../cli/abmind-hook-notification.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAOpG,MAAM,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;IAC/B,IAAI,EAAE,0BAA0B;IAChC,IAAI,EAAE,gDAAgD;IACtD,KAAK,EAAE,EAAE;IACT,OAAO,EAAE,KAAK,IAAI,EAAE;QAClB,cAAc,EAAE,CAAC;QACjB,IAAI,aAAa,EAAE,EAAE,CAAC;YAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAAC,CAAC;QAEzC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,aAAa,EAAuB,CAAC;YAC3D,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACzC,IAAI,CAAC,OAAO,EAAE,CAAC;gBAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAAC,CAAC;YAElC,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,gBAAgB,EAAE,CAAC,CAAC;YACrD,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC;YACtD,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;gBAChC,IAAI,CAAC,EAAE,EAAE,CAAC;oBAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAAC,CAAC;gBAC7B,MAAM,SAAS,GAAG,IAAI,eAAe,CAAC,EAAE,CAAC,CAAC;gBAC1C,IAAI,MAAc,CAAC;gBACnB,IAAI,CAAC;oBAAC,MAAM,GAAG,SAAS,CAAC,gBAAgB,EAAE,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC;oBAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAAC,CAAC;gBAEzE,MAAM,CAAC,aAAa,CAAC;oBACnB,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,IAAI,EAAE,WAAW;oBACrD,OAAO,EAAE,kBAAkB,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;oBAClD,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;iBACtB,CAAC,CAAC;YACL,CAAC;oBAAS,CAAC;gBAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YAAC,YAAY,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;QAAC,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;CACF,CAAC,CAAC"}

package/dist/cli/abmind-hook-postcompact.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * abmind hook PostCompact — inject fresh recall after context compaction.
+ * Re-grounds the agent with relevant memories after context was trimmed.
+ * NOTE: Claude Code does not officially support this event yet.
+ * When it does, this hook activates automatically.
+ */
+export {};
+//# sourceMappingURL=abmind-hook-postcompact.d.ts.map

package/dist/cli/abmind-hook-postcompact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abmind-hook-postcompact.d.ts","sourceRoot":"","sources":["../../cli/abmind-hook-postcompact.ts"],"names":[],"mappings":";AACA;;;;;GAKG"}

package/dist/cli/abmind-hook-postcompact.js

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+/**
+ * abmind hook PostCompact — inject fresh recall after context compaction.
+ * Re-grounds the agent with relevant memories after context was trimmed.
+ * NOTE: Claude Code does not officially support this event yet.
+ * When it does, this hook activates automatically.
+ */
+import { runCliRaw } from "../src/cli-runner-raw.js";
+import { loadMemoryConfig } from "../src/memory-config.js";
+import { MemoryManager } from "../src/memory-manager.js";
+import { SleepDataAccess } from "../src/sleep-data-access.js";
+import { hooksDisabled, logHookError, readStdinJson, ensureHooksDir } from "../src/hook-helpers.js";
+import { extractEnglishTokens } from "../src/query-tokenizer.js";
+await runCliRaw(import.meta.url, {
+    name: "abmind-hook-postcompact",
+    help: "PostCompact hook — inject fresh recall after context compaction.",
+    flags: [],
+    handler: async () => {
+        ensureHooksDir();
+        if (hooksDisabled()) {
+            process.exit(0);
+        }
+        try {
+            const payload = await readStdinJson();
+            const summary = payload?.summary?.trim();
+            if (!summary) {
+                process.exit(0);
+            }
+            const memory = new MemoryManager(loadMemoryConfig());
+            await memory.initialize({ skipEmbeddingCheck: true });
+            try {
+                const db = memory.getDatabase();
+                if (!db) {
+                    process.exit(0);
+                }
+                const sleepData = new SleepDataAccess(db);
+                let userId;
+                try {
+                    userId = sleepData.getPrimaryUserId();
+                }
+                catch {
+                    process.exit(0);
+                }
+                const tokens = extractEnglishTokens(summary);
+                if (tokens.length === 0) {
+                    process.exit(0);
+                }
+                const results = await memory.search(tokens.join(" "), { userId, limit: 5 });
+                if (results.length > 0) {
+                    const output = results.map((r) => `- ${r.content_en}`).join("\n");
+                    process.stdout.write(output.slice(0, 2000));
+                }
+            }
+            finally {
+                memory.close();
+            }
+        }
+        catch (err) {
+            logHookError("postcompact", err);
+        }
+        process.exit(0);
+    },
+});
+//# sourceMappingURL=abmind-hook-postcompact.js.map

package/dist/cli/abmind-hook-postcompact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abmind-hook-postcompact.js","sourceRoot":"","sources":["../../cli/abmind-hook-postcompact.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACpG,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAOjE,MAAM,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;IAC/B,IAAI,EAAE,yBAAyB;IAC/B,IAAI,EAAE,kEAAkE;IACxE,KAAK,EAAE,EAAE;IACT,OAAO,EAAE,KAAK,IAAI,EAAE;QAClB,cAAc,EAAE,CAAC;QACjB,IAAI,aAAa,EAAE,EAAE,CAAC;YAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAAC,CAAC;QAEzC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,aAAa,EAAsB,CAAC;YAC1D,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACzC,IAAI,CAAC,OAAO,EAAE,CAAC;gBAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAAC,CAAC;YAElC,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,gBAAgB,EAAE,CAAC,CAAC;YACrD,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC;YACtD,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;gBAChC,IAAI,CAAC,EAAE,EAAE,CAAC;oBAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAAC,CAAC;gBAC7B,MAAM,SAAS,GAAG,IAAI,eAAe,CAAC,EAAE,CAAC,CAAC;gBAC1C,IAAI,MAAc,CAAC;gBACnB,IAAI,CAAC;oBAAC,MAAM,GAAG,SAAS,CAAC,gBAAgB,EAAE,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC;oBAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAAC,CAAC;gBAEzE,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;gBAC7C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAAC,CAAC;gBAE7C,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC5E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;gBAC9C,CAAC;YACH,CAAC;oBAAS,CAAC;gBAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YAAC,YAAY,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;QAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;CACF,CAAC,CAAC"}

package/dist/cli/abmind-hook-postuserprompt.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * abmind hook PostUserPrompt — real-time extraction after high-signal exchanges.
+ * Hybrid: heuristic gate + only extracts when triggered.
+ */
+export {};
+//# sourceMappingURL=abmind-hook-postuserprompt.d.ts.map

package/dist/cli/abmind-hook-postuserprompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abmind-hook-postuserprompt.d.ts","sourceRoot":"","sources":["../../cli/abmind-hook-postuserprompt.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/cli/abmind-hook-postuserprompt.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+/**
+ * abmind hook PostUserPrompt — real-time extraction after high-signal exchanges.
+ * Hybrid: heuristic gate + only extracts when triggered.
+ */
+import { runCliRaw } from "../src/cli-runner-raw.js";
+import { loadMemoryConfig } from "../src/memory-config.js";
+import { MemoryManager } from "../src/memory-manager.js";
+import { SleepDataAccess } from "../src/sleep-data-access.js";
+import { hooksDisabled, logHookError, readStdinJson, ensureHooksDir } from "../src/hook-helpers.js";
+const SIGNAL_PATTERNS = [
+    /\b(remember|don't forget|note that|my .+ is|I prefer|I decided|I always|I never)\b/i,
+    /\b(password|secret|key|token|credential)\b/i,
+    /\b(important|critical|rule|always do|never do)\b/i,
+];
+await runCliRaw(import.meta.url, {
+    name: "abmind-hook-postuserprompt",
+    help: "PostUserPrompt hook — real-time extraction on high-signal exchanges.",
+    flags: [],
+    handler: async () => {
+        ensureHooksDir();
+        if (hooksDisabled()) {
+            process.exit(0);
+        }
+        try {
+            const payload = await readStdinJson();
+            const userMsg = payload?.user_message ?? "";
+            const assistantMsg = payload?.assistant_message ?? "";
+            const combined = userMsg + " " + assistantMsg;
+            // Heuristic gate — only extract if high-signal
+            const triggered = SIGNAL_PATTERNS.some(p => p.test(combined));
+            if (!triggered) {
+                process.exit(0);
+            }
+            const memory = new MemoryManager(loadMemoryConfig());
+            await memory.initialize({ skipEmbeddingCheck: true });
+            try {
+                const db = memory.getDatabase();
+                if (!db) {
+                    process.exit(0);
+                }
+                const sleepData = new SleepDataAccess(db);
+                let userId;
+                try {
+                    userId = sleepData.getPrimaryUserId();
+                }
+                catch {
+                    process.exit(0);
+                }
+                // Record both messages for Dreamy extraction
+                const now = Date.now();
+                if (userMsg.length > 10) {
+                    memory.recordMessage({ userId, sessionId: "_A_realtime", role: "user", content: userMsg, timestamp: now - 1000 });
+                }
+                if (assistantMsg.length > 10) {
+                    memory.recordMessage({ userId, sessionId: "_A_realtime", role: "assistant", content: assistantMsg, timestamp: now });
+                }
+            }
+            finally {
+                memory.close();
+            }
+        }
+        catch (err) {
+            logHookError("postuserprompt", err);
+        }
+        process.exit(0);
+    },
+});
+//# sourceMappingURL=abmind-hook-postuserprompt.js.map

package/dist/cli/abmind-hook-postuserprompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abmind-hook-postuserprompt.js","sourceRoot":"","sources":["../../cli/abmind-hook-postuserprompt.ts"],"names":[],"mappings":"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"}

package/dist/cli/abmind-hook-precompact.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * abmind hook PreCompact — extract memories before context compaction.
+ * Reads transcript from stdin, runs extraction so memories aren't lost.
+ */
+export {};
+//# sourceMappingURL=abmind-hook-precompact.d.ts.map

package/dist/cli/abmind-hook-precompact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abmind-hook-precompact.d.ts","sourceRoot":"","sources":["../../cli/abmind-hook-precompact.ts"],"names":[],"mappings":";AACA;;;GAGG"}