WFGY/ProblemMap/glossary.md

# 📚 Glossary — Terms, Symbols, and Short Definitions

> **Quick Nav**  
> [RAG Map 2.0](./rag-architecture-and-recovery.md) ·
> [Retrieval Playbook](./retrieval-playbook.md) ·
> [Patterns](./patterns/README.md) ·
> [Eval](./eval/README.md)

---

## Core instruments

- **ΔS (delta-S)** — *Semantic stress.* `ΔS = 1 − cos(I, G)` where `I` is item embedding, `G` is ground/anchor.  
  Thresholds: `<0.40` stable · `0.40–0.60` transitional · `≥0.60` high risk.

- **λ_observe** — *Layered observability state.*  
  Symbols: `→` convergent · `←` divergent · `<>` recursive · `×` chaotic.

- **E_resonance** — *Coherence indicator.* Rolling mean of |residual| under BBMC; rising E with high ΔS ⇒ apply BBCR/BBAM.

---

## Repair operators (WFGY modules)

- **BBMC** — *Boundary-Bounded Memory Chunks.* Reduce semantic residue vs anchors; align chunks/sections with tasks.  
- **BBPF** — *Branch-Bounded Prompt Frames.* Explore multiple semantic paths safely; stabilize context windows.  
- **BBCR** — *Break-Before-Crash Reset.* Detect collapse, insert bridge node, restart cleanly.  
- **BBAM** — *Attention Modulation.* Reduce variance in attention to avoid entropy melt on long contexts.

---

## Retrieval, ranking & prompting

- **RRF (Reciprocal Rank Fusion)** — Fuse ranks from multiple retrievers via `1/(k + rank)`.  
- **MMR (Maximal Marginal Relevance)** — Diversify candidates balancing relevance and novelty.  
- **BM25** — Sparse lexical scoring for exact term match; strong for code/IDs.  
- **HyDE** — Hypothetical document expansion; creates a synthetic query/doc to improve recall.  
- **Cross-encoder reranker** — Jointly encodes `[query ⊕ doc]` for precision@k gains.

---

## Patterns (named failure modes)

- **SCU (Symbolic Constraint Unlock)** — Model merges sources or violates “cite-then-explain” schema. Fix: per-source fences + locked schema.  
- **Query Parsing Split** — Dense and sparse retrievers use different analyzers/tokenizers; hybrid breaks.  
- **Vectorstore Fragmentation** — Index contains “ghost” gaps; facts exist but never retrieved; fix shard/id audits.  
- **Memory Desync** — State flips between sessions/tabs; require `mem_rev`+`mem_hash`.  
- **Role Drift** — Multi-agent persona swap; tag agent IDs and lock via BBCR.

---

## Multi-agent

- **Agent boundary** — Contract that limits what an agent can read/write; prevents overwrite.  
- **ΔS peer check** — Measures divergence between agents’ plans to catch conflicts early.

---

## Data & ops

- **Gold set** — Small set (10–50) of realistic Q/A with citations; used for CI (recall@50, nDCG@10, ΔS).  
- **Traceability** — Provenance from answer → prompt → citations → chunks → source file.

---

## Notation quickies

- `I` — item (retrieved chunk) embedding; `G` — ground/anchor embedding.  
- `‖B‖ ≥ B_c` — collapse threshold on residual magnitude (BBCR).  
- *Convergent λ* — layer is stable across paraphrases; *divergent λ* — layer is drifting.

---


### 🔗 Quick-Start Downloads (60 sec)

