v0.6

echo-memory.plugin.src/skills/echo-memory/references/vault-layout.md

@@ -11,8 +11,12 @@
 │   ├── captures/      ← quick captures (inbox.md), date-prefixed lines
 │   ├── imports/       ← raw imported material
 │   └── processing-log/
-├── journal/
+├── journal/          ← one append-only time-series stream; rollups are coarser journal entries, NOT a separate reviews/ tree
 │   ├── daily/         ← YYYY-MM-DD.md (has an "Agent Log" section)
+│   ├── weekly/        ← YYYY-Www.md (ISO week, opt-in rollup)
+│   ├── monthly/       ← YYYY-MM.md (monthly rollup)
+│   ├── quarterly/     ← YYYY-Qn.md (manual / on request)
+│   ├── annual/        ← YYYY.md (manual / on request)
 │   └── templates/
 ├── projects/         ← lifecycle: incubating → active → on-hold/archived
 │   ├── active/        ← current work (status: active)
@@ -29,7 +33,7 @@
 │   └── decision-template.md
 │   (decisions/by-project/ is retired and not created —
 │    mirror an ADR into a project's `## Key Decisions` heading instead)
-├── reviews/           ← weekly / monthly / quarterly / annual
+│  (reviews/ is retired — journal rollups live under journal/; vault-health audits under _agent/health/)
 └── _agent/
     ├── echo-vault.md  ← bootstrap marker: schema_version + bootstrap date (plugin-owned; the "is this vault set up?" probe)
     ├── context/       ← current-context.md and task bundles
@@ -38,12 +42,13 @@
     │   ├── episodic/  ← what happened, when
     │   └── semantic/  ← durable facts/patterns (operator-preferences.md)
     ├── sessions/      ← YYYY-MM-DD-HHMM-<slug>.md
+    ├── health/        ← YYYY-MM-vault-health.md (monthly self-maintenance audit; NOT a journal entry)
     ├── templates/     ← canonical note templates
     ├── skills/        ← active / archived
     └── heartbeat/     ← single-line pointers (e.g. last-session.md → most-recent session log path)
 ```
 
-**Heartbeat:** `_agent/heartbeat/last-session.md` is a one-line pointer file an agent MAY write at session end (`<session-log-path> @ <ISO-timestamp>`). Reading it at session start is cheaper than listing the sessions directory; use it as a hint, not a source of truth — fall back to the directory listing if it's missing or stale.
+**Heartbeat:** `_agent/heartbeat/last-session.md` is a one-line pointer (`<session-log-path> @ <ISO-timestamp>`) the **session-logging procedure writes (PUT, overwrite) at session end** and the **loading procedure reads first (Step 4)** as an O(1) shortcut to the latest session log. It is a hint, not a source of truth — fall back to the `sessions/` directory listing if it's missing or stale. Because it's PUT-overwritten, it never grows or duplicates.
 
 **Slug rules:** kebab-case, ASCII only, truncate to ~40 chars.