refactor(memory,gui): Streamline memory archtiecture and terminology

- Short term memory/ recent events are collectively now Cognitive Buffer (Tier 1)

- Long term memory/ memory ledgers are just Memory Ledger (Tier 2)

- Dossiers stay Dossiers (Tier 3)

web/docs/src/content/docs/architecture/actor.md

@@ -7,7 +7,7 @@ The Actor Agent is the system component that embodies a single entity and produc
 
 ## Design Principles
 
-1. **Epistemic boundedness** — The actor only sees what its entity would perceive: public attributes of other entities, private attributes explicitly ACL'd to it, its own memory buffer, and co-located entities. It does not have system-level access to all world state.
+1. **Epistemic boundedness** — The actor only sees what its entity would perceive: public attributes of other entities, private attributes explicitly ACL'd to it, its own Cognitive Buffer, and co-located entities. It does not have system-level access to all world state.
 
 2. **Proposal, not mutation** — The actor generates a _proposal_ (narrative prose). It never mutates world state, persists to the database, or writes to memory directly. Validation, execution, and persistence are the Architect's job.
 
@@ -38,7 +38,7 @@ Epistemically bounded, with these sections:
 | ---------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------- |
 | Current moment               | The subjective present time                                                                        | `worldState.clock.get().toISOString()` |
 | The world as you perceive it | Self-visible attributes, co-located entities + their visible attributes, other presences elsewhere | `serializeSubjectiveWorldState()`      |
-| Your recent memory           | Recent `BufferEntry`s, alias-substituted, with relative time phrasing                              | `serializeSubjectiveBufferEntry()`     |
+| Your cognitive buffer        | Recent `BufferEntry`s, alias-substituted, with relative time phrasing                              | `serializeSubjectiveBufferEntry()`     |
 
 No system UUIDs, no private attributes the entity lacks ACL access to, and no objective-world-state dump are present.
 

web/docs/src/content/docs/architecture/handoff.md

@@ -1,15 +1,15 @@
 ---
 title: Memory Handoff Pipeline
-description: The Tier 1 (Working Buffer) to Tier 2 (Long-Term Ledger) memory promotion architecture
+description: The Cognitive Buffer to Memory Ledger promotion architecture
 sidebar:
   order: 6
 ---
 
 :::tip[Status: Fully Implemented]
-The handoff pipeline is fully integrated into the simulation step loop. The `HandoffEngine` and `checkHandoffTrigger` components process working memory entries, promoting them to the persistent episodic Ledger, while safely pruning the subjective working memory buffer.
+The handoff pipeline is fully integrated into the simulation step loop. The `HandoffEngine` and `checkHandoffTrigger` components process Cognitive Buffer entries, promoting them to the persistent Memory Ledger, while safely pruning the Cognitive Buffer.
 :::
 
-The **Handoff** pipeline manages the promotion of subjective experiences from the short-term working memory (Tier 1 Buffer) to long-term episodic memory (Tier 2 Ledger). This process regulates context window utilization by deciding **when** promotion occurs, **how much** of the buffer is processed, and **what** details are preserved or pruned.
+The **Handoff** pipeline manages the promotion of subjective experiences from the **Cognitive Buffer** to the **Memory Ledger**. This process regulates context window utilization by deciding **when** promotion occurs, **how much** of the Cognitive Buffer is processed, and **what** details are preserved or pruned.
 
 To maintain performance and prevent context bloat, the pipeline separates the process into three decoupled stages:
 
@@ -46,7 +46,7 @@ Voluntary triggers identify natural narrative boundaries where the entity is ina
 
 Involuntary triggers enforce context constraints before building the next prompt to prevent token limit overflows:
 
