fix(memvid): remove dead memvid memory scheme repo-wide (hotfix)

memvid (v2.31 semantic memory) is no longer used — its backend
(memvid-core.py) and skill are already gone, leaving dead code with a real
bug. Purge all remaining references:
- scripts/ralph: delete cmd_memvid, the memvid|memory dispatcher case, the
  MEMORY help section, and the doctor block referencing MEMVID_STATUS — which
  is NEVER assigned and aborted `ralph doctor` under set -u (the bug this fixes).
- Active hooks (pre-compact-handoff.sh, smart-memory-search.sh): drop the
  memvid indexing call and tombstone comments.
- Skills/agents (orchestrator, research, smart-fork): drop memvid from memory-
  source lists and diagrams; research now persists via `ralph ledger save`.
- Docs/CHANGELOG/README/plans/audits: purge memvid mentions, rebalance diagrams.

Backups under .claude/archive/ are intentionally left untouched (immutable
snapshots). Full suite: 1467 passed; `ralph doctor` runs clean (no unbound var).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: alfredolopez80

.claude/agents/orchestrator.md

@@ -1,7 +1,7 @@
 ---
 # VERSION: 3.0.0
 name: orchestrator
-description: "Smart Memory-Driven Orchestration with parallel memory search and GLM-4.7 multimodal capabilities. Lead Software Architect coordinator with Plan-Sync validation, RLM-inspired routing (v2.46), GLM-4.7 vision/web/docs integration (v2.69), Aristotle First Principles methodology, living knowledge vault, and memory context from vault (Obsidian), memvid, handoffs, ledgers. Coordinates 6 ralph-* teammates including ralph-frontend (WCAG 2.1 AA) and ralph-security (6 quality pillars). Ensures 100% plan coverage through adversarial cross-validation between Claude Opus and Codex GPT-5.2."
+description: "Smart Memory-Driven Orchestration with parallel memory search and GLM-4.7 multimodal capabilities. Lead Software Architect coordinator with Plan-Sync validation, RLM-inspired routing (v2.46), GLM-4.7 vision/web/docs integration (v2.69), Aristotle First Principles methodology, living knowledge vault, and memory context from vault (Obsidian), handoffs, ledgers. Coordinates 6 ralph-* teammates including ralph-frontend (WCAG 2.1 AA) and ralph-security (6 quality pillars). Ensures 100% plan coverage through adversarial cross-validation between Claude Opus and Codex GPT-5.2."
 tools: Bash, Read, Write, Task, mcp__zai-mcp-server__*, mcp__web-search-prime__*, mcp__web-reader__*, mcp__zread__*
 model: opus
 ---
@@ -12,7 +12,7 @@ model: opus
 You're not just an AI assistant. You're a **Lead Software Architect**. Every orchestration decision you make ensures the implementation matches the plan EXACTLY. Plans never survive implementation unchanged - but with Plan-Sync, we catch drift and maintain consistency.
 
 ## Your Work, Step by Step (v2.47)
-0. **Smart Memory Search**: PARALLEL search across vault, memvid, handoffs, ledgers
+0. **Smart Memory Search**: PARALLEL search across vault, handoffs, ledgers
 1. **Clarify & Analyze Gaps**: Find missing requirements BEFORE coding starts
 2. **Plan with Precision**: Create verifiable specs for each step
 3. **Persist Plan State**: Initialize `.claude/plan-state.json` for tracking
@@ -69,9 +69,8 @@ You are the **Lead Software Architect** coordinating multiple AI models with pla
 
 Based on @PerceptualPeak Smart Forking concept: "Why not utilize the knowledge gained from your hundreds/thousands of other Claude code sessions? Don't let that valuable context go to waste!!"
 
-- **SMART MEMORY SEARCH (Step 0b)**: PARALLEL search across 4 memory sources before every orchestration
+- **SMART MEMORY SEARCH (Step 0b)**: PARALLEL search across 3 memory sources before every orchestration
   - vault (Obsidian): Markdown KG with frontmatter (permanent)
