cogmem 3.7.1 → 3.7.3

package/dist/migrations/index.d.ts

@@ -23,13 +23,18 @@ import { migration_0024 } from './0024_episode_ontology_reliability.js';
 import { migration_0025 } from './0025_memory_atlas.js';
 import { migration_0026 } from './0026_runtime_governance_atlas_reliability.js';
 import { migration_0027 } from './0027_openclaw_upgrade_hotfix.js';
+import { migration_0028 } from './0028_episode_boundary_guardrails.js';
+import { migration_0029 } from './0029_episode_active_scope_guard.js';
+import { migration_0030 } from './0030_memory_event_local_date_source.js';
+import { migration_0031 } from './0031_episode_boundary_integrity_repair.js';
 /**
  * Ordered list of all schema migrations.
  * Add new migrations here in ascending version order.
  * MigrationRunner.up() applies only the pending ones.
  */
 export declare const ALL_MIGRATIONS: Migration[];
-export { migration_0001, migration_0002, migration_0003, migration_0004, migration_0005, migration_0006, migration_0007, migration_0009, migration_0010, migration_0011, migration_0012, migration_0015, migration_0016, migration_0017, migration_0018, migration_0019, migration_0020, migration_0021, migration_0022, migration_0023, migration_0024, migration_0025, migration_0026, migration_0027 };
+export declare const KERNEL_MIGRATIONS: Migration[];
+export { migration_0001, migration_0002, migration_0003, migration_0004, migration_0005, migration_0006, migration_0007, migration_0009, migration_0010, migration_0011, migration_0012, migration_0015, migration_0016, migration_0017, migration_0018, migration_0019, migration_0020, migration_0021, migration_0022, migration_0023, migration_0024, migration_0025, migration_0026, migration_0027, migration_0028, migration_0029, migration_0030, migration_0031 };
 export { SchemaMigrationRunner } from './SchemaMigrationRunner.js';
 export type { SchemaMigrationResult, SchemaMigrationRunOptions } from './SchemaMigrationRunner.js';
 export type { Migration };

package/dist/migrations/index.js

@@ -22,6 +22,10 @@ import { migration_0024 } from './0024_episode_ontology_reliability.js';
 import { migration_0025 } from './0025_memory_atlas.js';
 import { migration_0026 } from './0026_runtime_governance_atlas_reliability.js';
 import { migration_0027 } from './0027_openclaw_upgrade_hotfix.js';
+import { migration_0028 } from './0028_episode_boundary_guardrails.js';
+import { migration_0029 } from './0029_episode_active_scope_guard.js';
+import { migration_0030 } from './0030_memory_event_local_date_source.js';
+import { migration_0031 } from './0031_episode_boundary_integrity_repair.js';
 /**
  * Ordered list of all schema migrations.
  * Add new migrations here in ascending version order.
@@ -52,6 +56,16 @@ export const ALL_MIGRATIONS = [
     migration_0025,
     migration_0026,
     migration_0027,
+    migration_0028,
+    migration_0029,
+    migration_0030,
+    migration_0031,
 ];
-export { migration_0001, migration_0002, migration_0003, migration_0004, migration_0005, migration_0006, migration_0007, migration_0009, migration_0010, migration_0011, migration_0012, migration_0015, migration_0016, migration_0017, migration_0018, migration_0019, migration_0020, migration_0021, migration_0022, migration_0023, migration_0024, migration_0025, migration_0026, migration_0027 };
+// Core stores bootstrap the pre-0015 tables themselves. Running the early
+// historical migrations against a fresh kernel would try to ALTER optional
+// legacy tables that do not exist yet. The kernel still runs every migration
+// from the first schema that owns the runtime tables through the latest one;
+// the CLI remains able to replay the complete historical chain.
+export const KERNEL_MIGRATIONS = ALL_MIGRATIONS.filter((migration) => Number.parseInt(migration.version, 10) >= 15);
+export { migration_0001, migration_0002, migration_0003, migration_0004, migration_0005, migration_0006, migration_0007, migration_0009, migration_0010, migration_0011, migration_0012, migration_0015, migration_0016, migration_0017, migration_0018, migration_0019, migration_0020, migration_0021, migration_0022, migration_0023, migration_0024, migration_0025, migration_0026, migration_0027, migration_0028, migration_0029, migration_0030, migration_0031 };
 export { SchemaMigrationRunner } from './SchemaMigrationRunner.js';

package/dist/public.d.ts

@@ -16,7 +16,7 @@
  */
 export { MemoryKernel, createMemoryKernel, createMemoryKernelFromConfig, } from './factory.js';
 export type { ForgetUserResult, GovernanceAuditRecord, DreamCandidateListOptions, DreamCandidateRecord, DreamCandidateStatus, DreamCuratorRunOptions, DreamCuratorRunResult, DreamTickOptions, DreamTickResult, EpisodeClosureReceipt, EpisodeDreamStatus, EpisodeListOptions, EpisodeMessageInput, EpisodeMessageResult, EpisodeRepairInput, EpisodeRepairResult, MemoryEpisode, MaintenanceSuggestedAction, MaintenanceTickOptions, MaintenanceTickResult, MemoryDataLane, MemoryBindingBackfillOptions, MemoryBindingBackfillResult, MemoryKernelFromConfigOptions, MemoryKernelNavigationOptions, MemoryKernelNavigationResult, MemoryKernelOptions, MemoryMapOptions, MemoryMapSection, MemorySelfMap, RawEventSearchOptions, RawMemoryEventInput, TaskMemoryEventInput, ToolCallMemoryEventInput, ToolResultMemoryEventInput, } from './factory.js';
