soulbridge 0.0.14 → 0.0.15

package/dist/packages/cli/src/cli.js

@@ -312,7 +312,9 @@ async function main() {
             }
             for (const memory of memories) {
                 const preview = memory.content.replace(/\s+/g, ' ').slice(0, 72);
-                process.stdout.write(`${memory.id}  ${memory.type.padEnd(9)} imp=${String(memory.importance).padEnd(2)} ${preview}\n`);
+                const status = memory.status === 'active' ? '' : ` [${memory.status}]`;
+                const superseded = memory.supersededBy ? ` -> ${memory.supersededBy}` : '';
+                process.stdout.write(`${memory.id}  ${memory.type.padEnd(9)} imp=${String(memory.importance).padEnd(2)}${status}${superseded} ${preview}\n`);
             }
             return;
         }
@@ -324,6 +326,14 @@ async function main() {
             out({ ok: soul.forget(id), id });
             return;
         }
+        case 'supersede': {
+            const [oldId, newId] = positional;
+            if (!oldId || !newId)
+                throw new Error('usage: soulbridge supersede <old-id> <new-id>');
+            const { soul } = open(flags);
+            out({ ok: soul.supersede(oldId, newId), oldId, newId });
+            return;
+        }
         case 'corrections': {
             const { soul } = open(flags);
             const rows = soul.corrections(flags.limit ? Number(flags.limit) : 10);
@@ -344,9 +354,19 @@ async function main() {
             const config = ensureConfig();
             const dbPath = resolveDbPath(flags.db);
             const store = openSqlite(dbPath);
-            const memories = store.query({ soulId: config.soulId, userId: config.userId, limit: 100_000 });
+            const memories = store.query({
+                soulId: config.soulId,
+                userId: config.userId,
+                status: ['active', 'superseded'],
+                includeExpired: true,
+                limit: 100_000,
+            });
             const samples = store.recentAffect(config.soulId, config.userId, 0);
             store.close();
+            const now = Date.now();
+            const activeCount = memories.filter((m) => m.status === 'active' && (m.validUntil === undefined || m.validUntil > now)).length;
+            const supersededCount = memories.filter((m) => m.status === 'superseded').length;
+            const expiredCount = memories.filter((m) => m.status === 'active' && m.validUntil !== undefined && m.validUntil <= now).length;
             const byType = new Map();
             for (const memory of memories)
                 byType.set(memory.type, (byType.get(memory.type) ?? 0) + 1);
@@ -373,7 +393,7 @@ async function main() {
             const lines = [
                 `soul       ${config.soulId} / ${config.userId}`,
                 `db         ${dbPath}`,
-                `memories   ${memories.length}  (${typeText})`,
+                `memories   ${memories.length}  (有效 ${activeCount} · 被取代 ${supersededCount} · 已过期 ${expiredCount})  (${typeText})`,
                 `affect     ${samples.length} samples${samples.length > 0 ? ` · last ${ago(samples[0].at)}` : ''}`,
                 plugin
                     ? `plugin     v${plugin.version ?? '?'} · applied ${ago(plugin.appliedAt)} · inject ${plugin.injects ?? 0} · observe ${plugin.observes ?? 0} · fail ${plugin.observeFails ?? 0}`
@@ -411,6 +431,7 @@ async function main() {
                 '  list [--limit N]                看它记住了什么',
                 '  corrections [--limit N]         看被纠正过的证据',
                 '  forget <id>                     忘掉一条记忆（墓碑）',
+                '  supersede <old> <new>           用新记忆取代旧记忆（保留历史）',
                 '  status                          一眼看它是否在工作',
                 '  stats                           看原始状态（JSON）',
                 '  demo                            端到端演示（无需模型）',

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

@@ -52,10 +52,15 @@ export declare class Soul {
     constructor(options: SoulOptions);
     /** Verb 1: session start. */
     context(request?: Partial<ContextRequest>): ContextResult;
-    /** Every active memory, newest first. For `list` and for auditing injection. */
+    /**
+     * Audit view: every non-deleted row, including superseded and expired ones.
+     * Prompt builders use `context`, which filters both out.
+     */
     list(limit?: number): Memory[];
     /** Tombstone one memory so it never reaches a prompt again. */
     forget(id: string): boolean;
+    /** Mark `oldId` replaced by `newId`; neither row is deleted (RFC 0004). */
+    supersede(oldId: string, newId: string): boolean;
     /**
      * Record a user correction as evidence (RFC 0003 phase A). Nothing here
      * reaches a prompt; distillation to a strategy is a later phase.

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

@@ -59,14 +59,27 @@ export class Soul {
             maxItems: request.maxItems,
         });
     }
-    /** Every active memory, newest first. For `list` and for auditing injection. */
+    /**
+     * Audit view: every non-deleted row, including superseded and expired ones.
+     * Prompt builders use `context`, which filters both out.
+     */
     list(limit = 50) {
-        return this.store.query({ soulId: this.soulId, userId: this.userId, limit });
+        return this.store.query({
+            soulId: this.soulId,
+            userId: this.userId,
+            status: ['active', 'superseded'],
+            includeExpired: true,
+            limit,
+        });
     }
     /** Tombstone one memory so it never reaches a prompt again. */
     forget(id) {
         return this.store.forget(id);
     }
+    /** Mark `oldId` replaced by `newId`; neither row is deleted (RFC 0004). */
+    supersede(oldId, newId) {
+        return this.store.supersede(oldId, newId);
+    }
     /**
      * Record a user correction as evidence (RFC 0003 phase A). Nothing here
      * reaches a prompt; distillation to a strategy is a later phase.

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

@@ -236,12 +236,15 @@ export function openSqlite(file) {
         query(spec) {
             const statuses = spec.status ?? ['active'];
             const placeholders = statuses.map(() => '?').join(', ');
+            const now = spec.now ?? Date.now();
+            // Expiry is a filter, not a deletion: audit views can still see the row.
+            const expiry = spec.includeExpired ? '' : 'AND (valid_until IS NULL OR valid_until > ?)';
             const rows = db
                 .prepare(`SELECT * FROM memories
            WHERE soul_id = ? AND (user_id = ? OR visibility = 'shared')
-             AND status IN (${placeholders}) AND deleted_at IS NULL
+             AND status IN (${placeholders}) AND deleted_at IS NULL ${expiry}
            ORDER BY created_at DESC LIMIT ?`)
-                .all(spec.soulId, spec.userId, ...statuses, spec.limit ?? 500);
+                .all(spec.soulId, spec.userId, ...statuses, ...(spec.includeExpired ? [] : [now]), spec.limit ?? 500);
             const memories = rows.map(rowToMemory);
             return spec.types ? memories.filter((m) => spec.types.includes(m.type)) : memories;
         },
@@ -258,6 +261,19 @@ export function openSqlite(file) {
                 .run(now, now, id));
             return Number(result.changes ?? 0) > 0;
         },
+        /** Mark `oldId` as replaced by `newId`. Neither row is deleted. */
+        supersede(oldId, newId, now = Date.now()) {
+            const replacement = db
+                .prepare('SELECT id FROM memories WHERE id = ? AND deleted_at IS NULL')
+                .get(newId);
+            if (!replacement)
+                return false;
+            const result = withRetry(() => db
+                .prepare(`UPDATE memories SET status = 'superseded', superseded_by = ?, updated_at = ?
+             WHERE id = ? AND status = 'active' AND deleted_at IS NULL`)
+                .run(newId, now, oldId));
+            return Number(result.changes ?? 0) > 0;
+        },
         saveAffect(soulId, userId, signal, at, deviceId) {
             withRetry(() => {
                 db.prepare(`INSERT OR IGNORE INTO affect_samples

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

@@ -18,6 +18,12 @@ export interface SoulStore {
      * merge, the deletion wins by updatedAt). Returns false when no such active row.
      */
     forget(id: string, now?: number): boolean;
+    /**
+     * Mark `oldId` as replaced by `newId` (status superseded, supersededBy set).
+     * Both rows stay; returns false when the replacement is missing or the old row
+     * is not active.
+     */
+    supersede(oldId: string, newId: string, now?: number): boolean;
     /** Persist one affect sample (payload only; no raw text). */
     saveAffect(soulId: string, userId: string, signal: AffectSignal, at: number, deviceId?: string): void;
     /** Samples newer than `sinceMs`, newest first. */

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

@@ -23,8 +23,11 @@ export interface Memory {
     keywords: string[];
     createdAt: number;
     lastRecalledAt?: number;
+    /** Written on create; no code filters by it yet (roadmap N3). */
     validFrom?: number;
+    /** Reserved for expiry filtering; not enforced yet (roadmap N3). */
     validUntil?: number;
+    /** Reserved for conflict replacement; not written yet (roadmap N3). */
     supersededBy?: string;
     /** Last-writer-wins clock for cross-device merge (ADR 0021). */
     updatedAt?: number;
@@ -81,12 +84,6 @@ export interface ContextResult {
         directives: string[];
     };
 }
-export interface RecallRequest {
-    soulId: string;
-    userId: string;
-    q: string;
-    limit?: number;
-}
 export interface ScoredMemory {
     memory: Memory;
     score: number;
@@ -97,12 +94,20 @@ export interface QuerySpec {
     status?: MemoryStatus[];
     types?: MemoryType[];
     limit?: number;
+    /** Clock for expiry checks; defaults to now. */
+    now?: number;
+    /**
+     * Audit views (`list`) need to see expired rows; prompt builders must not.
+     * Defaults to false, so expiry applies unless a caller asks otherwise.
+     */
+    includeExpired?: boolean;
 }
 export interface ReflectResult {
     memories: number;
     /**
      * How many older memories were replaced by a newer conflicting one.
-     * `null` means this build does not track supersession yet — it used to report
+     *
+  ull` means this build does not track supersession yet — it used to report
      * a hardcoded 0, which claimed a capability that did not exist.
      */
     superseded: number | null;
@@ -185,12 +190,3 @@ export interface Correction {
     rule?: string;
     deviceId?: string;
 }
-export interface CorrectionInput {
-    soulId: string;
-    userId: string;
-    userText: string;
-    assistantText?: string;
-    rule?: string;
-    deviceId?: string;
-    at?: number;
-}

package/package.json

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