@shadowforge0/aquifer-memory 1.0.0 → 1.0.1

package/README.md

@@ -130,13 +130,14 @@ Full env-to-config mapping is in [consumers/shared/config.js](consumers/shared/c
 
 ## Host Integration
 
-MCP is the primary integration surface. Agent hosts connect to the Aquifer MCP server, which exposes four tools: `session_recall`, `session_feedback`, `memory_stats`, `memory_pending`.
+MCP is the primary integration surface. Agent hosts connect to the Aquifer MCP server, which exposes five tools: `session_recall`, `session_feedback`, `session_bootstrap`, `memory_stats`, `memory_pending`.
 
 | Integration | Route | Status | When to use |
 |-------------|-------|--------|-------------|
 | MCP server | `consumers/mcp.js` | Primary | Claude Code, OpenClaw, Codex, any MCP-capable host |
 | Library API | `createAquifer()` | Primary | Backend apps, custom pipelines, direct Node.js usage |
-| CLI | `consumers/cli.js` | Secondary | Operations, debugging, manual recall/backfill |
+| CLI | `consumers/cli.js` | Secondary | Operations, debugging, manual recall/backfill (`aquifer bootstrap`, `aquifer ingest-opencode`, etc.) |
+| OpenCode ingest | `consumers/opencode.js` | Secondary | Import sessions from OpenCode's SQLite DB |
 | OpenClaw plugin | `consumers/openclaw-plugin.js` | Compatibility only | Session capture via `before_reset` — not for tool delivery |
 
 ### Claude Code
@@ -160,7 +161,7 @@ Add to your project's `.claude.json` or user-level MCP config:
 }
 ```
 
-Tools appear as `mcp__aquifer__session_recall`, `mcp__aquifer__session_feedback`, etc.
+Tools appear as `mcp__aquifer__session_recall`, `mcp__aquifer__session_feedback`, `mcp__aquifer__session_bootstrap`, etc.
 
 ### OpenClaw
 
@@ -184,7 +185,7 @@ Add to `openclaw.json` under `mcp.servers`:
 }
 ```
 
-Tools materialize as `aquifer__session_recall`, `aquifer__session_feedback`, `aquifer__memory_stats`, `aquifer__memory_pending` (server name prefix added by the host).
+Tools materialize as `aquifer__session_recall`, `aquifer__session_feedback`, `aquifer__session_bootstrap`, `aquifer__memory_stats`, `aquifer__memory_pending` (server name prefix added by the host).
 
 The OpenClaw plugin (`consumers/openclaw-plugin.js`) is retained for session capture via `before_reset` but is **not** the recommended tool delivery path. Use MCP.
 
@@ -245,6 +246,7 @@ Any host that supports MCP stdio can connect the same way — point it at `node
 | `pipeline/extract-entities.js` | LLM-powered entity extraction (12 types) |
 | `pipeline/rerank.js` | Cross-encoder reranking (TEI, Jina, OpenRouter) |
 | `pipeline/normalize/` | Session normalization for Claude Code / gateway noise |
+| `consumers/opencode.js` | OpenCode SQLite ingest — reads sessions from OpenCode's local DB |
 | `schema/001-base.sql` | DDL: sessions, summaries, turn_embeddings, FTS indexes |
 | `schema/002-entities.sql` | DDL: entities, mentions, relations, entity_sessions |
 | `schema/003-trust-feedback.sql` | DDL: trust_score column, session_feedback audit trail |
@@ -435,6 +437,24 @@ await aquifer.feedback('session-id', {
 });
 ```
 
+#### `aquifer.bootstrap(opts)`
+
+Loads recent session context for a new conversation — summaries, open loops, and decisions. Time-based (no embedding search), designed for session-start injection.
+
+```javascript
+const result = await aquifer.bootstrap({
+  agentId: 'main',
+  limit: 5,              // max sessions (default: 5)
+  lookbackDays: 14,      // how far back (default: 14)
+  maxChars: 4000,        // max output chars (default: 4000)
+  format: 'text',        // 'text', 'structured', or 'both'
+});
+// format='text': result.text contains XML block ready for injection
+// format='structured': result.sessions, result.openLoops, result.recentDecisions
+```
+
+Cross-session dedup on open loops and decisions, sentinel filtering (removes 無/none/n/a), and maxChars truncation.
+
 #### `aquifer.close()`
 
 Closes the PostgreSQL connection pool (only if Aquifer created it).

package/core/aquifer.js