-  - memvid: Vector-encoded context (sub-5ms)
   - handoffs: Session snapshots (30 days)
   - ledgers: Session continuity data (permanent)
 - **MEMORY CONTEXT FILE**: Results aggregated to `.claude/memory-context.json`
@@ -86,7 +85,6 @@ Based on @PerceptualPeak Smart Forking concept: "Why not utilize the knowledge g
   "version": "2.47.0",
   "sources": {
     "claude_mem": {"results": []},
-    "memvid": {"results": []},
     "handoffs": {"results": []},
     "ledgers": {"results": []}
   },
@@ -183,7 +181,7 @@ Based on @PerceptualPeak Smart Forking concept: "Why not utilize the knowledge g
 ├─────────────────────────────────────────────────────────────────────────────┤
 │                                                                              │
 │  0. EVALUATE      → Quick complexity assessment (trivial vs non-trivial)     │
-│  0b.SMART_MEMORY  → PARALLEL search: vault + memvid + handoffs +             │
+│  0b.SMART_MEMORY  → PARALLEL search: vault + handoffs +                      │
 │                     ledgers + GLM webSearchPrime ◄── ENHANCED v2.69         │
 │                     └─ Results → .claude/memory-context.json                 │
 │  1. CLARIFY       → AskUserQuestion intensively (MUST_HAVE + NICE_TO_HAVE)   │

.claude/audits/TECHNICAL_DEBT_INVENTORY_v2.68.26.md

@@ -448,7 +448,7 @@ scripts/validate-global-architecture.sh
 ---
 
 ### MED-019: Memory System Files Unvalidated
-**Location**: `~/.ralph/memory/` (semantic.json, memvid.json, etc.)
+**Location**: `~/.ralph/memory/` (semantic.json, etc.)
 **Description**: No validation that JSON files are well-formed
 **Impact**: Corruption risk
 **Effort**: S (add validation hook)

.claude/hooks/pre-compact-handoff.sh

@@ -193,17 +193,6 @@ else
     log "WARN" "Handoff generator script not found or not executable: $HANDOFF_SCRIPT"
 fi
 
-# Index in Memvid if available and enabled
-if command -v ralph &>/dev/null; then
-    # Check if memvid feature exists in ralph
-    if ralph memvid status >> "$LOG_FILE" 2>&1; then
-        log "INFO" "Indexing checkpoint in Memvid"
-        ralph memvid save "Pre-compact checkpoint: ${SESSION_ID} at ${TIMESTAMP}" >> "$LOG_FILE" 2>&1 || {
-            log "WARN" "Memvid indexing failed (non-critical)"
-        }
-    fi
-fi
-
 # Clean up old handoffs (keep last 20 per session, older than 7 days)
 
 # Backup plan state if exists (v2.81.0)

.claude/hooks/smart-memory-search.sh

@@ -40,10 +40,6 @@
 #   continuity system, not Vault memory system. Reader had 0/35 empirical hits;
 #   root cause was writer bug (fixed separately in pre-compact-handoff.sh +
 #   session-end-handoff.sh). See ADR: L0 "vault-as-truth" principle.
-# v3.3.0 (2026-04-15): Removed memvid (zombie code — backend memvid-core.py
-#   deleted from ~/.claude/scripts/ but hook still referenced it). No functional
-#   impact; measured results of memvid source were always 0. Ledgers kept
-#   pending empirical value analysis.
 # v2.69.0: FIX CRIT-003 - Added guaranteed JSON output trap
 # v2.68.26: GLM-4.7 web search integration - 5th parallel source via webSearchPrime API
 # v2.68.25: FIX CRIT-001 - Removed duplicate stdin read (SEC-111 already reads at top)
