docs: update canon vision docs — fix stale refs, mark shipped features

- CLEO-VISION: Fix Commander.js → citty, update domain count to 13,
  mark vector search as shipped (v2026.3.70), update brain state date,
  update MCP operation count, remove stale In Progress items
- CLEOOS-VISION: Bump version to 2026.3.72, fix core version ref to
  CalVer, add facade contracts (v2026.3.71) and session serialize/restore
  (v2026.3.72) to shipped inventory, update facade domain count to 13

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: kryptobaseddev

docs/concepts/CLEO-VISION.md

@@ -211,18 +211,18 @@ The `isLatest` flag will track which version of a fact is current, enabling temp
 | Tier | Technology | Status | Capability |
 |------|-----------|--------|------------|
 | **S** | `brain.db` + FTS5 | Shipped | Full-text keyword search across decisions, patterns, learnings, observations |
-| **M** | `brain.db` + SQLite-vec | In Progress (T5157) | Vector embeddings for semantic similarity search |
+| **M** | `brain.db` + local embeddings | Shipped (v2026.3.70) | Vector embeddings via all-MiniLM-L6-v2 (@xenova/transformers), hybrid search combining FTS5 + vector + graph weights |
 | **L** | `brain.db` + PageIndex + Graph | Planned (T5160) | Graph-based traversal and cross-reference discovery via NEXUS |
 
