@postnesia/hooks 0.1.4 → 0.1.6

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/handler.d.ts

@@ -42,5 +42,5 @@ export type AgentBootstrapHookEvent = InternalHookEvent & {
     action: "bootstrap";
     context: AgentBootstrapHookContext;
 };
-declare function handler(event: AgentBootstrapHookEvent): void[];
+declare function handler(event: AgentBootstrapHookEvent): AgentBootstrapHookEvent;
 export default handler;

package/dist/handler.js

@@ -9,10 +9,11 @@ export const DEFAULT_BOOTSTRAP_FILENAME = "BOOTSTRAP.md";
 export const DEFAULT_MEMORY_FILENAME = "MEMORY.md";
 export const DEFAULT_MEMORY_ALT_FILENAME = "memory.md";
 function handler(event) {
-    return event.context.bootstrapFiles.map((file) => {
+    event.context.bootstrapFiles.map((file) => {
         if (file.name === 'BOOTSTRAP.md') {
             file.content = format(loadL1Memories());
         }
     });
+    return event;
 }
 export default handler;

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,8 +1,9 @@
 {
   "name": "@postnesia/hooks",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Session bootstrap hook — loads L1 memory context at startup",
   "type": "module",
+  "private": false,
   "files": [
     "dist"
   ],
@@ -20,7 +21,7 @@
     }
   },
   "dependencies": {
-    "@postnesia/db": "^0.1.3"
+    "@postnesia/db": "^0.1.5"
   },
   "devDependencies": {
     "@types/node": "^22.10.5",
@@ -28,6 +29,7 @@
     "typescript": "^5.7.3"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json"
+    "build": "pnpm clean && tsc -p tsconfig.json",
+    "clean": "rm -rf ./dist"
   }
 }