zora-agent 0.9.4 → 0.9.6

package/dist/memory/memory-manager.js

@@ -6,13 +6,22 @@
  *   - Tier 2: Rolling context (Daily Notes)
  *   - Tier 3: Structured items, salience, categories
  *   - Aggregates fragments into TaskContext.memoryContext
+ *
+ * Integrity (MEM-18):
+ *   - SHA-256 baselines on MEMORY.md to detect tampering
+ *   - Baselines stored in .memory-integrity.json alongside the memory dir
+ *   - Mismatch logs a warning (non-fatal — user may legitimately edit)
  */
+import crypto from 'node:crypto';
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import os from 'node:os';
 import { StructuredMemory } from './structured-memory.js';
 import { SalienceScorer } from './salience-scorer.js';
 import { CategoryOrganizer } from './category-organizer.js';
+import { createLogger } from '../utils/logger.js';
+const log = createLogger('memory-manager');
+const INTEGRITY_FILENAME = '.memory-integrity.json';
 export class MemoryManager {
     _config;
     _baseDir;
@@ -35,24 +44,104 @@ export class MemoryManager {
         const longTermFile = this._getLongTermPath();
         const longTermDir = path.dirname(longTermFile);
         await fs.mkdir(longTermDir, { recursive: true, mode: 0o700 });
+        let fileCreated = false;
         try {
             const defaultContent = '# Zora Long-term Memory\n\n- No persistent memories yet.\n';
             // Use 'wx' to atomically fail if the file already exists (preventing race conditions)
             await fs.writeFile(longTermFile, defaultContent, { mode: 0o600, flag: 'wx' });
+            fileCreated = true;
         }
         catch (err) {
             if (err.code !== 'EEXIST') {
                 throw err;
             }
         }
+        // Generate integrity baseline for newly created MEMORY.md
+        if (fileCreated) {
+            await this._saveIntegrityHash();
+        }
         // Tier 3: Structured memory + categories
         await this._structuredMemory.init();
         await this._categoryOrganizer.init();
     }
+    /** Cached memory index — invalidated on writes. */
+    _indexCache = null;
+    /**
+     * Returns a lightweight index of memory contents — no item reads.
+     * Tells the LLM what's available without dumping everything into context.
+     * Cached after first build; invalidated by write operations.
+     */
+    async getMemoryIndex() {
+        if (this._indexCache)
+            return this._indexCache;
+        // Count items via directory listing (no file reads)
+        let itemCount = 0;
+        try {
+            const files = await fs.readdir(this._getItemsPath());
+            itemCount = files.filter(f => f.endsWith('.json')).length;
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT')
+                throw err;
+        }
+        // List category names from category files
+        const categories = await this._categoryOrganizer.listCategories();
+        const categoryNames = categories.map(c => c.category);
+        // Find most recent daily note
+        let mostRecentDailyNote = null;
+        let dailyNoteCount = 0;
+        try {
+            const files = await fs.readdir(this._getDailyNotesPath());
+            const dateFiles = files
+                .filter(f => /^\d{4}-\d{2}-\d{2}\.md$/.test(f))
+                .sort()
+                .reverse();
+            dailyNoteCount = dateFiles.length;
+            if (dateFiles.length > 0) {
+                mostRecentDailyNote = dateFiles[0].replace('.md', '');
+            }
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT')
+                throw err;
+        }
+        this._indexCache = { itemCount, categoryNames, mostRecentDailyNote, dailyNoteCount };
+        return this._indexCache;
+    }
     /**
-     * Loads context for a new task based on tiers.
+     * Loads a lightweight context string for the system prompt.
+     * Instead of dumping all memory, provides a summary index that tells the LLM
+     * to use tools for on-demand retrieval.
      */
-    async loadContext(days = this._config.context_days) {
+    async loadContext(_days) {
+        const index = await this.getMemoryIndex();
+        const parts = [];
+        // Compact summary instead of full dump
+        const catList = index.categoryNames.length > 0
+            ? index.categoryNames.join(', ')
+            : 'none yet';
+        let summary = `[MEMORY] You have access to persistent memory:\n`;
+        summary += `- ${index.itemCount} items across ${index.categoryNames.length} categories (${catList})\n`;
+        if (index.mostRecentDailyNote) {
+            summary += `- Daily notes available (most recent: ${index.mostRecentDailyNote}, total: ${index.dailyNoteCount})\n`;
+        }
+        summary += `- Use memory_search to find relevant context\n`;
+        summary += `- Use recall_context to read recent daily notes\n`;
+        summary += `- Use memory_save to store new facts\n`;
+        summary += `Only retrieve what you need for this task.`;
+        parts.push(summary);
+        // Still include long-term memory (MEMORY.md) — it's typically small and curated
+        const longTerm = await this._readLongTerm();
+        if (longTerm) {
+            parts.push(`[LONG-TERM MEMORY]:\n${longTerm}`);
+        }
+        return parts;
+    }
+    /**
+     * Full context load (backward compat). Reads ALL items, daily notes, categories.
+     * Use only when progressive loading is not suitable (e.g., export, migration).
+     */
+    async loadFullContext(days = this._config.context_days) {
         const context = [];
         // Tier 1: Long-term salience
         const tier1 = await this._readLongTerm();
@@ -86,6 +175,114 @@ export class MemoryManager {
         }
         return context;
     }
+    /**
+     * Targeted memory recall — searches items by query using BM25 + salience.
+     * This is what the LLM calls via the memory_search tool, but exposed as
+     * a method for direct use by the Orchestrator.
+     */
+    async recallMemory(query, limit = 5) {
+        const scores = await this.searchMemory(query, limit);
+        const items = [];
+        for (const s of scores) {
+            // Use peekItem for read-only access — avoids inflating access stats during search
+            const item = await this._structuredMemory.peekItem(s.itemId);
+            if (item)
+                items.push(item);
+        }
+        return { items, scores };
+    }
+    /**
+     * Reads only the requested number of recent daily notes.
+     * Exposed for the recall_context tool.
+     */
+    async recallDailyNotes(days = 3) {
+        return this._readDailyNotes(days);
+    }
+    /**
+     * Archives daily notes older than threshold to memory/daily/archive/.
+     * Appends a summary header to MEMORY.md noting the archived date range.
+     * Archived notes remain on disk in the archive/ subdirectory for manual
+     * review but are excluded from the active daily notes directory.
+     *
+     * If a reflectFn is provided, it will be called with the combined content
+     * of notes being archived. This enables extracting structured memory items
+     * from daily notes before they are moved to the archive.
+     *
+     * @param thresholdDays Notes older than this are archived (default: 7)
+     * @param reflectFn Optional function to extract memory from notes before archiving
+     * @returns Number of notes archived
+     */
+    async consolidateDailyNotes(thresholdDays = 7, reflectFn) {
+        const dir = this._getDailyNotesPath();
+        let files;
+        try {
+            files = await fs.readdir(dir);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return 0;
+            throw err;
+        }
+        const cutoff = new Date();
+        cutoff.setDate(cutoff.getDate() - thresholdDays);
+        const cutoffStr = cutoff.toISOString().split('T')[0];
+        const oldFiles = files
+            .filter(f => /^\d{4}-\d{2}-\d{2}\.md$/.test(f))
+            .filter(f => f.replace('.md', '') < cutoffStr)
+            .sort();
+        if (oldFiles.length === 0)
+            return 0;
+        // Run reflector on note content before archiving (extract structured memory)
+        if (reflectFn) {
+            try {
+                const noteContents = [];
+                for (const file of oldFiles) {
+                    try {
+                        const content = await fs.readFile(path.join(dir, file), 'utf8');
+                        noteContents.push(`--- ${file} ---\n${content}`);
+                    }
+                    catch {
+                        // Skip unreadable files
+                    }
+                }
+                if (noteContents.length > 0) {
+                    await reflectFn(noteContents.join('\n\n'));
+                }
+            }
+            catch (err) {
+                log.warn({ err }, 'Reflector pass on daily notes failed, continuing with archive');
+            }
+        }
+        // Archive old files (moved, not deleted — still accessible for manual review)
+        const archiveDir = path.join(dir, 'archive');
+        await fs.mkdir(archiveDir, { recursive: true, mode: 0o700 });
+        for (const file of oldFiles) {
+            try {
+                await fs.rename(path.join(dir, file), path.join(archiveDir, file));
+            }
+            catch {
+                // Best-effort archive
+            }
+        }
+        // Append a consolidation summary to MEMORY.md
+        const consolidationSummary = `\n## Archived ${oldFiles.length} daily notes (${oldFiles[0].replace('.md', '')} to ${oldFiles[oldFiles.length - 1].replace('.md', '')})\n`;
+        const ltPath = this._getLongTermPath();
+        try {
+            await fs.appendFile(ltPath, consolidationSummary, { mode: 0o600 });
+            await this._saveIntegrityHash();
+        }
+        catch {
+            // Best-effort
+        }
+        // Invalidate index cache
+        this._indexCache = null;
+        log.info({ archived: oldFiles.length, thresholdDays }, 'Daily notes archived');
+        return oldFiles.length;
+    }
+    /** Invalidate the cached memory index (call after writes). */
+    invalidateIndex() {
+        this._indexCache = null;
+    }
     /**
      * Appends an entry to today's daily note.
      */
@@ -105,18 +302,41 @@ export class MemoryManager {
                 throw err;
             }
         }
+        this._indexCache = null; // Invalidate index on daily note write
     }
     /**
      * Searches structured memory items by query, ranked by salience.
+     * Uses MiniSearch BM25+ scores composed with salience factors.
      */
     async searchMemory(query, limit) {
-        const items = await this._structuredMemory.searchItems(query);
-        return this._scorer.rankItems(items, query, limit);
+        const results = await this._structuredMemory.searchItemsWithScores(query);
+        const scored = results.map(({ item, bm25Score }) => this._scorer.scoreItem(item, query, bm25Score));
+        scored.sort((a, b) => b.score - a.score);
+        return limit !== undefined ? scored.slice(0, limit) : scored;
     }
     /**
-     * Deletes a structured memory item by ID.
+     * Soft-deletes a structured memory item by ID.
+     * Moves the item to an archive directory before removing.
      */