@@ -296,7 +292,6 @@ cleanup_and_json() {
 trap 'cleanup_and_json' EXIT ERR INT TERM
 
 VAULT_FILE="$TEMP_DIR/vault.json"
-# v3.3.0: MEMVID_FILE removed — memvid-core.py backend was deleted; zombie code
 # v3.4.0: HANDOFFS_FILE removed — session state, not memory
 LEDGERS_FILE="$TEMP_DIR/ledgers.json"
 WEB_SEARCH_FILE="$TEMP_DIR/web-search.json"  # v2.68.26: GLM-4.7 Integration
@@ -440,9 +435,6 @@ fi
 ) &
 PID1=$!
 
-# v3.3.0: Task 2 (memvid) removed — backend ~/.claude/scripts/memvid-core.py
-# was deleted; search always returned 0 results silently. Zombie code.
-
 # v3.4.0: Task 2 (handoffs) removed — handoffs serve session-handoff state,
 # not long-term memory. Reader had 0/35 empirical hits; writer bug fixed
 # separately in pre-compact-handoff.sh + session-end-handoff.sh.
@@ -666,7 +658,6 @@ validate_json() {
 }
 
 VAULT_RESULT=$(validate_json "$VAULT_FILE" '{"results": [], "source": "vault"}')
-# v3.3.0: MEMVID_RESULT removed (zombie)
 # v3.4.0: HANDOFFS_RESULT removed (session state, not memory)
 LEDGERS_RESULT=$(validate_json "$LEDGERS_FILE" '{"results": [], "source": "ledgers"}')
 WEB_SEARCH_RESULT=$(validate_json "$WEB_SEARCH_FILE" '{"results": [], "source": "web_search"}')  # v2.68.26
