soulbridge 0.0.106 → 0.0.107

package/dist/packages/core/src/index.d.ts

@@ -327,6 +327,17 @@ export declare class Soul {
         id: string;
         reason: 'archived' | 'quiet-turns' | 'quiet-time';
     }>;
+    /**
+     * Housekeeping that should run once per turn: close open questions nobody answered.
+     *
+     * A gap is only worth asking about while it is fresh; 14 days of silence means the moment
+     * passed. Closing is not deleting — the row keeps its topic, opened_at and the reason.
+     */
+    sweep(now?: number, options?: {
+        gapMaxAgeDays?: number;
+    }): {
+        gapsClosed: number;
+    };
     /** The thread the previous turn belonged to, for the attribution candidate list. */
     threadBefore(sessionId: string, turnNo: number): string | null;
     /**

package/dist/packages/core/src/index.js

@@ -535,22 +535,10 @@ export class Soul {
                 slots,
             });
             facts.push(written);
-            // Known to have happened, unknown when: keep the memory and turn the missing
-            // date into something to ask about later, instead of inventing one.
-            if (holder === 'world' && written.atPrecision === 'unknown') {
-                const subject = slots.find((slot) => slot.value.kind === 'entity');
-                gaps.push(this.store.putGap({
-                    soulId: this.soulId,
-                    userId: this.userId,
-                    aboutEntityId: subject?.value.kind === 'entity' ? subject.value.entityId : undefined,
-                    aboutFactId: written.id,
-                    // Whole statement: the gap asks "when did this happen", so the sentence it
-                    // refers to cannot be a prefix of itself.
-                    topic: `日期不明：${statement}`,
-                    tension: 0.3,
-                    openedAt: at,
-                }));
-            }
+            // A missing date is a property of the fact (`atPrecision: unknown`), not an open
+            // question. Turning every undated fact into a gap produced 223 open gaps in two days,
+            // of which 78% were '日期不明：…' — they can never be closed, and they bury the gaps
+            // that are worth asking about. The fact stays; the question is not created.
             return written;
         };
         // Operations carry the merge decision (Mem0's ADD/UPDATE/DELETE); plain facts are
@@ -818,6 +806,17 @@ export class Soul {
     closeIdleThreads(sessionId, options = {}) {
         return this.store.closeIdleThreads(this.soulId, this.userId, sessionId, options.idleTurns ?? 6, options.idleMs ?? 24 * 60 * 60_000, options.archivedSessionIds ?? [], options.at ?? Date.now());
     }
+    /**
+     * Housekeeping that should run once per turn: close open questions nobody answered.
+     *
+     * A gap is only worth asking about while it is fresh; 14 days of silence means the moment
+     * passed. Closing is not deleting — the row keeps its topic, opened_at and the reason.
+     */
+    sweep(now = Date.now(), options = {}) {
+        const maxAgeDays = options.gapMaxAgeDays ?? 14;
+        const gapsClosed = this.store.closeStaleGaps(this.soulId, this.userId, now - maxAgeDays * 86_400_000, 'expired');
+        return { gapsClosed };
+    }
     /** The thread the previous turn belonged to, for the attribution candidate list. */
     threadBefore(sessionId, turnNo) {
         return this.store.threadBefore(sessionId, turnNo);

package/dist/packages/core/src/sqlite.d.ts

@@ -1,6 +1,6 @@
 import { DatabaseSync } from 'node:sqlite';
 import type { SoulStore } from './store.ts';
-export declare const SCHEMA_VERSION = 11;
+export declare const SCHEMA_VERSION = 12;
 export declare const AFFECT_RETENTION_MS: number;
 export declare class DbNewerThanBinaryError extends Error {
     readonly code = "DB_NEWER_THAN_BINARY";
@@ -13,6 +13,7 @@ export declare class DbNewerThanBinaryError extends Error {
  * old table stays as a read-only legacy copy.
  */
 /** v6 → v7: turn threads (a topic's turns need not be adjacent) plus turns.thread_id. */
+export declare function upgradeToV12(db: DatabaseSync): void;
 export declare function upgradeToV11(db: DatabaseSync): void;
 export declare function upgradeToV10(db: DatabaseSync): void;
 export declare function upgradeToV9(db: DatabaseSync): void;

package/dist/packages/core/src/sqlite.js

@@ -12,7 +12,7 @@ import { DEFAULT_EMOTION } from './types.js';
 import { FACT_STATUS, MEMORY_STATUS } from './config/status.js';
 import { FACT_ROLES } from './config/domains.js';
 import { bm25, buildCorpusStats, tokenize } from './scoring.js';
-export const SCHEMA_VERSION = 11;
+export const SCHEMA_VERSION = 12;
 /** How many recent pairs are considered before scoring. Bounded so recall stays O(candidates). */
 const RECALL_CANDIDATES = 500;
 export const AFFECT_RETENTION_MS = 30 * 24 * 60 * 60 * 1000;
@@ -212,7 +212,8 @@ CREATE TABLE IF NOT EXISTS gaps (
   status            TEXT NOT NULL DEFAULT 'open',
   opened_at         INTEGER NOT NULL,
   closed_at         INTEGER,
-  closed_by_fact_id TEXT
+  closed_by_fact_id TEXT,
+  close_reason      TEXT
 );
 CREATE INDEX IF NOT EXISTS idx_gaps_open ON gaps(soul_id, user_id, status, tension DESC);
 
@@ -299,6 +300,14 @@ function upgradeToV3(db) {
  * old table stays as a read-only legacy copy.
  */
 /** v6 → v7: turn threads (a topic's turns need not be adjacent) plus turns.thread_id. */
+export function upgradeToV12(db) {
+    // A missing date is a property of the fact, not an open question. Existing gaps created by
+    // that old rule are closed with the reason, so the remaining open gaps are the ones that
+    // were worth asking about.
+    ensureColumn(db, 'gaps', 'close_reason', 'TEXT');
+    db.prepare(`UPDATE gaps SET status = 'closed', closed_at = ?, close_reason = 'time-unknown-not-a-gap'
+      WHERE status = 'open' AND topic LIKE '日期不明：%'`).run(Date.now());
+}
 export function upgradeToV11(db) {
     // 原则候选 stored a decision as a slot; it is role+status now. The row becomes a lesson
     // candidate — held and shown to the classifier, injected nowhere until it is placed.
@@ -463,8 +472,8 @@ export function openSqlite(file) {
                 upgradeToV7(db);
             if (version < 8)
                 upgradeToV8(db);
-            if (version < 11)
-                upgradeToV11(db);
+            if (version < 12)
+                upgradeToV12(db);
             // v6 adds tables only; SCHEMA creates them on every open, nothing to copy.
             setVersion(db, SCHEMA_VERSION);
             db.exec('COMMIT');
@@ -918,6 +927,17 @@ export function openSqlite(file) {
              WHERE id = ?`)
                 .run(at, closedByFactId ?? null, id));
         },
+        closeStaleGaps(soulId, userId, beforeAt, reason) {
+            let changed = 0;
+            withRetry(() => {
+                const result = db
+                    .prepare(`UPDATE gaps SET status = 'closed', closed_at = ?, close_reason = ?
+              WHERE soul_id = ? AND user_id = ? AND status = 'open' AND opened_at < ?`)
+                    .run(Date.now(), reason, soulId, userId, beforeAt);
+                changed = Number(result.changes);
+            });
+            return changed;
+        },
         turn(id) {
             const row = db.prepare('SELECT * FROM turns WHERE id = ?').get(id);
             return row ? rowToTurnPair(row) : null;

package/dist/packages/core/src/store.d.ts

@@ -103,6 +103,11 @@ export interface SoulStore {
     putGap(spec: GapSpec): Gap;
     openGaps(soulId: string, userId: string, limit?: number): Gap[];
     closeGap(id: string, closedByFactId?: string, at?: number): void;
+    /**
+     * Close every open gap older than `beforeAt`, recording why. Returns how many were closed.
+     * An open question that nobody answered in weeks is not a question any more.
+     */
+    closeStaleGaps(soulId: string, userId: string, beforeAt: number, reason: string): number;
     /** Corrections the user made, newest first — the objective signal for behaviour changes. */
     corrections(soulId: string, userId: string, limit?: number): Correction[];
     /** Everything a portable bundle needs, scoped to one soul/user. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "soulbridge",
-  "version": "0.0.106",
+  "version": "0.0.107",
   "description": "A personality layer for any agent: continuity, forgetting, and growth across tools.",
   "license": "Apache-2.0",
   "type": "module",