@postnesia/hooks 0.1.5 → 0.1.7

package/README.md

@@ -0,0 +1,63 @@
+# @postnesia/hooks
+
+Session bootstrap hook for Postnesia. Loads core memories and high-importance L1 summaries from the database and injects them into the agent's context at session start.
+
+## How it works
+
+At session start the hook queries the database for:
+- All **core memories** (always loaded, never decay)
+- **Working memory** — non-core memories with importance >= 3
+
+Output is written to stdout in a structured block:
+
+```
+--- POSTNESIA MEMORY CONTEXT ---
+
+[CORE MEMORIES]
+#1 [technical] How Postnesia is used...
+
+[WORKING MEMORY — L1 summaries, importance >= 3]
+#4 [lesson] (imp:4) Learned that...
+
+--- END MEMORY CONTEXT ---
+```
+
+Claude Code injects stdout from `SessionStart` hooks into the conversation, so the agent sees this context before the first user message.
+
+If the database does not exist yet the hook exits silently (no error).
+
+## Usage
+
+### Claude Code (SessionStart hook)
+
+Add to `.claude/settings.json`:
+
+```json
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx postnesia-claude"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### Programmatic (handler export)
+
+The `./handler` export provides a handler that can be wired into other agent frameworks. It populates the `BOOTSTRAP.md` bootstrap file slot with the formatted memory context:
+
+```ts
+import handler from '@postnesia/hooks/handler';
+```
+
+## Environment Variables
+
+Inherits from `@postnesia/db` — requires `DATABASE_URL` to be set.

package/dist/claude.js

@@ -1,4 +1,10 @@
 import { format, loadL1Memories } from './index.js';
+const chunks = [];
+for await (const chunk of process.stdin) {
+    chunks.push(chunk);
+}
+const payload = JSON.parse(Buffer.concat(chunks).toString('utf-8'));
+console.log(payload, 'payload');
 const memories = loadL1Memories();
 const output = format(memories);
 if (output)

package/dist/compact.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * PreCompact Hook
+ * Reads the conversation transcript before context compaction,
+ * summarizes it via Claude, and persists a journal entry + memories
+ * directly into the Postnesia DB.
+ */
+export {};

package/dist/compact.js

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+/**
+ * PreCompact Hook
+ * Reads the conversation transcript before context compaction,
+ * summarizes it via Claude, and persists a journal entry + memories
+ * directly into the Postnesia DB.
+ */
+import fs from 'fs';
+import Anthropic from '@anthropic-ai/sdk';
+import { getDb, queries, createMemory } from '@postnesia/db';
+import { embed } from '@postnesia/db/embeddings';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function extractText(content) {
+    if (typeof content === 'string')
+        return content;
+    return content
+        .filter(b => b.type === 'text' && b.text)
+        .map(b => b.text)
+        .join('\n');
+}
+function buildTranscriptText(messages) {
+    return messages
+        .map(m => `[${m.role.toUpperCase()}]\n${extractText(m.content)}`)
+        .join('\n\n---\n\n');
+}
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+const chunks = [];
+for await (const chunk of process.stdin) {
+    chunks.push(chunk);
+}
+const raw = Buffer.concat(chunks).toString('utf-8').trim();
+if (!raw)
+    process.exit(0);
+let payload;
+try {
+    payload = JSON.parse(raw);
+}
+catch {
+    process.exit(0);
+}
+if (payload.hook_event_name !== 'PreCompact' || !payload.transcript_path) {
+    process.exit(0);
+}
+// Read the transcript
+let messages = [];
+try {
+    const transcriptRaw = fs.readFileSync(payload.transcript_path, 'utf-8');
+    messages = JSON.parse(transcriptRaw);
+}
+catch {
+    process.exit(0);
+}
+if (!Array.isArray(messages) || messages.length === 0)
+    process.exit(0);
+const transcriptText = buildTranscriptText(messages);
+const today = new Date().toISOString().slice(0, 10);
+// ---------------------------------------------------------------------------
+// Summarize with Claude
+// ---------------------------------------------------------------------------
+const client = new Anthropic();
+const systemPrompt = `You are a memory and journal assistant. Given a conversation transcript, extract:
+1. A journal entry summarizing what was worked on
+2. Key memories worth persisting long-term
+
+Return ONLY valid JSON matching this exact schema (no markdown, no extra text):
+{
+  "date": "YYYY-MM-DD",
+  "content": "Narrative description of what was done in this session",
+  "learned": "Key technical or contextual learnings from this session",
+  "keyMoments": "Significant decisions, breakthroughs, or pivots",
+  "memories": [
+    {
+      "content": "Full memory content",
+      "content_l1": "Short one-line summary (max 200 chars)",
+      "type": "event|decision|lesson|preference|person|technical",
+      "importance": 1-5,
+      "tags": ["tag1", "tag2"]
+    }
+  ]
+}
+
+Only include memories that are genuinely worth remembering long-term (importance >= 3).
+Keep memories focused and factual. Today's date is ${today}.`;
+let summary;
+try {
+    const response = await client.messages.create({
+        model: 'claude-haiku-4-5-20251001',
+        max_tokens: 2048,
+        system: systemPrompt,
+        messages: [
+            {
+                role: 'user',
+                content: `Summarize this conversation transcript:\n\n${transcriptText.slice(0, 40000)}`,
+            },
+        ],
+    });
+    const text = response.content.find(b => b.type === 'text')?.text ?? '';
+    summary = JSON.parse(text);
+}
+catch (err) {
+    // If summarization fails, exit cleanly — don't break the compact
+    process.stderr.write(`[postnesia compact] summarization failed: ${err}\n`);
+    process.exit(0);
+}
+// ---------------------------------------------------------------------------
+// Persist to Postnesia DB
+// ---------------------------------------------------------------------------
+try {
+    const db = getDb();
+    // Journal entry
+    queries.insertJournal(db).run(summary.date ?? today, summary.content ?? '', summary.learned ?? null, summary.keyMoments ?? null, null // mood
+    );
+    // Memories
+    for (const mem of (summary.memories ?? [])) {
+        if (!mem.content || !mem.type || !mem.importance)
+            continue;
+        const embedding = await embed(mem.content);
+        createMemory(db, {
+            timestamp: new Date().toISOString(),
+            content: mem.content,
+            content_l1: mem.content_l1 ?? mem.content.slice(0, 200),
+            type: mem.type,
+            core: 0,
+            importance: mem.importance,
+            tags: mem.tags ?? [],
+            embedding,
+        });
+    }
+    process.stderr.write(`[postnesia compact] saved journal entry for ${summary.date} with ${summary.memories?.length ?? 0} memories\n`);
+}
+catch (err) {
+    process.stderr.write(`[postnesia compact] db write failed: ${err}\n`);
+}
+process.exit(0);

