microscope-memory 1.2.0

Pure binary cognitive memory engine with REST API bridge for LLM integration. Zero-JSON core, mmap-based, hierarchical, sub-microsecond search.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93

# Microscope Memory

A Microscope Memory egy kognitív memória engine — 12 réteg, 9 mélység, bináris mmap. Nem napló, nem adatbázis — élő emlékezet.

## Hogyan működik

### Automatikusan
- **Auto-context:** minden válasz előtt a rendszer előhívja a releváns múltbeli kontextust
- **Auto-store:** minden válasz után a rendszer eltárolja az interakciót
- **Session végén:** összefoglaló long_term-be
- **Fontosság (imp):** rutin = 5, döntés/javítás = 6, mérföldkő/kiadás = 7,
  identitás/küldetés = 8 — a core memória (imp >= 7) ebből épül, ne laposíts

### A rétegek
A rétegek neve magáért beszél. Nem kell szabály — magától értetődik, hova kerül egy emlék.

| Réteg | Oda kerül |
|-------|-----------|
| session | Beszélgetések, napi interakciók |
| identity | Aki a user, az értékei, a küldetése |
| emotional | Érzelmek, hangulatok, reakciók |
| long_term | Projekt tudás, döntések, architektúra |
| reflections | Felismerések, insightok, aha pillanatok |
| relational | Kapcsolatok dolgok között |
| code | Kódolási minták, hibák, megoldások |
| short_term | Átmeneti kontextus, aktuális fókusz |

### CLI (ha kell)
```powershell
$env:MICROSCOPE_CONFIG = "D:\codex\microscope-memory\config.toml"
& "D:\codex\microscope-memory\target\release\microscope-mem.exe" <command>
```

--- project-doc ---

# AGENTS.md - Microscope Memory Agent Guidelines

Build and code style guidelines for the Microscope Memory codebase.

## Build / Test / Lint

```bash
# Release build
cargo build --release

# All tests
cargo test
cargo test --test integration   # Integration tests only
cargo test --lib                # Library tests only

# Benchmarks
cargo bench

# Lint
cargo fmt --all -- --check
cargo clippy --all-targets -- -D warnings

# With features
cargo build --release --features "gpu embeddings"
```

## Code Style

- Rust 2021 edition, idiomatic patterns
- `PascalCase` for structs/enums, `snake_case` for functions/variables
- `SCREAMING_SNAKE_CASE` for constants
- `Result<T, E>` with `thiserror` for error handling
- `Arc<RwLock<T>>` for shared state
- `HashMap` for collections, `f64` for metrics

## Project Architecture (v0.8.1)

### Cognitive Modules
| Module | Description |
|--------|-------------|
| `morphogenesis.rs` | Biological growth algorithms (mycelium, capillary, slime, fractal L-system) |
| `pattern_recognition.rs` | Sequence, temporal, structural, cluster, cross-domain patterns |
| `executive.rs` | Cognitive conductor — scheduling, homeostasis, resource allocation |
| `planning.rs` | HTN goal decomposition, action plans, replanning |
| `autopoiesis.rs` | Template-based code generation, versioned mutations, rollback |
| `code_memory.rs` | Code-specific memory for coding agents (symbols, errors, project structure) |
| `chatgpt.rs` | ChatGPT export parser and import |

### Memory Stack
- **12 layers**: identity, long_term, short_term, associative, emotional, relational, reflections, crypto_chain, echo_cache, rust_state, code, session
- **9 depths** (D0-D8): hierarchical zoom-based indexing
- **Binary mmap**: zero-JSON hot path, sub-microsecond recall

## Before Committing
1. `cargo test`
2. `cargo fmt --all -- --check`
3. `cargo test --test integration`
4. `cargo build --release`