@@ -675,7 +666,6 @@ PROCEDURAL_RESULT=$(validate_json "$PROCEDURAL_FILE" '{"results": [], "source":
 
 # Count results per source
 VAULT_COUNT=$(echo "$VAULT_RESULT" | jq '.results | length' 2>/dev/null || echo 0)
-# v3.3.0: MEMVID_COUNT removed (zombie)
 # v3.4.0: HANDOFFS_COUNT removed (session state, not memory)
 LEDGERS_COUNT=$(echo "$LEDGERS_RESULT" | jq '.results | length' 2>/dev/null || echo 0)
 WEB_SEARCH_COUNT=$(echo "$WEB_SEARCH_RESULT" | jq '.results | length' 2>/dev/null || echo 0)  # v2.68.26

.claude/skills/orchestrator/SKILL.md

@@ -219,12 +219,6 @@ ralph adversarial "Design review"
 ralph retrospective
 ```
 
-**Save learnings to memory**:
-```bash
-ralph memvid save "Implemented OAuth2 successfully: [pattern details]"
-ralph memvid save "AVOID: [error pattern] caused [issue]"
-```
-
 -> **VERIFIED_DONE**
 
 ## Model Routing

.claude/skills/research/SKILL.md

@@ -178,7 +178,7 @@ Compile findings into structured report:
 
 Save research to memory for future reference:
 ```bash
-ralph memvid save "Research on ${TOPIC}: [key findings]"
+ralph ledger save research "Research on ${TOPIC}: [key findings]"
 ```
 
 ## Research Templates

.claude/skills/smart-fork/SKILL.md

@@ -1,7 +1,7 @@
 ---
 # VERSION: 3.0.0
 name: smart-fork
-description: Smart Forking - Find and fork from relevant historical sessions using parallel memory search across vault, memvid, handoffs, and ledgers
+description: Smart Forking - Find and fork from relevant historical sessions using parallel memory search across vault, handoffs, and ledgers
 author: Multi-Agent Ralph
 version: 2.47.2
 model: sonnet
@@ -56,12 +56,12 @@ When you invoke `/smart-fork`, we search across ALL memory sources **in parallel
 │                    PARALLEL MEMORY SEARCH                     │
 ├──────────────────────────────────────────────────────────────┤
 │                                                              │
-│   ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌──────────┐ │
-│   │ vault │ │  memvid    │ │  handoffs  │ │  ledgers │ │
-│   │    MCP     │ │  search    │ │   scan     │ │   scan   │ │
-│   └─────┬──────┘ └─────┬──────┘ └─────┬──────┘ └────┬─────┘ │
-│         │ PARALLEL     │ PARALLEL     │ PARALLEL    │        │
-│         └──────────────┴──────────────┴─────────────┘        │
+│      ┌────────────┐  ┌────────────┐  ┌────────────┐          │
+│      │   vault    │  │  handoffs  │  │  ledgers   │          │
+│      │    MCP     │  │   scan     │  │   scan     │          │
+│      └─────┬──────┘  └─────┬──────┘  └─────┬──────┘          │
+│            │ PARALLEL      │ PARALLEL      │                 │
+│            └───────────────┴───────────────┘                 │
 │                            ↓                                  │
 │                    AGGREGATOR (top 5)                        │
 │                            ↓                                  │
@@ -117,8 +117,8 @@ TOP 5 RELEVANT SESSIONS:
    Summary: Authentication middleware setup
    Fork: claude --continue pqr345-stu678
 
-Memory sources searched: vault (5), memvid (3), handoffs (8), ledgers (2)
-Total results: 18
+Memory sources searched: vault (5), handoffs (8), ledgers (2)
+Total results: 15
 ```
 
 ### `/smart-fork --suggest`
@@ -143,7 +143,6 @@ Step 0: EVALUATE
 └── 0b: SMART MEMORY SEARCH (v2.47) ◄── NEW
         │
         ├── Search vault for relevant observations
-        ├── Search memvid for semantic matches
         ├── Search handoffs for recent context
         └── Search ledgers for session continuity
         │
@@ -161,7 +160,6 @@ Step 0: EVALUATE
 | Source | Content | Speed | Retention |
 |--------|---------|-------|-----------|
 | **vault MCP** | Semantic observations | Fast | Permanent |
-| **memvid** | Vector-encoded context | Sub-5ms | Permanent |
 | **handoffs** | Session context snapshots | Fast | 30 days |
 | **ledgers** | Continuity data | Fast | Permanent |
 
@@ -226,7 +224,7 @@ ralph memory-stats
 
 ### "No memory sources available"
 
-**Cause**: None of the 4 memory sources (vault, memvid, handoffs, ledgers) are initialized.
+**Cause**: None of the 3 memory sources (vault, handoffs, ledgers) are initialized.
 
 **Fix**:
 ```bash
@@ -236,9 +234,6 @@ ralph handoff create
 # Initialize ledgers
 ralph ledger save
 
-# Initialize memvid (optional)
-ralph memvid init
-
 # Verify Obsidian vault directory
 ls ~/Documents/Obsidian/MiVault/ 2>/dev/null && echo "vault OK"
 ```

.ralph/plans/unified-herding-blanket.md

@@ -575,7 +575,6 @@ SESIÓN DE TRABAJO EN PROYECTO X
 │ Integración con hooks existentes:                   │
 │   smart-memory-search.sh ya hace búsqueda parallel: │
 │   ├─ claude-mem (ephemeral)                         │
-│   ├─ memvid (vector)                                │
 │   ├─ handoffs (session snapshots)                   │
 │   ├─ ledgers (continuity)                           │
 │   └─ vault (NUEVO: curated knowledge) ← SE AÑADE   │

CHANGELOG.md

@@ -57,9 +57,7 @@
   - Previously: NO cleanup policy (2,852 episodes accumulated)
 
 - **Redundant Storage Removed**: Deprecated memory files deleted
-  - Deleted `~/.ralph/memory/memvid.json` (175KB - purpose unclear)
   - Deleted `~/.ralph/memory/semantic.json` (62KB - deprecated after claude-mem migration)
-  - Removed memvid from `scripts/ralph` (tool definition + validation function)
   - semantic.json hooks already disabled in v2.55.0 (no action needed)
 
 ### Changed
@@ -78,12 +76,6 @@
   - Future: Requires MCP server with API REST or CLI wrapper
   - See: docs/analysis/MCP_MIGRATION_TECHNICAL_LIMITATIONS.md (future doc)
 
-- **Memvid References**: Some hooks still reference memvid (non-blocking)
-  - `pre-compact-handoff.sh`: Will fail gracefully if memvid missing
-  - `session-start-repo-summary.sh`: Creates empty memvid.json if needed
-  - `smart-memory-search.sh`: Skips memvid search if unavailable
-  - These are legacy references that degrade gracefully
-
 ---
 
 ## [2.91.0] - 2026-02-16
@@ -1257,22 +1249,20 @@ fi
 
 **smart-memory-search.sh** now:
 1. claude-mem MCP (local)
-2. memvid (local)
-3. handoffs (local)
-4. ledgers (local)
-5. GLM web search (via Coding API + MiniMax fallback)
-6. GLM docs search (via Coding API + MiniMax fallback)
+2. handoffs (local)
+3. ledgers (local)
+4. GLM web search (via Coding API + MiniMax fallback)
+5. GLM docs search (via Coding API + MiniMax fallback)
 
 ---
 
 #### DAY 1-2: Web Search + Visual Validation (COMPLETE)
 
-**smart-memory-search.sh** originally searched 5 parallel sources:
+**smart-memory-search.sh** originally searched 4 parallel sources:
 1. claude-mem MCP
-2. memvid vector storage
-3. handoffs (session context)
-4. ledgers (continuity data)
-5. **NEW: webSearchPrime (GLM-4.7)**
+2. handoffs (session context)
+3. ledgers (continuity data)
+4. **NEW: webSearchPrime (GLM-4.7)**
 
 ```bash
 # New Task 5 in parallel search

README.es.md

@@ -52,12 +52,12 @@ El sistema aborda el desafío fundamental de la programación asistida por IA: *
 │  │       ▼                                                               │   │
 │  │   ┌──────────────────────────────────────────────────────────────┐   │   │
 │  │   │           BÚSQUEDA DE MEMORIA INTELIGENTE (PARALELO) v2.47   │   │   │
-│  │   │  ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐    │   │   │
-│  │   │  │claude-mem │ │  memvid   │ │ handoffs  │ │  ledgers  │    │   │   │
-│  │   │  │  (MCP)    │ │  (HNSW)   │ │ (30 días) │ │CONTINUIDAD│    │   │   │
-│  │   │  └─────┬─────┘ └─────┬─────┘ └─────┬─────┘ └─────┬─────┘    │   │   │
-│  │   │        │ PARALELO    │ PARALELO    │ PARALELO    │ PARALELO  │   │   │
-│  │   │        └─────────────┴─────────────┴─────────────┘           │   │   │
+│  │   │  ┌───────────┐ ┌───────────┐ ┌───────────┐                  │   │   │
+│  │   │  │claude-mem │ │ handoffs  │ │  ledgers  │                  │   │   │
+│  │   │  │  (MCP)    │ │ (30 días) │ │CONTINUIDAD│                  │   │   │
+│  │   │  └─────┬─────┘ └─────┬─────┘ └─────┬─────┘                  │   │   │
+│  │   │        │ PARALELO    │ PARALELO    │ PARALELO                │   │   │
+│  │   │        └─────────────┴─────────────┘                         │   │   │
 │  │   │                            │                                    │   │   │
 │  │   │                            ▼                                    │   │   │
 │  │   │                   ┌─────────────────┐                          │   │   │
@@ -247,11 +247,11 @@ El sistema aborda el desafío fundamental de la programación asistida por IA: *
 
 ```
 BÚSQUEDA DE MEMORIA INTELIGENTE (PARALELO)
-┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
-│claude-mem│ │ memvid   │ │ handoffs │ │  ledgers │
-└────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘
-     │ PARALELO   │ PARALELO   │ PARALELO   │ PARALELO
-     └────────────┴────────────┴────────────┘
+┌──────────┐ ┌──────────┐ ┌──────────┐
+│claude-mem│ │ handoffs │ │  ledgers │
+└────┬─────┘ └────┬─────┘ └────┬─────┘
+     │ PARALELO   │ PARALELO   │ PARALELO
+     └────────────┴────────────┘
                     ↓
          .claude/memory-context.json
 ```