package/dist/index.d.ts

@@ -10,6 +10,7 @@ interface L1Memory {
     core: number;
     importance: number;
     effective_importance: number;
+    content: string;
     content_l1: string;
     last_accessed: string;
 }

package/dist/index.js

@@ -25,7 +25,7 @@ export function format(memories) {
     if (core.length > 0) {
         lines.push('\n[CORE MEMORIES]');
         for (const m of core) {
-            lines.push(`#${m.id} [${m.type}] ${m.content_l1}`);
+            lines.push(m.content);
         }
     }
     if (regular.length > 0) {

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "@postnesia/hooks",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Session bootstrap hook — loads L1 memory context at startup",
   "type": "module",
+  "private": false,
   "files": [
     "dist"
   ],
   "bin": {
-    "postnesia-claude": "./dist/claude.js"
+    "postnesia-claude": "./dist/claude.js",
+    "postnesia-compact": "./dist/compact.js"
   },
   "exports": {
     ".": {
@@ -20,7 +22,8 @@
     }
   },
   "dependencies": {
-    "@postnesia/db": "^0.1.3"
+    "@anthropic-ai/sdk": "^0.54.0",
+    "@postnesia/db": "0.1.7"
   },
   "devDependencies": {
     "@types/node": "^22.10.5",
@@ -28,6 +31,7 @@
     "typescript": "^5.7.3"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json"
+    "build": "pnpm clean && tsc -p tsconfig.json",
+    "clean": "rm -rf ./dist"
   }
 }