@@ -918,7 +918,6 @@ function createAquifer(config) {
     },
 
     async getSessionFull(sessionId) {
-      // Try to find the session across agents by querying directly
       const result = await pool.query(
         `SELECT * FROM ${qi(schema)}.sessions
         WHERE session_id = $1 AND tenant_id = $2
@@ -928,24 +927,15 @@ function createAquifer(config) {
       const session = result.rows[0];
       if (!session) return null;
 
-      const [segResult, sumResult] = await Promise.all([
-        pool.query(
-          `SELECT * FROM ${qi(schema)}.session_segments
-          WHERE session_row_id = $1
-          ORDER BY segment_no ASC`,
-          [session.id]
-        ),
-        pool.query(
-          `SELECT * FROM ${qi(schema)}.session_summaries
-          WHERE session_row_id = $1
-          LIMIT 1`,
-          [session.id]
-        ),
-      ]);
+      const sumResult = await pool.query(
+        `SELECT * FROM ${qi(schema)}.session_summaries
+        WHERE session_row_id = $1
+        LIMIT 1`,
+        [session.id]
+      );
 
       return {
         session,
-        segments: segResult.rows,
         summary: sumResult.rows[0] || null,
       };
     },

package/core/storage.js

@@ -96,44 +96,6 @@ async function upsertSession(pool, {
   };
 }
 
-// ---------------------------------------------------------------------------
-// upsertSegments
-// ---------------------------------------------------------------------------
-
-async function upsertSegments(pool, sessionRowId, segments, { schema } = {}) {
-  if (!segments || segments.length === 0) return;
-  for (const seg of segments) {
-    await pool.query(
-      `INSERT INTO ${qi(schema)}.session_segments
-        (session_row_id, segment_no, start_msg_idx, end_msg_idx,
-         started_at, ended_at, raw_msg_count, effective_msg_count,
-         boundary_type, boundary_meta)
-      VALUES ($1,$2,$3,$4,$5,$6,$7,$8,$9,$10)
-      ON CONFLICT (session_row_id, segment_no) DO UPDATE SET
-        start_msg_idx = EXCLUDED.start_msg_idx,
-        end_msg_idx = EXCLUDED.end_msg_idx,
-        started_at = EXCLUDED.started_at,
-        ended_at = EXCLUDED.ended_at,
-        raw_msg_count = EXCLUDED.raw_msg_count,
-        effective_msg_count = EXCLUDED.effective_msg_count,
-        boundary_type = EXCLUDED.boundary_type,
-        boundary_meta = EXCLUDED.boundary_meta`,
-      [
-        sessionRowId,
-        seg.segmentNo,
-        seg.startMsgIdx !== null && seg.startMsgIdx !== undefined ? seg.startMsgIdx : null,
-        seg.endMsgIdx !== null && seg.endMsgIdx !== undefined ? seg.endMsgIdx : null,
-        seg.startedAt || null,
-        seg.endedAt || null,
-        seg.rawMsgCount || 0,
-        seg.effectiveMsgCount || 0,
-        seg.boundaryType || null,
-        seg.boundaryMeta ? JSON.stringify(seg.boundaryMeta) : '{}',
-      ]
-    );
-  }
-}
-
 // ---------------------------------------------------------------------------
 // upsertSummary
 // ---------------------------------------------------------------------------
@@ -159,9 +121,8 @@ async function upsertSummary(pool, sessionRowId, {
     `INSERT INTO ${qi(schema)}.session_summaries
       (session_row_id, tenant_id, agent_id, session_id, summary_version, model, source_hash,
        message_count, user_message_count, assistant_message_count,
-       boundary_count, fresh_tail_count,
        started_at, ended_at, structured_summary, summary_text, embedding, updated_at)
-    VALUES ($1,$2,$3,$4,1,$5,$6,$7,$8,$9,0,0,$10,$11,COALESCE($12::jsonb,'{}'::jsonb),COALESCE($13,''),$14::vector,now())
+    VALUES ($1,$2,$3,$4,1,$5,$6,$7,$8,$9,$10,$11,COALESCE($12::jsonb,'{}'::jsonb),COALESCE($13,''),$14::vector,now())
     ON CONFLICT (session_row_id) DO UPDATE SET
       tenant_id = EXCLUDED.tenant_id,
       agent_id = EXCLUDED.agent_id,
@@ -211,50 +172,6 @@ async function markStatus(pool, sessionRowId, status, error, { schema } = {}) {
   return result.rows[0] || null;
 }
 
-// ---------------------------------------------------------------------------
-// persistProcessingResults (@internal — prefer aquifer.enrich() for full pipeline)
-// ---------------------------------------------------------------------------
-
-async function persistProcessingResults(pool, sessionRowId, {
-  schema,
-  segments,
-  summaryText,
-  structuredSummary,
-  agentId,
-  sessionId,
-  tenantId,
-  model,
-  sourceHash,
-  msgCount,
-  userCount,
-  assistantCount,
-  startedAt,
-  endedAt,
-  embedding,
-}) {
-  const client = await pool.connect();
-  try {
-    await client.query('BEGIN');
-    if (segments) await upsertSegments(client, sessionRowId, segments, { schema });
-    await upsertSummary(client, sessionRowId, {
-      schema, tenantId, agentId, sessionId, summaryText,
-      structuredSummary, model, sourceHash,
-      msgCount, userCount, assistantCount,
-      startedAt, endedAt, embedding,
-    });
-    await markStatus(client, sessionRowId, 'succeeded', null, { schema });
-    await client.query('COMMIT');
-  } catch (err) {
-    await client.query('ROLLBACK').catch(() => {});
-    try {
-      await markStatus(pool, sessionRowId, 'failed', err.message, { schema });
-    } catch (_) { /* swallow */ }
-    throw err;
-  } finally {
-    client.release();
-  }
-}
-
 // ---------------------------------------------------------------------------
 // getSession
 // ---------------------------------------------------------------------------
@@ -282,36 +199,6 @@ async function getSession(pool, sessionId, agentId, options = {}, { schema, tena
   return result.rows[0] || null;
 }
 
-// ---------------------------------------------------------------------------
-// getSessionFull
-// ---------------------------------------------------------------------------
-
-async function getSessionFull(pool, sessionId, agentId, { schema, tenantId } = {}) {
-  const session = await getSession(pool, sessionId, agentId, { tenantId }, { schema, tenantId });
-  if (!session) return null;
-
-  const [segResult, sumResult] = await Promise.all([
-    pool.query(
-      `SELECT * FROM ${qi(schema)}.session_segments
-      WHERE session_row_id = $1
-      ORDER BY segment_no ASC`,
-      [session.id]
-    ),
-    pool.query(
-      `SELECT * FROM ${qi(schema)}.session_summaries
-      WHERE session_row_id = $1
-      LIMIT 1`,
-      [session.id]
-    ),
-  ]);
-
-  return {
-    session,
-    segments: segResult.rows,
-    summary: sumResult.rows[0] || null,
-  };
-}
-
 // ---------------------------------------------------------------------------
 // getMessages
 // ---------------------------------------------------------------------------
@@ -414,7 +301,7 @@ async function recordAccess(pool, sessionRowIds, { schema } = {}) {
   if (!sessionRowIds || sessionRowIds.length === 0) return;
   await pool.query(
     `UPDATE ${qi(schema)}.session_summaries
-    SET access_count = access_count + 1, last_accessed_at = now()
+    SET access_count = COALESCE(access_count, 0) + 1, last_accessed_at = now()
     WHERE session_row_id = ANY($1)`,
     [sessionRowIds]
   );
@@ -643,12 +530,9 @@ async function recordFeedback(pool, {
 
 module.exports = {
   upsertSession,
-  upsertSegments,
   upsertSummary,
   markStatus,
-  persistProcessingResults,
   getSession,
-  getSessionFull,
   getMessages,
   searchSessions,
   recordAccess,

package/index.js

@@ -3,6 +3,5 @@
 const { createAquifer } = require('./core/aquifer');
 const { createEmbedder } = require('./pipeline/embed');
 const { createReranker } = require('./pipeline/rerank');
-const { normalizeSession, detectClient } = require('./pipeline/normalize');
 
-module.exports = { createAquifer, createEmbedder, createReranker, normalizeSession, detectClient };
+module.exports = { createAquifer, createEmbedder, createReranker };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shadowforge0/aquifer-memory",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "PG-native long-term memory for AI agents. Turn-level embedding, hybrid RRF ranking, optional knowledge graph. MCP server, CLI, and library API.",
   "main": "index.js",
   "files": [
@@ -17,8 +17,6 @@
   },
   "exports": {
     ".": "./index.js",
-    "./core/*": "./core/*.js",
-    "./pipeline/*": "./pipeline/*.js",
     "./consumers/mcp": "./consumers/mcp.js",
     "./consumers/openclaw-plugin": "./consumers/openclaw-plugin.js",
     "./consumers/opencode": "./consumers/opencode.js",