@postnesia/bootstrap 0.1.2

package/dist/claude.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/claude.js

@@ -0,0 +1,5 @@
+import { format, loadL1Memories } from './index.js';
+const memories = loadL1Memories();
+const output = format(memories);
+if (output)
+    process.stdout.write(output + '\n');

package/dist/handler.d.ts

@@ -0,0 +1,46 @@
+export declare const DEFAULT_AGENTS_FILENAME = "AGENTS.md";
+export declare const DEFAULT_SOUL_FILENAME = "SOUL.md";
+export declare const DEFAULT_TOOLS_FILENAME = "TOOLS.md";
+export declare const DEFAULT_IDENTITY_FILENAME = "IDENTITY.md";
+export declare const DEFAULT_USER_FILENAME = "USER.md";
+export declare const DEFAULT_HEARTBEAT_FILENAME = "HEARTBEAT.md";
+export declare const DEFAULT_BOOTSTRAP_FILENAME = "BOOTSTRAP.md";
+export declare const DEFAULT_MEMORY_FILENAME = "MEMORY.md";
+export declare const DEFAULT_MEMORY_ALT_FILENAME = "memory.md";
+export type WorkspaceBootstrapFileName = typeof DEFAULT_AGENTS_FILENAME | typeof DEFAULT_SOUL_FILENAME | typeof DEFAULT_TOOLS_FILENAME | typeof DEFAULT_IDENTITY_FILENAME | typeof DEFAULT_USER_FILENAME | typeof DEFAULT_HEARTBEAT_FILENAME | typeof DEFAULT_BOOTSTRAP_FILENAME | typeof DEFAULT_MEMORY_FILENAME | typeof DEFAULT_MEMORY_ALT_FILENAME;
+export type WorkspaceBootstrapFile = {
+    name: WorkspaceBootstrapFileName;
+    path: string;
+    content?: string;
+    missing: boolean;
+};
+export type InternalHookEventType = "command" | "session" | "agent" | "gateway";
+export type AgentBootstrapHookContext = {
+    workspaceDir: string;
+    bootstrapFiles: WorkspaceBootstrapFile[];
+    cfg?: unknown;
+    sessionKey?: string;
+    sessionId?: string;
+    agentId?: string;
+};
+export interface InternalHookEvent {
+    /** The type of event (command, session, agent, gateway, etc.) */
+    type: InternalHookEventType;
+    /** The specific action within the type (e.g., 'new', 'reset', 'stop') */
+    action: string;
+    /** The session key this event relates to */
+    sessionKey: string;
+    /** Additional context specific to the event */
+    context: Record<string, unknown>;
+    /** Timestamp when the event occurred */
+    timestamp: Date;
+    /** Messages to send back to the user (hooks can push to this array) */
+    messages: string[];
+}
+export type AgentBootstrapHookEvent = InternalHookEvent & {
+    type: "agent";
+    action: "bootstrap";
+    context: AgentBootstrapHookContext;
+};
+declare function handler(event: AgentBootstrapHookEvent): void[];
+export default handler;

package/dist/handler.js

@@ -0,0 +1,18 @@
+import { format, loadL1Memories } from './index.js';
+export const DEFAULT_AGENTS_FILENAME = "AGENTS.md";
+export const DEFAULT_SOUL_FILENAME = "SOUL.md";
+export const DEFAULT_TOOLS_FILENAME = "TOOLS.md";
+export const DEFAULT_IDENTITY_FILENAME = "IDENTITY.md";
+export const DEFAULT_USER_FILENAME = "USER.md";
+export const DEFAULT_HEARTBEAT_FILENAME = "HEARTBEAT.md";
+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) => {
+        if (file.name === 'BOOTSTRAP.md') {
+            file.content = format(loadL1Memories());
+        }
+    });
+}
+export default handler;

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * Session Bootstrap Hook
+ * Loads core and top L1 memories from the Postnesia DB into model context at session start.
+ * Output (stdout) is injected into the conversation by the Claude Code SessionStart hook.
+ */
+interface L1Memory {
+    id: number;
+    type: string;
+    core: number;
+    importance: number;
+    effective_importance: number;
+    content_l1: string;
+    last_accessed: string;
+}
+export declare function loadL1Memories(): L1Memory[];
+export declare function format(memories: L1Memory[]): string;
+export {};

package/dist/index.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+/**
+ * Session Bootstrap Hook
+ * Loads core and top L1 memories from the Postnesia DB into model context at session start.
+ * Output (stdout) is injected into the conversation by the Claude Code SessionStart hook.
+ */
+import { getDb, queries } from '@postnesia/db';
+export function loadL1Memories() {
+    try {
+        const db = getDb(true);
+        return queries.getL1Summaries(db).all();
+    }
+    catch (err) {
+        if (err.code === 'SQLITE_EOPEN')
+            process.exit(0);
+        throw err;
+    }
+}
+export function format(memories) {
+    if (memories.length === 0)
+        return '';
+    const core = memories.filter(m => m.core === 1);
+    const regular = memories.filter(m => m.core === 0);
+    const lines = ['--- POSTNESIA MEMORY CONTEXT ---'];
+    if (core.length > 0) {
+        lines.push('\n[CORE MEMORIES]');
+        for (const m of core) {
+            lines.push(`#${m.id} [${m.type}] ${m.content_l1}`);
+        }
+    }
+    if (regular.length > 0) {
+        lines.push('\n[WORKING MEMORY — L1 summaries, importance ≥ 3]');
+        for (const m of regular) {
+            lines.push(`#${m.id} [${m.type}] (imp:${m.importance}) ${m.content_l1}`);
+        }
+    }
+    lines.push('\n--- END MEMORY CONTEXT ---');
+    return lines.join('\n');
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@postnesia/bootstrap",
+  "version": "0.1.2",
+  "description": "Session bootstrap hook — loads L1 memory context at startup",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "postnesia-claude": "./dist/claude.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.ts"
+    },
+    "./handler": {
+      "types": "./dist/handler.d.ts",
+      "import": "./dist/handler.ts"
+    }
+  },
+  "dependencies": {
+    "@postnesia/db": "0.1.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  }
+}