-export { EpisodeAssembler, EpisodeStore, classifyAssistantRelation, classifyTurnRelation, classifyTurnRelationHybrid, createStableImportIdentityFactory, summarizeEpisode, type EpisodeCandidateType, type EpisodeClosureMode, type EpisodeClosureReasonCode, type EpisodeDreamState, type EpisodeDreamStatusValue, type EpisodeEventLink, type EpisodeSemanticSummary, type EpisodeStatus, type EpisodeType, type StableImportIdentityInput, type TurnClassificationContext, type TurnRelation, type TurnRelationAdvisoryReviewer, type TurnRelationDecision, } from './episode/index.js';
+export { EpisodeAssembler, EpisodeStore, classifyAssistantRelation, classifyTurnRelation, classifyTurnRelationHybrid, classifyTurnRelationHybridTrace, createStableImportIdentityFactory, summarizeEpisode, type EpisodeCandidateType, type EpisodeClosureMode, type EpisodeClosureReasonCode, type EpisodeDreamState, type EpisodeDreamStatusValue, type EpisodeEventLink, type EpisodeSemanticSummary, type EpisodeStatus, type EpisodeType, type EpisodeBoundaryAuditItem, type EpisodeBoundaryAuditResult, type EpisodeBoundaryConfig, type EpisodeBoundaryConfigDiagnostic, type EpisodeBoundaryDecisionRecord, type EpisodeBoundaryGuardCode, type EpisodeBoundaryGuardResult, type EpisodeBoundaryMetrics, type EpisodeBoundaryMode, type EpisodeBoundaryWarning, type EpisodeSplitImpactInventory, type EpisodeSplitPlan, type EpisodeSplitPlanSegment, type EpisodeSplitProposedBoundary, type StableImportIdentityInput, type TurnClassificationContext, type TurnRelation, type TurnRelationAdvisoryReviewer, type TurnRelationDecision, type TurnRelationHybridTrace, type TurnRelationReviewStatus, } from './episode/index.js';
 export { DreamScheduler, type DreamTickMode, type SelectedDreamMode } from './dream/index.js';
 export { MEMORY_ONTOLOGY_CLASSES, isMemoryOntologyClass, type MemoryOntologyClass } from './ontology/MemoryOntology.js';
 export { TopicAliasRegistry, TopicGovernance, TopicPathRegistry as UserTopicPathRegistry, TopicRelationGraph, type TopicAliasRecord, type TopicCreatedBy, type TopicNode, type TopicOperationInput, type TopicOperationRecord, type TopicOperationType, type TopicRelationRecord, type TopicStatus, } from './topic/index.js';

package/dist/public.js

@@ -16,7 +16,7 @@
  * @stable @since 1.0.0
  */
 export { MemoryKernel, createMemoryKernel, createMemoryKernelFromConfig, } from './factory.js';