-- **Buffer Ceiling**: The serialized length of the working memory section (as generated by `getMemorySectionLength`) exceeds a configured fraction (default: 60%) of the provider's context window.
+- **Buffer Ceiling**: The serialized length of the Cognitive Buffer section (as generated by `getMemorySectionLength`) exceeds a configured fraction (default: 60%) of the provider's context window.
 - **Event Velocity**: The number of buffer entries exceeds a safe threshold (default: 20), indicating an event-heavy scene generating history faster than voluntary boundaries occur.
 
 If the buffer is empty, trigger detection exits immediately with `"none"`.
@@ -55,13 +55,13 @@ If the buffer is empty, trigger detection exits immediately with `"none"`.
 
 ## 2. Watermark Partitioning
 
-To preserve short-term narrative continuity and avoid immediate memory decay, recent events are protected from handoff. The pipeline divides the active buffer into a protected **Watermark Tail** and a **Candidate Pool**.
+To preserve narrative continuity and avoid immediate memory decay, recent events are protected from handoff. The pipeline divides the active Cognitive Buffer into a protected **Watermark Tail** and a **Candidate Pool**.
 
 The watermark boundary is computed as:
 
 $$\text{Watermark} = \max(K \text{ entries}, \text{entries bucketed as fresh by } \textit{naturalizeTime})$$
 
-- **Hard Floor ($K = 8$)**: The last 8 entries in the buffer are always preserved.
+- **Hard Floor ($K = 8$)**: The last 8 entries in the Cognitive Buffer are always preserved.
 - **Temporal Freshness**: Any entries that `naturalizeTime` classifies within the immediate temporal horizon (`"just now"`, `"moments ago"`, `"a few minutes ago"`, or `"several minutes ago"`) are also protected.
 
 Entries older than the watermark boundary constitute the **Candidate Pool** and are eligible for handoff processing.
@@ -100,8 +100,8 @@ The prompt instructs the model to apply the following cognitive operations:
 
 When a chunk represents an unresolved high-stakes situation (e.g., an active conflict or standing threat), the LLM sets `retainInBuffer: true`.
 
-- The summary is committed to the long-term Ledger as normal.
-- The source buffer entries are exempted from pruning, remaining in the working memory buffer with `pinned: true` until a future handoff pass determines the thread is resolved.
+- The summary is committed to the Memory Ledger as normal.
+- The source Cognitive Buffer entries are exempted from pruning, remaining in the Cognitive Buffer with `pinned: true` until a future handoff pass determines the thread is resolved.
 
 ---
 

web/docs/src/content/docs/architecture/memory-tier2.md

@@ -1,15 +1,15 @@
 ---
-title: Tier 2 Memory (Long-Term Ledger)
+title: Memory Ledger
 description: Persistent episodic memory storage, semantic indexing, and retrieval mechanics
 ---
 
-**Tier 2 Memory (the Ledger)** represents an entity's long-term episodic memory. It archives historical summaries of past events, providing a persistent record of character experiences that can be retrieved and injected into LLM prompts as needed.
+**Memory Ledger** represents an entity's persistent episodic memory. It archives historical summaries of past events, providing a durable record of character experiences that can be retrieved and injected into LLM prompts as needed.
 
 ---
 
 ## 1. Data Model
 
