soulbridge 0.0.108 → 0.0.110

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 = 13;
+export declare const SCHEMA_VERSION = 14;
 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 upgradeToV14(db: DatabaseSync): void;
 export declare function upgradeToV13(db: DatabaseSync): void;
 export declare function upgradeToV12(db: DatabaseSync): void;
 export declare function upgradeToV11(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 = 13;
+export const SCHEMA_VERSION = 14;
 /** 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;
@@ -302,6 +302,13 @@ 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 upgradeToV14(db) {
+    // Correct the semantics v13 used: a dated statement stops describing the present when the
+    // event is over. "小林在 10-24 被裁员" is valid on 10-24, not forever — otherwise every
+    // historical event would look like a current state.
+    db.exec(`UPDATE facts SET valid_until = COALESCE(at_end, at)
+      WHERE valid_until IS NULL AND at IS NOT NULL AND status <> 'retracted'`);
+}
 export function upgradeToV13(db) {
     // Two axes of time, like the legacy memory table had:
     //   created_at   when we recorded it (never changes)
@@ -491,8 +498,8 @@ export function openSqlite(file) {
                 upgradeToV7(db);
             if (version < 8)
                 upgradeToV8(db);
-            if (version < 13)
-                upgradeToV13(db);
+            if (version < 14)
+                upgradeToV14(db);
             // v6 adds tables only; SCHEMA creates them on every open, nothing to copy.
             setVersion(db, SCHEMA_VERSION);
             db.exec('COMMIT');
@@ -865,7 +872,12 @@ export function openSqlite(file) {
                 valid_from, valid_until, place_id, status, confidence, source, source_turn_id, superseded_by,
                 created_at)
              VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
-                    .run(id, spec.soulId, spec.userId, spec.statement, spec.typeName ?? null, role, spec.holder ?? 'world', spec.at ?? null, spec.atText ?? null, spec.atEnd ?? null, spec.atPrecision ?? 'unknown', spec.validFrom ?? spec.at ?? createdAt, spec.validUntil ?? null, spec.placeId ?? null, spec.status ?? 'active', spec.confidence ?? 1, spec.source ?? 'experienced', spec.sourceTurnId ?? null, spec.supersededBy ?? null, createdAt);
+                    .run(id, spec.soulId, spec.userId, spec.statement, spec.typeName ?? null, role, spec.holder ?? 'world', spec.at ?? null, spec.atText ?? null, spec.atEnd ?? null, spec.atPrecision ?? 'unknown', spec.validFrom ?? spec.at ?? createdAt, 
+                // A dated statement describes the world at that moment. For an event, validity
+                // ends when it is over (at, or at_end for a range); a standing state has no date
+                // and stays open until something replaces it. "Current" is therefore one query:
+                // valid_until IS NULL OR valid_until > now.
+                spec.validUntil ?? spec.atEnd ?? spec.at ?? null, spec.placeId ?? null, spec.status ?? 'active', spec.confidence ?? 1, spec.source ?? 'experienced', spec.sourceTurnId ?? null, spec.supersededBy ?? null, createdAt);
                 if (Number(inserted.changes) > 0) {
                     const insertSlot = db.prepare(`INSERT INTO fact_slots (fact_id, slot, value_type, entity_id, value_num, value_text, ref_fact_id)
              VALUES (?, ?, ?, ?, ?, ?, ?)`);
@@ -918,14 +930,17 @@ export function openSqlite(file) {
             return rows.map((row) => rowToFact(row, slots));
         },
         supersedeFact(oldId, newId) {
-            // The old claim stopped holding when the new one was recorded. `valid_until` is the
-            // time axis; `status` is the lifecycle — both are written, and they answer different
-            // questions ("was it ever true?" vs "is it still the current state?").
-            const recordedAt = Number(db.prepare('SELECT created_at FROM facts WHERE id = ?').get(newId)?.created_at ??
-                Date.now());
+            // A new claim ends the old one when the new claim became true — not when we happened to
+            // record it. "小林在 A 公司" ends at the layoff (10-24), not at the moment the layoff was
+            // mentioned. Falls back to the record time only when the successor has no validity start
+            // (an undated claim still replaces the old one now).
+            const successor = db
+                .prepare('SELECT created_at, valid_from FROM facts WHERE id = ?')
+                .get(newId);
+            const endedAt = Number(successor?.valid_from ?? successor?.created_at ?? Date.now());
             withRetry(() => db
                 .prepare(`UPDATE facts SET status = '${FACT_STATUS.retracted}', superseded_by = ?, valid_until = ? WHERE id = ?`)
-                .run(newId, recordedAt, oldId));
+                .run(newId, endedAt, oldId));
         },
         /* ---------------- gaps ---------------- */
         putGap(spec) {

package/package.json

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