soulbridge 0.0.105 → 0.0.107

package/dist/packages/core/src/config/labels.d.ts

@@ -20,3 +20,17 @@ export declare const CONCLUSION_TYPE = "\u7ED3\u8BBA";
  * readers; retyping it in a second filter is how a layer silently drops out.
  */
 export declare const ANCHOR_TYPES: readonly string[];
+/**
+ * How a fact that came from my own reply is marked in injection (ADR 0035).
+ *
+ * Two renderers write fact lines — the core's `<memories>` block and the plugin's `<about>`
+ * block — and both must use the same marker, or the same fact reads differently depending on
+ * which path surfaced it. Declared here, imported by both.
+ */
+export declare const INFERRED_MARKER = "\u6211: ";
+/**
+ * One explanation per block, not one per line.
+ *
+ * 341 of 646 facts are inferred, so a sentence on every line would double the injection.
+ */
+export declare const SOURCE_NOTES = "<source-notes>\u4EE5\u300C\u6211:\u300D\u5F00\u5934\u7684\u662F\u6211\u4E0A\u4E00\u8F6E\u8BF4\u7684\u8BDD\uFF0C\u672A\u7ECF\u7528\u6237\u786E\u8BA4\uFF1B\u6CA1\u6807\u7684\u90FD\u662F\u7528\u6237\u8BF4\u7684\u3002</source-notes>";

package/dist/packages/core/src/config/labels.js

@@ -19,3 +19,17 @@ export const CONCLUSION_TYPE = '结论';
  * readers; retyping it in a second filter is how a layer silently drops out.
  */
 export const ANCHOR_TYPES = ['结论', '教训', '原则', '性格'];
+/**
+ * How a fact that came from my own reply is marked in injection (ADR 0035).
+ *
+ * Two renderers write fact lines — the core's `<memories>` block and the plugin's `<about>`
+ * block — and both must use the same marker, or the same fact reads differently depending on
+ * which path surfaced it. Declared here, imported by both.
+ */
+export const INFERRED_MARKER = '我: ';
+/**
+ * One explanation per block, not one per line.
+ *
+ * 341 of 646 facts are inferred, so a sentence on every line would double the injection.
+ */
+export const SOURCE_NOTES = '<source-notes>以「我:」开头的是我上一轮说的话，未经用户确认；没标的都是用户说的。</source-notes>';

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

@@ -1,5 +1,5 @@
 import { FACT_STATUS } from './config/status.js';
-import { ANCHOR_TYPES } from './config/labels.js';
+import { ANCHOR_TYPES, INFERRED_MARKER, SOURCE_NOTES } from './config/labels.js';
 import { isActive, roleOf } from './roles.js';
 import { escapeAttr, escapeBlockText } from './inject-text.js';
 import { selectDirectives } from './affect/directives.js';
@@ -109,7 +109,7 @@ export function buildContext(store, request, now = Date.now()) {
         }
         // Escaping can lengthen a line (one `<` is four characters), so cost is charged
         // on the escaped text — the budget has to measure what actually gets injected.
-        const marker = anchor.inferred ? '我: ' : '';
+        const marker = anchor.inferred ? INFERRED_MARKER : '';
         const line = `- ${marker}[${escapeBlockText(anchor.label)}] ${escapeBlockText(anchor.text)}`;
         if (anchor.inferred)
             sawInferred = true;
@@ -124,9 +124,8 @@ export function buildContext(store, request, now = Date.now()) {
     }
     if (request.includeAnchors !== false && lines.length > 0)
         sections.push(`<memories>\n${lines.join('\n')}\n</memories>`);
-    if (sawInferred) {
-        sections.push('<source-notes>以「我:」开头的是我上一轮说的话，未经用户确认；没标的都是用户说的。</source-notes>');
-    }
+    if (sawInferred)
+        sections.push(SOURCE_NOTES);
     const text = sections.join('\n\n');
     if (request.track !== false && used.length > 0)
         store.touch(used, now);

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

@@ -8,6 +8,7 @@ export * from './types.ts';
 export type { SoulStore } from './store.ts';
 export { openSqlite, SCHEMA_VERSION, AFFECT_RETENTION_MS, DbNewerThanBinaryError } from './sqlite.ts';
 export { buildContext, styleDirectives, DEFAULT_MAX_CHARS, AFFECT_BUDGET, AFFECT_WINDOW_MS, } from './context.ts';
+export { INFERRED_MARKER, SOURCE_NOTES } from './config/labels.ts';
 export { reflect, ruleExtract, nextEmotion, isCorrection, correctionRule, detectCorrection, isQuestion, } from './reflect.ts';
 export type { CorrectionLayer, CorrectionSignal, CorrectionVerdict } from './reflect.ts';
 export { rank, scoreMemory, tokenize, relevance, bm25, buildCorpusStats } from './scoring.ts';
@@ -326,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

@@ -7,6 +7,7 @@
 export * from './types.js';
 export { openSqlite, SCHEMA_VERSION, AFFECT_RETENTION_MS, DbNewerThanBinaryError } from './sqlite.js';
 export { buildContext, styleDirectives, DEFAULT_MAX_CHARS, AFFECT_BUDGET, AFFECT_WINDOW_MS, } from './context.js';
+export { INFERRED_MARKER, SOURCE_NOTES } from './config/labels.js';
 export { reflect, ruleExtract, nextEmotion, isCorrection, correctionRule, detectCorrection, isQuestion, } from './reflect.js';
 export { rank, scoreMemory, tokenize, relevance, bm25, buildCorpusStats } from './scoring.js';
 export { parseThreadLine } from './extract.js';
@@ -534,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
@@ -817,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.105",
+  "version": "0.0.107",
   "description": "A personality layer for any agent: continuity, forgetting, and growth across tools.",
   "license": "Apache-2.0",
   "type": "module",