-A long-term memory is represented by a `LedgerEntry`. It includes metadata for deterministic database-level filtering, structured narrative content, and vector embeddings for semantic similarity scoring.
+A Memory Ledger entry is represented by a `LedgerEntry`. It includes metadata for deterministic database-level filtering, structured narrative content, and vector embeddings for semantic similarity scoring.
 
 ```ts
 interface LedgerEntry {
@@ -30,7 +30,7 @@ interface LedgerEntry {
 
 ## 2. Storage Model
 
-To support fast, low-latency queries across large historical datasets, Tier 2 memory is stored in standard SQLite tables. Vector embeddings are stored in raw binary format as `Float32Array` BLOBs.
+To support fast, low-latency queries across large historical datasets, Memory Ledger entries are stored in standard SQLite tables. Vector embeddings are stored in raw binary format as `Float32Array` BLOBs.
 
 Standard secondary indices optimize query execution time to microseconds, eliminating the compilation and cross-platform installation overhead of native vector database extensions (such as `sqlite-vec` or `node-gyp` binaries).
 
@@ -64,7 +64,7 @@ CREATE INDEX IF NOT EXISTS idx_ledger_involved_entity ON ledger_involved_entitie
 
 ## 3. The Handoff Pipeline
 
-Working memory (Tier 1 Buffer) entries are promoted to the Ledger through the automated [Handoff Pipeline](./handoff).
+**Cognitive Buffer** entries are promoted to the Memory Ledger through the automated [Handoff Pipeline](./handoff).
 
 During handoff:
 
@@ -72,7 +72,7 @@ During handoff:
 2. Ambient stage business and redundant details are pruned.
 3. Chunks are synthesized into third-person summaries and assigned importance scores.
 4. Text embeddings are generated for the summary.
-5. The processed memories are committed to the SQLite store, and the short-term buffer is pruned.
+5. The processed memories are committed to the SQLite store, and the Cognitive Buffer is pruned.
 
 ---
 
@@ -116,13 +116,13 @@ Once the candidate pool is loaded, the ranking engine evaluates entries in appli
 
 ## 5. Active Focus & Attention Loop
 
-In crowded settings (e.g., a room with many characters), retrieving long-term memories for all co-located entities would exhaust the prompt context window. To prevent this, retrieval uses an **Active Focus** selection strategy:
+In crowded settings (e.g., a room with many characters), retrieving Memory Ledger entries for all co-located entities would exhaust the prompt context window. To prevent this, retrieval uses an **Active Focus** selection strategy:
 
-- **Active Focus Set**: The prompt builder scans the last 10 entries of the character's working memory buffer. Any entity targeted by, spoken to, or mentioned in these entries is added to the Active Focus set.
+- **Active Focus Set**: The prompt builder scans the last 10 entries of the character's Cognitive Buffer. Any entity targeted by, spoken to, or mentioned in these entries is added to the Active Focus set.
 - **Dynamic Capacity Limits**:
-  - If the number of co-located characters is small ($\le 3$), long-term memory is retrieved for all of them.
-  - If the environment is crowded ($> 3$), long-term retrieval is strictly restricted to the top 3 characters in the Active Focus set.
-- This creates a realistic attention loop: when a new character interacts with the actor, they enter the working buffer, triggering the retrieval of their long-term history on the subsequent turn.
+  - If the number of co-located characters is small ($\le 3$), Memory Ledger entries are retrieved for all of them.
+  - If the environment is crowded ($> 3$), Memory Ledger retrieval is strictly restricted to the top 3 characters in the Active Focus set.
+- This creates a realistic attention loop: when a new character interacts with the actor, they enter the Cognitive Buffer, triggering the retrieval of their Memory Ledger history on the subsequent turn.
 
 ---
 
@@ -130,15 +130,15 @@ In crowded settings (e.g., a room with many characters), retrieving long-term me
 
 Retrieved ledger entries are formatted into the prompt chronologically and mapped to subjective aliases. Internal metrics (e.g., importance numbers and raw system IDs) are omitted to preserve immersion.
 
-- Working memory entries are injected under `=== RECENT EVENTS ===` (narrated relative to the present moment).
-- Recalled ledger entries are injected under `=== YOUR MEMORIES ===` (presented as long-term recollections).
+- Cognitive Buffer entries are injected under `=== COGNITIVE BUFFER ===` (narrated relative to the present moment).
+- Recalled Memory Ledger entries are injected under `=== MEMORY LEDGER ===` (presented as episodic recollections).
 
 ```text
-=== RECENT EVENTS ===
+=== COGNITIVE BUFFER ===
 Moments ago
   - You spoke to Strider: "Hello there"
 
-=== YOUR MEMORIES ===
+=== MEMORY LEDGER ===
 A couple days ago
   - You met a hooded figure named Strider at The Prancing Pony.
     Quote: "I can avoid being seen, if I wish, but to disappear entirely, that is a rare gift."