Skip to content

V3.1.0

Choose a tag to compare

View all tags
@liuqin164 liuqin164 released this 19 Jun 14:39
· 12 commits to main since this release
3.1.0
856a03e
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Cogmem 3.1.0 — Temporal Memory v1

Cogmem 3.1.0 introduces the first Temporal Memory layer.

This release adds validity-window belief lookup and project/entity timelines for milestones, decisions, corrections, and belief versions. It builds directly on the 3.0.0 Belief Graph by making belief history queryable over time.

The core idea of this release is:

Beliefs are not timeless.
Project state changes.
Decisions evolve.
Corrections supersede earlier beliefs.
Cogmem should know which version was valid at a given time.

Highlights

  • Added TemporalMemoryService.
  • Added timeline entries for milestones, decisions, corrections, and belief versions.
  • Added historical belief lookup by canonical key and timestamp.
  • Added belief history lookup across validity windows.
  • Added bounded timeline queries by project, entity, canonical key, entry type, and time range.
  • Added schema migration 0018_temporal_memory.
  • Exported temporal memory APIs through the public and internal surfaces.
  • Integrated TemporalMemoryService into MemoryKernel.
  • Updated migration tests to migrate schema 14 databases through 0015, 0016, 0017, and 0018.
  • Added Temporal Memory v1 regression tests.

Temporal Memory Service

Cogmem now includes:

TemporalMemoryService

The service provides two main capabilities:

1. Timeline entries
2. Historical belief lookup

It is designed to answer questions such as:

What was the valid belief at this time?
How did this project decision change?
When was this correction recorded?
What milestones happened for this project?
What timeline entries exist for this entity?

Timeline Entries

Temporal Memory introduces timeline records for:

milestone
decision
correction
belief_version

A timeline entry may include:

entryId
projectId
entryType
canonicalKey
entityId
beliefId
title
summary
reason
occurredAt
evidenceEventIds
createdAt

This makes it possible to record project and entity history as ordered memory events rather than treating all memory as current-state facts.

Supported timeline queries

Timeline entries can be queried by:

projectId
canonicalKey
entityId
entryTypes
startTime
endTime
limit

Results are ordered by occurrence time and creation time, giving agents a stable way to inspect project and entity history.

Historical Belief Lookup

Temporal Memory can query the Belief Graph by validity window.

getBeliefAt()

This method returns the belief version that was valid at a specific timestamp.

It uses:

canonicalKey
projectId
validFrom
validTo
status

It excludes rejected and unresolved conflict beliefs from normal historical lookup.

This enables questions such as:

What did we believe about the recall route before Graph Recall was introduced?
What was the active project decision at this point in time?
Which belief version was valid before the correction?

getBeliefHistory()

This method returns the ordered history of a canonical belief key.

It allows Cogmem to inspect how a belief evolved from older versions to the current version.

Example:

v1: Vector recall is primary.
v2: Graph recall precedes vector fallback.

This is the first step toward full belief/project/decision/correction versioning.

Schema Migration 18

A new migration was added:

0018_temporal_memory

It creates:

memory_timeline_entries

and adds indexes for:

project timeline lookup
canonical key timeline lookup
entity timeline lookup

The migration chain now includes:

0015_memory_governance
0016_entity_governance
0017_belief_graph
0018_temporal_memory

Upgrading an older schema 14 database now applies all four migrations and sets the final schema version to:

18

Kernel Integration

MemoryKernel now initializes:

temporalMemoryService

This gives host integrations direct access to Temporal Memory through the kernel instance.

Temporal Memory is now part of the core memory stack:

Raw Ledger
→ Memory Binding
→ Entity Brain
→ Belief Graph
→ Temporal Memory
→ future Context Cortex

Public API Updates

Temporal Memory APIs are now exported through the public surface.

New exports include:

TemporalMemoryService
RecordTimelineEntryInput
TemporalBeliefRecord
TimelineEntryRecord
TimelineEntryType
TimelineListOptions

This allows external integrations to record and query temporal memory without importing internal implementation files.

Tests Added

New Temporal Memory v1 tests cover:

  • belief lookup at historical timestamps;
  • belief history ordering across corrections;
  • milestone timeline recording;
  • correction timeline recording;
  • timeline reason preservation;
  • evidenceEventIds preservation;
  • project-isolated timeline queries;
  • bounded time-window queries.

Migration CLI tests were also updated to verify that schema 14 databases plan and apply:

0015
0016
0017
0018

and reach schema version:

18

Current Scope

Cogmem 3.1.0 is the Temporal Memory foundation.

It does not yet implement the full Context Cortex layer. Memory activation, context budgeting, recall suppression, source-drilldown policy, and immediate/working/background context bands remain future 3.2 work.

It also does not yet make every timeline entry strictly evidence-governed. Timeline entries can store evidence anchors, but Temporal Memory v1 is primarily a timeline and historical lookup layer.

Assets 2
Loading