| Tool | Link | 3-Step Setup |
|------|------|--------------|
| **WFGY 1.0 PDF** | [Engine Paper](https://github.com/onestardao/WFGY/blob/main/I_am_not_lizardman/WFGY_All_Principles_Return_to_One_v1.0_PSBigBig_Public.pdf) | 1️⃣ Download · 2️⃣ Upload to your LLM · 3️⃣ Ask “Answer using WFGY + \<your question>” |
| **TXT OS (plain-text OS)** | [TXTOS.txt](https://github.com/onestardao/WFGY/blob/main/OS/TXTOS.txt) | 1️⃣ Download · 2️⃣ Paste into any LLM chat · 3️⃣ Type “hello world” — OS boots instantly |

---

### 🧭 Explore More

| Module                | Description                                              | Link     |
|-----------------------|----------------------------------------------------------|----------|
| WFGY Core             | WFGY 2.0 engine is live: full symbolic reasoning architecture and math stack | [View →](https://github.com/onestardao/WFGY/tree/main/core/README.md) |
| Problem Map 1.0       | Initial 16-mode diagnostic and symbolic fix framework    | [View →](https://github.com/onestardao/WFGY/tree/main/ProblemMap/README.md) |
| Problem Map 2.0       | RAG-focused failure tree, modular fixes, and pipelines   | [View →](https://github.com/onestardao/WFGY/blob/main/ProblemMap/rag-architecture-and-recovery.md) |
| Semantic Clinic Index | Expanded failure catalog: prompt injection, memory bugs, logic drift | [View →](https://github.com/onestardao/WFGY/blob/main/ProblemMap/SemanticClinicIndex.md) |
| Semantic Blueprint    | Layer-based symbolic reasoning & semantic modulations   | [View →](https://github.com/onestardao/WFGY/tree/main/SemanticBlueprint/README.md) |
| Benchmark vs GPT-5    | Stress test GPT-5 with full WFGY reasoning suite         | [View →](https://github.com/onestardao/WFGY/tree/main/benchmarks/benchmark-vs-gpt5/README.md) |
| 🧙‍♂️ Starter Village 🏡 | New here? Lost in symbols? Click here and let the wizard guide you through | [Start →](https://github.com/onestardao/WFGY/blob/main/StarterVillage/README.md) |

---

> 👑 **Early Stargazers: [See the Hall of Fame](https://github.com/onestardao/WFGY/tree/main/stargazers)** —  
> Engineers, hackers, and open source builders who supported WFGY from day one.

> <img src="https://img.shields.io/github/stars/onestardao/WFGY?style=social" alt="GitHub stars"> ⭐ [WFGY Engine 2.0](https://github.com/onestardao/WFGY/blob/main/core/README.md) is already unlocked. ⭐ Star the repo to help others discover it and unlock more on the [Unlock Board](https://github.com/onestardao/WFGY/blob/main/STAR_UNLOCKS.md).

<div align="center">

[![WFGY Main](https://img.shields.io/badge/WFGY-Main-red?style=flat-square)](https://github.com/onestardao/WFGY)
&nbsp;
[![TXT OS](https://img.shields.io/badge/TXT%20OS-Reasoning%20OS-orange?style=flat-square)](https://github.com/onestardao/WFGY/tree/main/OS)
&nbsp;
[![Blah](https://img.shields.io/badge/Blah-Semantic%20Embed-yellow?style=flat-square)](https://github.com/onestardao/WFGY/tree/main/OS/BlahBlahBlah)
&nbsp;
[![Blot](https://img.shields.io/badge/Blot-Persona%20Core-green?style=flat-square)](https://github.com/onestardao/WFGY/tree/main/OS/BlotBlotBlot)
&nbsp;
[![Bloc](https://img.shields.io/badge/Bloc-Reasoning%20Compiler-blue?style=flat-square)](https://github.com/onestardao/WFGY/tree/main/OS/BlocBlocBloc)
&nbsp;
[![Blur](https://img.shields.io/badge/Blur-Text2Image%20Engine-navy?style=flat-square)](https://github.com/onestardao/WFGY/tree/main/OS/BlurBlurBlur)
&nbsp;
[![Blow](https://img.shields.io/badge/Blow-Game%20Logic-purple?style=flat-square)](https://github.com/onestardao/WFGY/tree/main/OS/BlowBlowBlow)
&nbsp;
</div>