-export { EpisodeAssembler, EpisodeStore, classifyAssistantRelation, classifyTurnRelation, classifyTurnRelationHybrid, createStableImportIdentityFactory, summarizeEpisode, } from './episode/index.js';
+export { EpisodeAssembler, EpisodeStore, classifyAssistantRelation, classifyTurnRelation, classifyTurnRelationHybrid, classifyTurnRelationHybridTrace, createStableImportIdentityFactory, summarizeEpisode, } from './episode/index.js';
 export { DreamScheduler } from './dream/index.js';
 export { MEMORY_ONTOLOGY_CLASSES, isMemoryOntologyClass } from './ontology/MemoryOntology.js';
 export { TopicAliasRegistry, TopicGovernance, TopicPathRegistry as UserTopicPathRegistry, TopicRelationGraph, } from './topic/index.js';

package/dist/recall/BrainRecall.js

@@ -280,7 +280,7 @@ export class BrainRecall {
             if (!edge.fromNodeId || !edge.toNodeId || edge.fromNodeId === edge.toNodeId) {
                 return 'ambiguous_edge_payload';
             }
-            if (!this.deps.entityStore.findByEntityId(edge.fromNodeId) || !this.deps.entityStore.findByEntityId(edge.toNodeId)) {
+            if (!this.deps.entityStore.findActiveByEntityId(edge.fromNodeId) || !this.deps.entityStore.findActiveByEntityId(edge.toNodeId)) {
                 return 'ambiguous_unknown_target_entity';
             }
             if (resolvedEntityIds.includes(edge.fromNodeId)) {

package/dist/store/DeepWriteCandidateStore.d.ts

@@ -1,6 +1,6 @@
 import type Database from 'bun:sqlite';
-export type DeepWriteRunStatus = 'succeeded' | 'failed' | 'skipped';
-export type DeepWriteCandidateStatus = 'shadow' | 'candidate' | 'promoted' | 'rejected' | 'needs_confirmation' | 'superseded';
+export type DeepWriteRunStatus = 'running' | 'staged' | 'succeeded' | 'failed' | 'skipped' | 'abandoned';
+export type DeepWriteCandidateStatus = 'staged' | 'shadow' | 'candidate' | 'promoting' | 'promoted' | 'rejected' | 'needs_confirmation' | 'superseded';
 export interface DeepWriteRunInput {
     runId?: string;
     projectId?: string;
@@ -14,12 +14,18 @@ export interface DeepWriteRunInput {
     status: DeepWriteRunStatus;
     error?: string;
     createdAt?: number;
+    sourceEpisodeId?: string;
+    dreamJobLeaseId?: string;
+    leaseUntil?: number;
+    attemptGeneration?: number;
+    updatedAt?: number;
 }
 export interface DeepWriteCandidateInput {
     candidateId?: string;
     runId: string;
     candidateType: string;
     status: DeepWriteCandidateStatus;
+    publishStatus?: Exclude<DeepWriteCandidateStatus, 'staged'>;
     confidence: number;
     content: unknown;
     evidence: unknown;
@@ -44,16 +50,24 @@ export interface DeepWriteCandidateListOptions {
     projectId?: string;
     runId?: string;
     limit?: number;
+    after?: {
+        createdAt: number;
+        candidateId: string;
+    };
 }
 export declare class DeepWriteCandidateStore {
     private readonly db;
     constructor(db: Database);
+    getDatabase(): Database;
+    countActivePromotions(targetType: string, targetId: string, excludingCandidateId?: string): number;
+    recoverStalePromoting(before: number, updatedAt: number): number;
     initSchema(): void;
     insertRun(input: DeepWriteRunInput): DeepWriteRunRecord;
     insertCandidates(inputs: DeepWriteCandidateInput[]): DeepWriteCandidateRecord[];
     getRun(runId: string): DeepWriteRunRecord | null;
     listCandidatesByRun(runId: string): DeepWriteCandidateRecord[];
     getCandidate(candidateId: string): DeepWriteCandidateRecord | null;
+    claimCandidate(candidateId: string, updatedAt?: number): boolean;
     listCandidatesByStatus(statuses: DeepWriteCandidateStatus[], options?: {
         candidateTypes?: string[];
         limit?: number;
@@ -66,7 +80,11 @@ export declare class DeepWriteCandidateStore {
         reason?: string;
         reviewAfter?: number | null;
         updatedAt?: number;
-    }): void;
+    }, expectedStatus?: DeepWriteCandidateStatus): void;
+    publishStagedCandidates(runId: string, candidateIds: string[], updatedAt: number): void;
+    failStagedRun(runId: string, now: number, reason: string): void;
+    updateRunStatus(runId: string, expected: DeepWriteRunStatus, next: DeepWriteRunStatus): void;
+    abandonStaleStagedRuns(before: number, updatedAt: number, projectId?: string): number;
     updateCandidateReviewData(candidateId: string, input: {
         content: unknown;
         evidence: unknown;

package/dist/store/DeepWriteCandidateStore.js

@@ -5,6 +5,28 @@ export class DeepWriteCandidateStore {
         this.db = db;
         this.initSchema();
     }
+    getDatabase() {
+        return this.db;
+    }
+    countActivePromotions(targetType, targetId, excludingCandidateId) {
+        const row = this.db.prepare(`
+      SELECT COUNT(*) AS count
+      FROM deep_write_candidates
+      WHERE promotion_target_type = ?
+        AND promotion_target_id = ?
+        AND status IN ('staged', 'candidate', 'promoted', 'needs_confirmation')
+        AND (? IS NULL OR candidate_id <> ?)
+    `).get(targetType, targetId, excludingCandidateId || null, excludingCandidateId || null);
+        return Number(row?.count || 0);
+    }
+    recoverStalePromoting(before, updatedAt) {
+        const result = this.db.prepare(`
+      UPDATE deep_write_candidates
+      SET status = 'candidate', status_reason = 'promotion_timeout_recovered', updated_at = ?
+      WHERE status = 'promoting' AND updated_at < ?
+    `).run(updatedAt, before);
+        return Number(result.changes || 0);
+    }
     initSchema() {
         this.db.exec(`
       CREATE TABLE IF NOT EXISTS deep_write_runs (
@@ -19,7 +41,12 @@ export class DeepWriteCandidateStore {
         output_hash TEXT NOT NULL,
         status TEXT NOT NULL,
         error TEXT,
-        created_at INTEGER NOT NULL
+        created_at INTEGER NOT NULL,
+        source_episode_id TEXT,
+        dream_job_lease_id TEXT,
+        lease_until INTEGER,
+        attempt_generation INTEGER,
+        updated_at INTEGER
       );
 
       CREATE TABLE IF NOT EXISTS deep_write_candidates (
@@ -49,8 +76,14 @@ export class DeepWriteCandidateStore {
         ON deep_write_candidates(status, candidate_type);
     `);
         this.ensureColumn('deep_write_candidates', 'status_reason', 'TEXT');
+        this.ensureColumn('deep_write_candidates', 'publish_status', 'TEXT');
         this.ensureColumn('deep_write_candidates', 'review_after', 'INTEGER');
         this.ensureColumn('deep_write_candidates', 'updated_at', 'INTEGER');
+        this.ensureColumn('deep_write_runs', 'source_episode_id', 'TEXT');
+        this.ensureColumn('deep_write_runs', 'dream_job_lease_id', 'TEXT');
+        this.ensureColumn('deep_write_runs', 'lease_until', 'INTEGER');
+        this.ensureColumn('deep_write_runs', 'attempt_generation', 'INTEGER');
+        this.ensureColumn('deep_write_runs', 'updated_at', 'INTEGER');
         this.db.exec(`
       UPDATE deep_write_candidates
       SET updated_at = created_at
@@ -67,8 +100,9 @@ export class DeepWriteCandidateStore {
       INSERT INTO deep_write_runs (
         run_id, project_id, session_id, source_neuron_ids_json, model_provider,
         model_name, mode, prompt_hash, output_hash, status, error, created_at
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-    `).run(record.runId, record.projectId || null, record.sessionId || null, JSON.stringify(record.sourceNeuronIds), record.modelProvider || null, record.modelName || null, record.mode, record.promptHash, record.outputHash, record.status, record.error || null, record.createdAt);
+        , source_episode_id, dream_job_lease_id, lease_until, attempt_generation, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(record.runId, record.projectId || null, record.sessionId || null, JSON.stringify(record.sourceNeuronIds), record.modelProvider || null, record.modelName || null, record.mode, record.promptHash, record.outputHash, record.status, record.error || null, record.createdAt, record.sourceEpisodeId || null, record.dreamJobLeaseId || null, record.leaseUntil ?? null, record.attemptGeneration ?? null, record.updatedAt ?? record.createdAt);
         return record;
     }
     insertCandidates(inputs) {
@@ -82,12 +116,12 @@ export class DeepWriteCandidateStore {
       INSERT INTO deep_write_candidates (
         candidate_id, run_id, candidate_type, status, confidence, content_json,
         evidence_json, promotion_target_type, promotion_target_id, status_reason,
-        review_after, created_at, updated_at
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+        publish_status, review_after, created_at, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
     `);
         this.db.transaction(() => {
             for (const record of records) {
-                stmt.run(record.candidateId, record.runId, record.candidateType, record.status, record.confidence, JSON.stringify(record.content), JSON.stringify(record.evidence), record.promotionTargetType || null, record.promotionTargetId || null, record.statusReason || null, record.reviewAfter ?? null, record.createdAt, record.updatedAt);
+                stmt.run(record.candidateId, record.runId, record.candidateType, record.status, record.confidence, JSON.stringify(record.content), JSON.stringify(record.evidence), record.promotionTargetType || null, record.promotionTargetId || null, record.statusReason || null, record.publishStatus || null, record.reviewAfter ?? null, record.createdAt, record.updatedAt);
             }
         })();
         return records;
@@ -117,6 +151,14 @@ export class DeepWriteCandidateStore {
     `).get(candidateId);
         return row ? this.mapCandidate(row) : null;
     }
+    claimCandidate(candidateId, updatedAt = Date.now()) {
+        const result = this.db.prepare(`
+      UPDATE deep_write_candidates
+      SET status = 'promoting', updated_at = ?
+      WHERE candidate_id = ? AND status = 'candidate'
+    `).run(updatedAt, candidateId);
+        return Number(result.changes || 0) === 1;
+    }
     listCandidatesByStatus(statuses, options) {
         if (statuses.length === 0)
             return [];
@@ -137,7 +179,7 @@ export class DeepWriteCandidateStore {
     }
     listCandidates(options = {}) {
         const params = [];
-        const conditions = [];
+        const conditions = options.statuses?.some((status) => status === 'staged' || status === 'promoting') ? [] : ["c.status NOT IN ('staged', 'promoting')"];
         let sql = `
       SELECT c.*
       FROM deep_write_candidates c
@@ -159,6 +201,10 @@ export class DeepWriteCandidateStore {
             conditions.push('c.run_id = ?');
             params.push(options.runId);
         }
+        if (options.after) {
+            conditions.push('(c.created_at > ? OR (c.created_at = ? AND c.candidate_id > ?))');
+            params.push(options.after.createdAt, options.after.createdAt, options.after.candidateId);
+        }
         if (conditions.length)
             sql += ` WHERE ${conditions.join(' AND ')}`;
         sql += ` ORDER BY c.created_at ASC, c.candidate_id ASC LIMIT ?`;
@@ -168,7 +214,7 @@ export class DeepWriteCandidateStore {
     }
     countCandidates(options = {}) {
         const params = [];
-        const conditions = [];
+        const conditions = options.statuses?.some((status) => status === 'staged' || status === 'promoting') ? [] : ["c.status NOT IN ('staged', 'promoting')"];
         let sql = `
       SELECT COUNT(*) AS count
       FROM deep_write_candidates c
@@ -195,7 +241,7 @@ export class DeepWriteCandidateStore {
         const row = this.db.prepare(sql).get(...params);
         return row?.count || 0;
     }
-    updateCandidateStatus(candidateId, status, promotionTarget) {
+    updateCandidateStatus(candidateId, status, promotionTarget, expectedStatus) {
         this.db.prepare(`
       UPDATE deep_write_candidates
       SET status = ?,
@@ -204,8 +250,63 @@ export class DeepWriteCandidateStore {
           status_reason = COALESCE(?, status_reason),
           review_after = COALESCE(?, review_after),
           updated_at = ?
-      WHERE candidate_id = ?
-    `).run(status, promotionTarget?.type || null, promotionTarget?.id || null, promotionTarget?.reason || null, promotionTarget?.reviewAfter ?? null, promotionTarget?.updatedAt ?? Date.now(), candidateId);
+      WHERE candidate_id = ? AND (? IS NULL OR status = ?)
+    `).run(status, promotionTarget?.type || null, promotionTarget?.id || null, promotionTarget?.reason || null, promotionTarget?.reviewAfter ?? null, promotionTarget?.updatedAt ?? Date.now(), candidateId, expectedStatus || null, expectedStatus || null);
+    }
+    publishStagedCandidates(runId, candidateIds, updatedAt) {
+        const statement = this.db.prepare(`UPDATE deep_write_candidates SET status = COALESCE(publish_status, 'candidate'), updated_at = ? WHERE candidate_id = ? AND run_id = ? AND status = 'staged'`);
+        for (const candidateId of candidateIds) {
+            const staged = Number(statement.run(updatedAt, candidateId, runId).changes || 0);
+            if (staged === 1)
+                continue;
+            const visible = this.db.prepare(`SELECT status, run_id FROM deep_write_candidates WHERE candidate_id = ?`).get(candidateId);
+            if (visible?.run_id !== runId || visible.status !== 'shadow')
+                throw new Error(`staged_candidate_publish_conflict:${candidateId}`);
+        }
+    }
+    failStagedRun(runId, now, reason) {
+        this.db.transaction(() => {
+            this.db.prepare(`UPDATE deep_write_candidates SET status = 'superseded', status_reason = ?, updated_at = ? WHERE run_id = ? AND status IN ('staged', 'shadow')`).run(reason, now, runId);
+            this.db.prepare(`UPDATE deep_write_runs SET status = 'failed', error = ? WHERE run_id = ? AND status = 'staged'`).run(reason, runId);
+        })();
+    }
+    updateRunStatus(runId, expected, next) {
+        const result = this.db.prepare(`UPDATE deep_write_runs SET status = ? WHERE run_id = ? AND status = ?`).run(next, runId, expected);
+        if (Number(result.changes || 0) !== 1)
+            throw new Error(`dream_run_status_conflict:${runId}`);
+    }
+    abandonStaleStagedRuns(before, updatedAt, projectId) {
+        const transaction = this.db.transaction(() => {
+            const candidates = this.db.prepare(`
+        SELECT r.run_id
+        FROM deep_write_runs r
+        LEFT JOIN episode_dream_jobs j ON j.episode_id = r.source_episode_id
+        WHERE r.status = 'staged' AND r.created_at < ?
+          AND (? IS NULL OR r.project_id = ?)
+          AND (
+            j.episode_id IS NULL
+            OR j.state <> 'processing'
+            OR j.lease_id <> r.dream_job_lease_id
+            OR j.lease_until IS NULL
+            OR j.lease_until < ?
+          )
+      `).all(before, projectId || null, projectId || null, updatedAt);
+            let abandoned = 0;
+            for (const row of candidates) {
+                this.db.prepare(`
+          UPDATE deep_write_candidates
+          SET status = 'superseded', status_reason = 'staged_run_abandoned', updated_at = ?
+          WHERE run_id = ? AND status IN ('staged', 'shadow')
+        `).run(updatedAt, row.run_id);
+                const result = this.db.prepare(`
+          UPDATE deep_write_runs SET status = 'abandoned', error = COALESCE(error, 'staged_run_abandoned')
+          WHERE run_id = ? AND status = 'staged'
+        `).run(row.run_id);
+                abandoned += Number(result.changes || 0);
+            }
+            return abandoned;
+        });
+        return transaction();
     }
     updateCandidateReviewData(candidateId, input) {
         this.db.prepare(`
@@ -261,6 +362,11 @@ export class DeepWriteCandidateStore {
             outputHash: row.output_hash,
             status: row.status,
             error: row.error || undefined,
+            sourceEpisodeId: row.source_episode_id || undefined,
+            dreamJobLeaseId: row.dream_job_lease_id || undefined,
+            leaseUntil: row.lease_until ?? undefined,
+            attemptGeneration: row.attempt_generation ?? undefined,
+            updatedAt: row.updated_at ?? row.created_at,
             createdAt: row.created_at
         };
     }
@@ -270,6 +376,7 @@ export class DeepWriteCandidateStore {
             runId: row.run_id,
             candidateType: row.candidate_type,
             status: row.status,
+            publishStatus: row.publish_status || undefined,
             confidence: row.confidence,
             content: JSON.parse(row.content_json || '{}'),
             evidence: JSON.parse(row.evidence_json || '[]'),

package/dist/store/EntityStore.d.ts

@@ -106,6 +106,8 @@ export declare class EntityStore {
     listByAlias(aliasText: string, type?: string): EntityRecord[];
     findByCanonicalName(canonicalName: string, type?: string): EntityRecord | null;
     findByEntityId(entityId: string): EntityRecord | null;
+    findActiveByEntityId(entityId: string): EntityRecord | null;
+    getByEntityId(entityId: string): EntityRecord | null;
     findLatestByType(type: string): EntityRecord | null;
     listRecentByType(type: string, limit?: number): EntityRecord[];
     private listByCreationOrder;
@@ -125,12 +127,14 @@ export declare class EntityStore {
         type?: string;
         projectId?: string;
         limit?: number;
+        includeInactive?: boolean;
     }): EntityMentionRecord[];
     getEntityTimeline(input: {
         type?: string;
         projectId?: string;
         entityIds?: string[];
         limit?: number;
+        includeInactive?: boolean;
     }): EntityTimelineItem[];
     listEntitiesUpdatedInRange(startTime: number, endTime: number, type?: string): EntityRecord[];
     archiveEntity(entityId: string, updatedAt?: number): void;

package/dist/store/EntityStore.js

@@ -183,7 +183,7 @@ export class EntityStore {
         WHERE instance_id = ?
       `).run(JSON.stringify(mergedAliases), input.status || existing.status, JSON.stringify(mergedMetadata), now, existing.entityId);
             this.upsertAliases(existing.entityId, input.type, mergedAliases, now);
-            return this.findByEntityId(existing.entityId);
+            return this.getByEntityId(existing.entityId);
         }
         const record = {
             entityId: `entity-${randomUUID()}`,
@@ -216,7 +216,7 @@ export class EntityStore {
           SELECT e.*
           FROM entity_aliases ea
           JOIN entity_instances e ON e.instance_id = ea.entity_id
-          WHERE ea.normalized_alias = ? AND e.type = ?
+          WHERE ea.normalized_alias = ? AND e.type = ? AND e.status = 'active'
           ORDER BY ea.updated_at DESC
           LIMIT 12
         `).all(normalizedAlias, type)
@@ -224,7 +224,7 @@ export class EntityStore {
           SELECT e.*
           FROM entity_aliases ea
           JOIN entity_instances e ON e.instance_id = ea.entity_id
-          WHERE ea.normalized_alias = ?
+          WHERE ea.normalized_alias = ? AND e.status = 'active'
           ORDER BY ea.updated_at DESC
           LIMIT 12
         `).all(normalizedAlias);
@@ -233,29 +233,37 @@ export class EntityStore {
     findByCanonicalName(canonicalName, type) {
         const row = type
             ? this.db.prepare(`
-          SELECT * FROM entity_instances WHERE canonical_name = ? AND type = ? ORDER BY updated_at DESC LIMIT 1
+          SELECT * FROM entity_instances WHERE canonical_name = ? AND type = ? AND status = 'active' ORDER BY updated_at DESC LIMIT 1
         `).get(canonicalName, type)
             : this.db.prepare(`
-          SELECT * FROM entity_instances WHERE canonical_name = ? ORDER BY updated_at DESC LIMIT 1
+          SELECT * FROM entity_instances WHERE canonical_name = ? AND status = 'active' ORDER BY updated_at DESC LIMIT 1
         `).get(canonicalName);
         return row ? this.mapRow(row) : null;
     }
     findByEntityId(entityId) {
+        const row = this.db.prepare(`SELECT * FROM entity_instances WHERE instance_id = ?`).get(entityId);
+        return row ? this.mapRow(row) : null;
+    }
+    findActiveByEntityId(entityId) {
         const row = this.db.prepare(`
-      SELECT * FROM entity_instances WHERE instance_id = ?
+      SELECT * FROM entity_instances WHERE instance_id = ? AND status = 'active'
     `).get(entityId);
         return row ? this.mapRow(row) : null;
     }
+    getByEntityId(entityId) {
+        const row = this.db.prepare(`SELECT * FROM entity_instances WHERE instance_id = ?`).get(entityId);
+        return row ? this.mapRow(row) : null;
+    }
     findLatestByType(type) {
         const row = this.db.prepare(`
-      SELECT * FROM entity_instances WHERE type = ? ORDER BY updated_at DESC, created_at DESC LIMIT 1
+      SELECT * FROM entity_instances WHERE type = ? AND status = 'active' ORDER BY updated_at DESC, created_at DESC LIMIT 1
     `).get(type);
         return row ? this.mapRow(row) : null;
     }
     listRecentByType(type, limit = 8) {
         const rows = this.db.prepare(`
       SELECT * FROM entity_instances
-      WHERE type = ?
+      WHERE type = ? AND status = 'active'
       ORDER BY updated_at DESC, created_at DESC
       LIMIT ?
     `).all(type, limit);
@@ -264,7 +272,7 @@ export class EntityStore {
     listByCreationOrder(type, limit = 8) {
         const rows = this.db.prepare(`
       SELECT * FROM entity_instances
-      WHERE type = ?
+      WHERE type = ? AND status = 'active'
       ORDER BY created_at DESC, updated_at DESC
       LIMIT ?
     `).all(type, limit);
@@ -411,7 +419,7 @@ export class EntityStore {
       ) VALUES (?, ?, ?, ?, ?, ?)
     `).run(record.mentionId, record.entityId, record.neuronId || null, record.projectId || null, record.mentionType, record.createdAt);
         this.touchEntity(record.entityId, record.createdAt);
-        const entity = this.findByEntityId(record.entityId);
+        const entity = this.getByEntityId(record.entityId);
         if (entity) {
             for (const alias of [entity.canonicalName, ...(entity.aliases || [])]) {
                 this.refreshAliasConflict(this.normalizeAlias(alias), entity.type, record.createdAt);
@@ -440,6 +448,8 @@ export class EntityStore {
             sql += ` AND em.project_id = ?`;
             params.push(input.projectId);
         }
+        if (!input.includeInactive)
+            sql += ` AND e.status = 'active'`;
         sql += ` ORDER BY em.created_at DESC LIMIT ?`;
         params.push(limit);
         const rows = this.db.prepare(sql).all(...params);
@@ -469,6 +479,8 @@ export class EntityStore {
             sql += ` AND em.project_id = ?`;
             params.push(input.projectId);
         }
+        if (!input.includeInactive)
+            sql += ` AND e.status = 'active'`;
         if (input.entityIds?.length) {
             sql += ` AND em.entity_id IN (${input.entityIds.map(() => '?').join(', ')})`;
             params.push(...input.entityIds);
@@ -662,7 +674,7 @@ export class EntityStore {
             this.db.close();
     }
     addAlias(entityId, alias, updatedAt = Date.now()) {
-        const entity = this.findByEntityId(entityId);
+        const entity = this.getByEntityId(entityId);
         if (!entity || !alias.trim())
             return;
         const aliases = Array.from(new Set([...entity.aliases, alias.trim()]));
@@ -671,7 +683,7 @@ export class EntityStore {
         this.upsertAliases(entityId, entity.type, [alias], updatedAt);
     }
     removeAlias(entityId, alias, updatedAt = Date.now()) {
-        const entity = this.findByEntityId(entityId);
+        const entity = this.getByEntityId(entityId);
         if (!entity || entity.canonicalName === alias)
             return;
         const normalized = this.normalizeAlias(alias);

package/dist/store/EventStore.d.ts

@@ -1,3 +1,4 @@
+import Database from 'bun:sqlite';
 import type { EncryptionProvider } from '../encryption/index.js';
 import type { EventAuditPage, MemoryEvent, MemoryEventCausalityType, MemoryEventContext, MemoryRawEventType, MemoryEventRole, MemoryEventType, OrderingConfidence, StreamType } from '../types/index.js';
 export interface ProjectionCheckpoint {
@@ -28,6 +29,7 @@ export interface AppendEventInput<TPayload = Record<string, unknown>> {
     threadId?: string;
     sessionId?: string;
     localDate?: string;
+    localDateSource?: 'explicit' | 'generated_utc' | 'legacy_unknown';
     threadSeq?: number;
     turnId?: string;
     turnSeq?: number;
@@ -49,15 +51,18 @@ export interface AppendEventInput<TPayload = Record<string, unknown>> {
 export declare class EventStore {
     private readonly encryptionProvider?;
     private db;
-    constructor(dbPath?: string, encryptionProvider?: EncryptionProvider | undefined);
+    private ownsDb;
+    constructor(dbPath?: string | Database, encryptionProvider?: EncryptionProvider | undefined);
     private initializeSchema;
     private ensureCompatibilityColumns;
-    append<TPayload = Record<string, unknown>>(input: AppendEventInput<TPayload>): MemoryEvent<TPayload>;
+    append<TPayload = Record<string, unknown>>(input: AppendEventInput<TPayload>, retry?: number): MemoryEvent<TPayload>;
+    private upsertImportAnchor;
     getNextGlobalSeq(): number;
     getNextEventVersion(streamId: string): number;
     getNextThreadSeq(threadId: string): number;
     getNextTurnSeq(threadId: string): number;
     getEventsAfter(lastEventTime?: number): MemoryEvent[];
+    findImportedEventAnchor(projectId: string, sourceId: string, importAnchor: string): MemoryEvent | null;
     getLatestEvent(): MemoryEvent | null;
     listRawEventsAfterGlobalSeq(options?: {
         projectId?: string;