-> **Current state (2026-03-02)**: BRAIN memory is in `brain.db` (SQLite) with 5 tables, FTS5 search, 3-layer retrieval API, and 5,122 observations migrated from claude-mem. The JSONL file era is over.
+> **Current state (2026-03-24)**: BRAIN memory is in `brain.db` (SQLite) with 7 tables (5 core cognitive + brain_embeddings + brain_memory_links), FTS5 search, vector similarity via all-MiniLM-L6-v2, hybrid search (FTS5 + vector + graph weights), 3-layer retrieval API, session summarization, memory bridge automation, and embedding backfill. Shipped in v2026.3.70-72.
 
 ### Current State vs Target
 
 **Shipped**: `brain.db` (5 core cognitive tables: decisions, patterns, learnings, observations, memory_links), FTS5 full-text search, 3-layer retrieval (memory find / timeline / fetch), memory observe, 209 MCP operations (119 query + 90 mutate), 5,122 observations migrated from claude-mem, ADR cognitive search, session handoffs, contradiction detection, vectorless RAG, **Provider Adapter System** (discovery-based loading -- ADR-031), **Provider-Agnostic Memory Bridge** (3-layer: static seed + guided self-retrieval + MCP resource endpoints -- ADR-032), **ct-memory skill** (brain memory protocol with progressive disclosure), **MCP resource endpoints** (cleo://memory/recent, learnings, patterns, handoff), **token-efficiency routing table** (MCP vs CLI channel preference per operation), **RFC 9457 ProblemDetails** error responses, **unified error catalog** (single source of truth for all exit codes), **`@cleocode/core` standalone package** (all business logic independently installable, 3 consumer patterns: Facade/tree-shaking/custom store -- Epic T5701)
 
-**In Progress**: SQLite-vec integration (T5157), NEXUS MCP wiring (nexus-wirer), PageIndex graph tables (T5160)
+**In Progress**: PageIndex graph tables (T5160), NEXUS MCP wiring (nexus-wirer), knowledge graph relationships (updates/extends/derives)
 
-**Planned**: Vector embeddings pipeline (T5158-T5159), reasoning engine (T5162-T5163), memory consolidation (T5166), temporal decay (T5167), full claude-mem plugin retirement
+**Planned**: Reasoning engine (T5162-T5163), active memory circulation (Living BRAIN), full knowledge graph with temporal reasoning
 
 ---
 
@@ -533,8 +533,8 @@ This contract enables **reliable, repeatable AI-assisted development** regardles
 
 CLEO uses a shared-core architecture where both MCP and CLI are thin wrappers around `packages/core/src/`. The business logic in `packages/core/src/` is published as the standalone `@cleocode/core` npm package, making it independently consumable without the full `@cleocode/cleo` product:
 
-- **MCP (Primary)**: 2 tools (`query`, `mutate`), 209 operations across 10 domains -- the agent interface
-- **CLI (Backup)**: 86 commands via Commander.js -- the human interface
+- **MCP (Primary)**: 2 tools (`query`, `mutate`), 209+ operations across 13 domains -- the agent interface
+- **CLI (Backup)**: 100+ commands via citty -- the human interface
 - **`@cleocode/core` (Canonical)**: All business logic, published as a standalone package. Both MCP and CLI delegate here. Consumers can install it independently.
 - **Adapters (Optional)**: Tool-specific UX optimizations without changing core semantics
 

docs/concepts/CLEOOS-VISION.md

@@ -1,8 +1,8 @@
 # CleoOS: The Agentic Development Environment
 
-**Version**: 2026.3.65
+**Version**: 2026.3.72
 **Status**: VISION
-**Date**: 2026-03-22
+**Date**: 2026-03-24
 
 ---
 
@@ -223,15 +223,15 @@ Each layer depends only on the layers below it. The kernel never reaches up into
 
 The kernel is shipped and operational:
 
-- `@cleocode/core` v2.0.0 -- standalone business logic kernel with 45 domain modules
+- `@cleocode/core` v2026.3.72 -- standalone business logic kernel with 45 domain modules
 - `@cleocode/contracts` -- type-only interfaces (zero runtime deps)
 - `@cleocode/adapters` -- unified provider adapters (Claude Code, OpenCode, Cursor)
 - `@cleocode/cleo` -- full CLI + MCP product (221 operations across 10 dispatch domains)
 - BRAIN with brain.db, FTS5 search, 3-layer retrieval, observation system, and agent execution learning
 - LOOM with RCASD-IVTR+C pipeline, lifecycle gates, stage management, and pipeline stage binding (T056)
 - NEXUS with project registry, cross-project queries, and dependency graph (deferred to Phase 3 -- see Section 4.6)
 - LAFS with structured envelopes, MVI progressive disclosure, and RFC 9457 errors
-- Cleo facade class with 12 domain APIs (tasks, sessions, memory, orchestration, lifecycle, release, admin, sticky, nexus, sync, agents, intelligence) and three consumer patterns
+- Cleo facade class with 13 domain APIs (tasks, sessions, memory, orchestration, lifecycle, release, admin, sticky, nexus, sync, agents, intelligence) and three consumer patterns. All facade interfaces published in @cleocode/contracts (v2026.3.71+).
 - Config schema audited: ~113 live fields (T101, down from ~283 before vaporware removal)
 - Agent health monitoring, heartbeat protocol, crash detection, and capacity tracking (T038)
 - General-purpose retry utility with exponential backoff in `lib` namespace (T038)
@@ -245,6 +245,8 @@ The kernel is shipped and operational:
 - Bootstrap injection chain: legacy template sync, CAAMP sanitization, post-bootstrap health check (T124)
 - Migration resilience: journal reconciliation and `ensureRequiredColumns()` safety net (v2026.3.61)
 - Brain Memory Automation (T134 epic, v2026.3.70): `BrainConfig` typed section, local embedding via `@xenova/transformers` all-MiniLM-L6-v2, async embedding queue, lifecycle-driven bridge refresh with debounce, context-aware bridge generation, session summarization (dual-mode), auto-link observations to focused task, embedding backfill CLI (`cleo backfill --embeddings`), brain maintenance command (`cleo brain maintenance`), cross-provider transcript extraction via adapter hook, updated injection templates and CLEO-BRAIN-SPECIFICATION.md v2.0.0
+- Facade API Interfaces in Contracts (v2026.3.71): All 13 facade interfaces + 20 supporting types moved to `@cleocode/contracts`. CleoOS imports types from contracts, not core — clean dependency boundary.
+- Session Serialize/Restore (v2026.3.72): `sessions.serialize()` captures full session state snapshot (session, handoff, decisions, brain observations, active task context). `sessions.restore()` hydrates from snapshot with agent handoff tracking, scope conflict detection, and hook dispatch. Foundation for CleoOS Phase 3 agent session persistence.
 
 ### What Is Specified (Runtime, Conduit)