-    async forgetItem(id) {
+    async forgetItem(id, reason) {
+        // Use getItem for direct lookup instead of listItems + find
+        const item = await this._structuredMemory.getItem(id);
+        if (item) {
+            const archiveDir = path.join(this._baseDir, 'memory', 'archive');
+            try {
+                await fs.mkdir(archiveDir, { recursive: true, mode: 0o700 });
+                const archiveData = {
+                    ...item,
+                    archived_at: new Date().toISOString(),
+                    archive_reason: reason ?? 'No reason provided',
+                };
+                await fs.writeFile(path.join(archiveDir, `${id}.json`), JSON.stringify(archiveData, null, 2), { mode: 0o600 });
+            }
+            catch {
+                // Archive is best-effort
+            }
+        }
+        this._indexCache = null; // Invalidate index on delete
         return this._structuredMemory.deleteItem(id);
     }
     /**
@@ -131,6 +351,12 @@ export class MemoryManager {
     get structuredMemory() {
         return this._structuredMemory;
     }
+    /**
+     * Returns the resolved path to the long-term memory file (MEMORY.md).
+     */
+    getLongTermPath() {
+        return this._getLongTermPath();
+    }
     _resolvePath(p) {
         if (p.startsWith('~/')) {
             return path.join(os.homedir(), p.slice(2));
@@ -163,7 +389,10 @@ export class MemoryManager {
     }
     async _readLongTerm() {
         try {
-            return await fs.readFile(this._getLongTermPath(), 'utf8');
+            const content = await fs.readFile(this._getLongTermPath(), 'utf8');
+            // Verify integrity hash (non-fatal on mismatch)
+            await this._verifyIntegrityHash(content);
+            return content;
         }
         catch (err) {
             if (err.code === 'ENOENT') {
@@ -194,5 +423,68 @@ export class MemoryManager {
         }
         return notes;
     }
+    // ─── Integrity Hashing (MEM-18) ──────────────────────────────────
+    /** Path to the integrity baseline file alongside the memory directory. */
+    _getIntegrityPath() {
+        return path.join(path.dirname(this._getLongTermPath()), INTEGRITY_FILENAME);
+    }
+    /** Compute SHA-256 hash of the given content. */
+    _computeHash(content) {
+        return crypto.createHash('sha256').update(content).digest('hex');
+    }
+    /**
+     * Saves a SHA-256 baseline for the current MEMORY.md content.
+     * Called after any write to MEMORY.md.
+     */
+    async _saveIntegrityHash() {
+        try {
+            const content = await fs.readFile(this._getLongTermPath(), 'utf8');
+            const data = {
+                hash: this._computeHash(content),
+                updatedAt: new Date().toISOString(),
+            };
+            await fs.writeFile(this._getIntegrityPath(), JSON.stringify(data, null, 2), { mode: 0o600 });
+        }
+        catch (err) {
+            log.warn({ err }, 'Failed to save memory integrity hash');
+        }
+    }
+    /**
+     * Verifies the current MEMORY.md content against the stored hash baseline.
+     * Logs a warning on mismatch but does not throw (the file may have been
+     * legitimately edited by the user).
+     */
+    async _verifyIntegrityHash(content) {
+        try {
+            const raw = await fs.readFile(this._getIntegrityPath(), 'utf8');
+            const data = JSON.parse(raw);
+            const currentHash = this._computeHash(content);
+            if (data.hash !== currentHash) {
+                log.warn({
+                    expected: data.hash,
+                    actual: currentHash,
+                    baselineDate: data.updatedAt,
+                }, 'MEMORY.md integrity mismatch: file may have been modified externally');
+                return false;
+            }
+            return true;
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                // No baseline yet — first run or baseline was deleted
+                log.info('No memory integrity baseline found; skipping verification');
+                return true;
+            }
+            log.warn({ err }, 'Failed to verify memory integrity hash');
+            return true; // Don't block on verification errors
+        }
+    }
+    /**
+     * Refreshes the integrity baseline for MEMORY.md.
+     * Call this after legitimate external edits to acknowledge the new content.
+     */
+    async refreshIntegrityBaseline() {
+        await this._saveIntegrityHash();
+    }
 }
 //# sourceMappingURL=memory-manager.js.map

package/dist/memory/memory-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory-manager.js","sourceRoot":"","sources":["../../src/memory/memory-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"memory-manager.js","sourceRoot":"","sources":["../../src/memory/memory-manager.ts"],"names":[],"mappings":"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"}

package/dist/memory/observation-store.d.ts

@@ -0,0 +1,75 @@
+/**
+ * ObservationStore — Persistence for compressed observation blocks.
+ *
+ * Stores session-tier and cross-session observations as append-only JSONL files.
+ * Same pattern as SessionManager — one file per session, crash-resilient reads.
+ *
+ * Storage layout:
+ *   ~/.zora/memory/observations/{sessionId}.jsonl   (per-session observations)
+ *   ~/.zora/memory/observations/cross-session.jsonl  (cross-session rollups)
+ */
+export interface ObservationBlock {
+    /** Unique ID: obs_{timestamp}_{random} */
+    id: string;
+    /** Session this observation belongs to */
+    sessionId: string;
+    /** When the observation was created */
+    createdAt: string;
+    /** Which tier this observation belongs to */
+    tier: 'session' | 'cross-session';
+    /** The compressed observation text */
+    observations: string;
+    /** Which message indices were compressed [start, end) */
+    sourceMessageRange: [number, number];
+    /** Estimated token count of the observation text */
+    estimatedTokens: number;
+}
+export declare class ObservationStore {
+    private readonly _baseDir;
+    constructor(baseDir: string);
+    init(): Promise<void>;
+    /**
+     * Append an observation block to the appropriate file.
+     * Append-only — never overwrites existing observations.
+     */
+    append(block: ObservationBlock): Promise<void>;
+    /**
+     * Load all observation blocks for a session, ordered by creation time.
+     * Skips malformed lines (crash-resilient).
+     */
+    loadSession(sessionId: string): Promise<ObservationBlock[]>;
+    /**
+     * Load cross-session observations.
+     * @param limit Max number of most recent blocks to return.
+     */
+    loadCrossSession(limit?: number): Promise<ObservationBlock[]>;
+    /**
+     * Build the combined observation text for a session.
+     * Returns all session-tier observations concatenated in order.
+     */
+    buildSessionContext(sessionId: string): Promise<string>;
+    /**
+     * Build cross-session context string.
+     */
+    buildCrossSessionContext(limit?: number): Promise<string>;
+    /**
+     * Get total estimated tokens for a session's observations.
+     */
+    getSessionTokenCount(sessionId: string): Promise<number>;
+    /**
+     * Prune old session observation files.
+     * Keeps only the most recent N session files.
+     */
+    pruneOldSessions(keepLast?: number): Promise<number>;
+    /**
+     * Generate a unique observation block ID.
+     */
+    static generateId(): string;
+    private _readJsonlFile;
+    /**
+     * Sanitize a session ID for use as a filename.
+     * Prevents path traversal by removing slashes and dots.
+     */
+    private _sanitizeId;
+}
+//# sourceMappingURL=observation-store.d.ts.map

package/dist/memory/observation-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-store.d.ts","sourceRoot":"","sources":["../../src/memory/observation-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,IAAI,EAAE,SAAS,GAAG,eAAe,CAAC;IAClC,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,oDAAoD;IACpD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,OAAO,EAAE,MAAM;IAIrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IASpD;;;OAGG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAKjE;;;OAGG;IACG,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IASnE;;;OAGG;IACG,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM7D;;OAEG;IACG,wBAAwB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM/D;;OAEG;IACG,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK9D;;;OAGG;IACG,gBAAgB,CAAC,QAAQ,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAwC9D;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,MAAM;YAQb,cAAc;IAuB5B;;;OAGG;IACH,OAAO,CAAC,WAAW;CAGpB"}

package/dist/memory/observation-store.js

@@ -0,0 +1,162 @@
+/**
+ * ObservationStore — Persistence for compressed observation blocks.
+ *
+ * Stores session-tier and cross-session observations as append-only JSONL files.
+ * Same pattern as SessionManager — one file per session, crash-resilient reads.
+ *
+ * Storage layout:
+ *   ~/.zora/memory/observations/{sessionId}.jsonl   (per-session observations)
+ *   ~/.zora/memory/observations/cross-session.jsonl  (cross-session rollups)
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { createLogger } from '../utils/logger.js';
+const log = createLogger('observation-store');
+const CROSS_SESSION_FILE = 'cross-session.jsonl';
+export class ObservationStore {
+    _baseDir;
+    constructor(baseDir) {
+        this._baseDir = baseDir;
+    }
+    async init() {
+        await fs.mkdir(this._baseDir, { recursive: true, mode: 0o700 });
+    }
+    /**
+     * Append an observation block to the appropriate file.
+     * Append-only — never overwrites existing observations.
+     */
+    async append(block) {
+        const filePath = block.tier === 'cross-session'
+            ? path.join(this._baseDir, CROSS_SESSION_FILE)
+            : path.join(this._baseDir, `${this._sanitizeId(block.sessionId)}.jsonl`);
+        const line = JSON.stringify(block) + '\n';
+        await fs.appendFile(filePath, line, { mode: 0o600 });
+    }
+    /**
+     * Load all observation blocks for a session, ordered by creation time.
+     * Skips malformed lines (crash-resilient).
+     */
+    async loadSession(sessionId) {
+        const filePath = path.join(this._baseDir, `${this._sanitizeId(sessionId)}.jsonl`);
+        return this._readJsonlFile(filePath);
+    }
+    /**
+     * Load cross-session observations.
+     * @param limit Max number of most recent blocks to return.
+     */
+    async loadCrossSession(limit) {
+        const filePath = path.join(this._baseDir, CROSS_SESSION_FILE);
+        const blocks = await this._readJsonlFile(filePath);
+        if (limit !== undefined && blocks.length > limit) {
+            return blocks.slice(-limit);
+        }
+        return blocks;
+    }
+    /**
+     * Build the combined observation text for a session.
+     * Returns all session-tier observations concatenated in order.
+     */
+    async buildSessionContext(sessionId) {
+        const blocks = await this.loadSession(sessionId);
+        if (blocks.length === 0)
+            return '';
+        return blocks.map(b => b.observations).join('\n\n');
+    }
+    /**
+     * Build cross-session context string.
+     */
+    async buildCrossSessionContext(limit) {
+        const blocks = await this.loadCrossSession(limit);
+        if (blocks.length === 0)
+            return '';
+        return blocks.map(b => b.observations).join('\n\n');
+    }
+    /**
+     * Get total estimated tokens for a session's observations.
+     */
+    async getSessionTokenCount(sessionId) {
+        const blocks = await this.loadSession(sessionId);
+        return blocks.reduce((sum, b) => sum + b.estimatedTokens, 0);
+    }
+    /**
+     * Prune old session observation files.
+     * Keeps only the most recent N session files.
+     */
+    async pruneOldSessions(keepLast = 50) {
+        let files;
+        try {
+            files = await fs.readdir(this._baseDir);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return 0;
+            throw err;
+        }
+        const sessionFiles = files
+            .filter(f => f.endsWith('.jsonl') && f !== CROSS_SESSION_FILE);
+        // Sort by file modification time (newest last) to avoid lexicographic ordering issues
+        const fileStats = await Promise.all(sessionFiles.map(async (f) => ({
+            name: f,
+            mtime: (await fs.stat(path.join(this._baseDir, f))).mtime
+        })));
+        const sortedFiles = fileStats
+            .sort((a, b) => a.mtime.getTime() - b.mtime.getTime())
+            .map(f => f.name);
+        if (sortedFiles.length <= keepLast)
+            return 0;
+        const toRemove = sortedFiles.slice(0, sortedFiles.length - keepLast);
+        let removed = 0;
+        for (const file of toRemove) {
+            try {
+                await fs.unlink(path.join(this._baseDir, file));
+                removed++;
+            }
+            catch {
+                // Best-effort cleanup
+            }
+        }
+        log.info({ removed, kept: keepLast }, 'Pruned old session observation files');
+        return removed;
+    }
+    /**
+     * Generate a unique observation block ID.
+     */
+    static generateId() {
+        const ts = Date.now();
+        const rand = Math.random().toString(36).substring(2, 8).padEnd(6, '0');
+        return `obs_${ts}_${rand}`;
+    }
+    // ── Private helpers ──────────────────────────────────────────────
+    async _readJsonlFile(filePath) {
+        let raw;
+        try {
+            raw = await fs.readFile(filePath, 'utf8');
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return [];
+            throw err;
+        }
+        const blocks = [];
+        for (const line of raw.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                blocks.push(JSON.parse(trimmed));
+            }
+            catch {
+                log.warn({ line: trimmed.substring(0, 100) }, 'Skipping malformed observation line');
+            }
+        }
+        return blocks;
+    }
+    /**
+     * Sanitize a session ID for use as a filename.
+     * Prevents path traversal by removing slashes and dots.
+     */
+    _sanitizeId(id) {
+        return id.replace(/[^a-zA-Z0-9_-]/g, '_');
+    }
+}
+//# sourceMappingURL=observation-store.js.map